Actions21
Overview
The node enables interaction with the RetellAI API, specifically allowing users to create an "Agent" resource. Creating an agent involves configuring a conversational AI entity with specific voice and language model settings. This is useful for scenarios such as building custom virtual assistants, automated customer support agents, or interactive voice response systems.
For example, a user can create an agent that uses a particular large language model (LLM) identified by its unique ID and assign it a specific voice from the available voices in RetellAI's system. Additional configuration options allow fine-tuning of the agent’s behavior, such as adjusting speech speed.
Properties
| Name | Meaning |
|---|---|
| Response Engine | Configuration of the language model used by the agent. Options: - Retell LLM: Specify the unique ID of the Retell large language model (LLM) to use. |
| Voice ID | Unique identifier of the voice assigned to the agent. Voices can be selected from a list loaded dynamically from the service. Used to define how the agent sounds. |
| Agent Name | A user-defined name for the agent, helping to identify it within your projects or dashboard. |
| Additional Configuration | JSON object containing extra configuration parameters for the agent, using snake_case keys. For example, you can set "voice_speed" to control the speaking speed. See the RetellAI API documentation for all supported fields. |
Output
The node outputs JSON data representing the created agent's details as returned by the RetellAI API. This typically includes identifiers, configuration details, and status information about the newly created agent.
If the node supports binary data output, it is not indicated in the provided code or properties, so the output is primarily JSON-based.
Dependencies
- Requires an active connection to the RetellAI API.
- Needs an API authentication token configured in n8n credentials (referred generically as "an API key credential").
- The node dynamically loads available voices via a helper method, which requires network access to RetellAI services.
Troubleshooting
Common Issues:
- Invalid or missing API credentials will cause authentication failures.
- Providing an incorrect or non-existent LLM ID or Voice ID will result in errors from the API.
- Malformed JSON in the "Additional Configuration" property may cause request failures.
Error Messages:
- Authentication errors typically indicate invalid or missing API keys; verify credentials setup.
- Validation errors from the API may mention unknown voice IDs or LLM IDs; ensure these values are correct and exist in your RetellAI account.
- JSON parsing errors suggest issues in the additional configuration field; validate JSON syntax before submission.
Links and References
- RetellAI API Documentation - Create Agent
- RetellAI Dashboard for managing voices and LLMs (accessible via RetellAI platform)