ElevenLabs Agents icon

ElevenLabs Agents

Use agentes de conversação da ElevenLabs

Actions7

Listar Agentes

AI-generated

Overview

This node integrates with ElevenLabs conversational agents, allowing users to manage and interact with AI-driven chat agents. It supports operations such as listing all agents, creating new agents, retrieving details of a specific agent, updating or deleting agents, starting conversation sessions, and sending messages within those sessions.

Common scenarios include:

  • Automating customer support by creating and managing multiple conversational agents.
  • Integrating AI chat agents into workflows for interactive user engagement.
  • Starting sessions and sending messages programmatically to simulate conversations or gather information.

For example, you can list all your existing agents to display them in a dashboard, create a new agent with specific voice and behavior instructions, or send a message to an ongoing session to get a response from the agent.

Properties

Name Meaning
Opções Avançadas Collection of advanced options:
- Conhecimentos IDs of knowledge bases separated by commas (used to enhance agent responses).
- Forçar Resposta de Áudio Boolean flag 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", "en-US").

Note: The above advanced options are available for some operations like creating/updating agents, starting sessions, and sending messages.

Output

The node outputs JSON data corresponding to the result of the selected operation:

  • Listar Agentes: Returns a list of all conversational agents with their details.
  • Criar Agente / Atualizar Agente: Returns the created or updated agent's details.
  • Obter Agente: Returns detailed information about a specific agent.
  • Excluir Agente: Returns a success message confirming deletion.
  • Iniciar Sessão: Returns session details including session ID.
  • Enviar Mensagem: Returns the agent's response to the sent message, potentially including text and audio response metadata.

If audio responses are forced or generated, the output may include references to audio data, but binary data handling is not explicitly shown in this code.

Dependencies

  • Requires an API key credential for ElevenLabs API authentication.
  • Uses helper functions (createBaseOptions, formatReturnData, handleApiError) from a utility module to build requests and handle responses.
  • Network access to ElevenLabs conversational API endpoints.

Troubleshooting

  • API Authentication Errors: Ensure the API key credential is correctly configured and has necessary permissions.
  • Invalid Agent ID: When fetching, updating, or deleting an agent, verify that the provided agent ID exists.
  • Session Issues: Starting a session requires a valid agent ID; sending messages requires a valid session ID.
  • Malformed Advanced Options: Knowledge base IDs must be comma-separated strings; incorrect formatting may cause request failures.
  • Rate Limits or Network Errors: Handle possible API rate limits or connectivity issues gracefully; retry or check network status.

Common error messages will come from the ElevenLabs API and are handled by the node’s error handler, which attempts to provide meaningful feedback.

Links and References

Discussion