ElevenLabs Agents icon

ElevenLabs Agents

Use agentes de conversação da ElevenLabs

Actions7

Overview

This node integrates with ElevenLabs conversational agents, allowing users to manage and interact with AI-driven chat agents. It supports creating, updating, retrieving, listing, and deleting agents, as well as starting conversation sessions and sending messages to agents.

A common use case is automating customer support or interactive voice assistants by programmatically managing agents and their conversations. For example, you can create a new agent with specific voice and behavior instructions, start a session for a user, and send messages to the agent to receive responses, optionally forcing audio replies.

Properties

Name Meaning
Nome do Agente The name of the conversational agent to create or update.
ID da Voz The voice ID that the agent will use for speech synthesis (e.g., "21m00Tcm4TlvDq8ikWAM").
Instruções do Sistema Instructions describing how the agent should behave during conversations.
Opções Avançadas Collection of advanced options:
- Conhecimentos Comma-separated IDs of knowledge bases to enhance the agent's responses.
- Forçar Resposta de Áudio Boolean to always generate an audio response even if it normally wouldn't be generated.
- Limite de Pesquisa Maximum number of results to search in the knowledge base.
- Idioma Language code for the session, e.g., "pt-BR" or "en-US".

Output

The node outputs JSON data representing the result of the selected operation:

  • For createAgent and updateAgent, the output contains the created or updated agent details including its ID, name, voice ID, system instructions, and optionally linked knowledge bases.
  • For listAgents, it returns a list of all agents with their metadata.
  • For getAgent, it returns detailed information about a specific agent.
  • For deleteAgent, it returns a success message confirming deletion.
  • For startSession, it outputs session details including the session ID.
  • For sendMessage, it returns the agent's response to the sent message, which may include text and optionally audio data if forced or available.

If audio responses are generated, they are included in the output as part of the JSON payload (binary data handling is not explicitly shown but implied by the option to force audio).

Dependencies

  • Requires an API key credential for ElevenLabs API access.
  • Uses HTTP requests to ElevenLabs endpoints under conversational/agents and related paths.
  • No additional external dependencies beyond the ElevenLabs API and n8n's HTTP request helper.

Troubleshooting

  • Invalid or missing API credentials: Ensure the API key credential is correctly configured in n8n.
  • Agent ID not found: When fetching, updating, or deleting an agent, verify the agent ID is correct.
  • Voice ID invalid: Use a valid voice ID recognized by ElevenLabs; otherwise, creation or update will fail.
  • Malformed knowledge base IDs: Provide comma-separated strings without extra spaces or invalid characters.
  • Network or API errors: Check network connectivity and ElevenLabs service status.
  • Error messages from API: The node surfaces API error messages; review them to adjust parameters accordingly.

Links and References

Discussion