ElevenLabs Agents icon

ElevenLabs Agents

Use agentes de conversação da ElevenLabs

Actions7

Obter Agente

AI-generated

Overview

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

A common use case is automating customer support or interactive voice assistants by managing agents that respond based on predefined instructions and knowledge bases. For example, a user can create an agent with specific voice settings and system instructions, start a session in a particular language, and send messages to receive conversational responses, optionally forcing audio replies.

Properties

Name Meaning
ID do Agente The unique identifier of the agent to retrieve, update, delete, or start a session for.
Opções Avançadas Advanced options including:
- Conhecimentos: IDs of knowledge bases (comma-separated).
- Forçar Resposta de Áudio: Force audio response even if not normally generated.
- Limite de Pesquisa: Max number of search results from knowledge base.
- Idioma: Language code for the session (e.g., pt-BR, en-US).

Note: These properties are specifically relevant for the "Obter Agente" operation and others like update, delete, and start session where applicable.

Output

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

  • For Obter Agente (Get Agent), the output JSON contains detailed information about the specified agent, such as its name, voice ID, system instructions, and associated knowledge bases.
  • For other operations, the output varies accordingly, e.g., lists of agents, confirmation messages on deletion, session details, or message interaction results.
  • The node does not output binary data.

Dependencies

  • Requires an API key credential for ElevenLabs API authentication.
  • Uses HTTP requests to ElevenLabs endpoints under conversational/agents and related paths.
  • No additional environment variables are explicitly required beyond the API credential.

Troubleshooting

  • Common Issues:

    • Invalid or missing agent ID when fetching or modifying an agent will cause errors.
    • Incorrect API credentials or network issues may lead to request failures.
    • Providing malformed knowledge base IDs (not comma-separated) could cause unexpected behavior.

  • Error Messages:

    • API errors returned from ElevenLabs will be caught and formatted; typical messages include "Agent not found" or "Unauthorized".
    • To resolve, verify the agent ID exists, ensure valid API credentials, and check network connectivity.

Links and References

  • ElevenLabs Official Website
  • ElevenLabs API documentation (refer to conversational agents endpoints) — typically available via ElevenLabs developer portal.

Discussion