Custom Tools
Custom tools let you connect Myra to any external API. You define the tool's behavior using an HTTP request configuration, and the AI decides when to invoke it based on the conversation.
Configuration fields
| Field | Required | Description | Example |
|---|---|---|---|
Name | Required | A short, descriptive identifier used as the function name by the AI. snake_case is recommended. | check_availability |
Description | Required | Tells the AI what the tool does and when to call it. Be specific � the model uses this to decide when to invoke the tool. | Check available appointment slots for a given date |
Request URL | Required | The full HTTP or HTTPS endpoint to call when the tool is triggered. | https://api.zoyabeauty.com/availability |
HTTP Method | Required | The HTTP verb to use for the request. | GET � POST � PUT � PATCH � DELETE |
Authentication | Optional | Secures requests to your endpoint. Choose from None, Bearer Token, API Key, or Basic Auth. | Bearer Token |
Headers | Optional | Optional custom HTTP headers to include with every request. | Content-Type: application/json |
Parameters | Optional | Dynamic values the AI fills in at call time based on the conversation. Supported types: string, number, boolean, array, object. | date (string), guest_count (number) |
When to Call | Required | The lifecycle trigger for this tool. | beforeCall � onCall � afterCall |
Authentication methods
None
No authentication. The request is sent without any credentials.
Bearer Token
Sends an Authorization: Bearer <token> header with the request.
API Key
Sends a custom header or query parameter containing your API key.
Basic Auth
Sends a base64-encoded username:password in the Authorization header.
Supported parameter types
Parameters are dynamic values the AI fills in at call time based on the conversation context. Each parameter must have a name, type, and description.
Writing good descriptions
The tool description is the primary signal the AI uses to decide when to call the tool. Be specific about what it does and the conditions under which it should be invoked. Vague descriptions lead to missed or incorrect invocations.
Tool Assignment
Tools must be assigned to your agent before they can be used. Assigning tools replaces the existing tool list � include all desired tools in a single assignment.