ElevenLabs Agents icon

ElevenLabs Agents

Use agentes de conversação da ElevenLabs

Actions7

Atualizar Agente

AI-generated

Overview

This node integrates with ElevenLabs conversational agents, allowing users to manage and interact with AI-driven agents. It supports operations such as 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 configuring agents with specific voices and behavior instructions. For example, a user can create an agent with a custom system instruction and voice ID, then start a session and send messages to simulate a conversation.

The "Atualizar Agente" (Update Agent) operation specifically updates an existing agent's details like name, voice, system instructions, and advanced options such as knowledge bases and language settings.

Properties

Name Meaning
Nome do Agente The name of the agent.
ID da Voz The voice ID that the agent will use for speech synthesis.
Instruções do Sistema Instructions describing how the agent should behave.
ID do Agente The unique identifier of the agent to update.
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).

Output

The node outputs JSON data representing the result of the performed operation. For the "Atualizar Agente" operation, the output JSON contains the updated agent's details as returned by the ElevenLabs API after a successful update request.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for ElevenLabs API authentication.
  • Uses HTTP requests to ElevenLabs endpoints related to conversational agents.
  • The node depends on utility functions (createBaseOptions, formatReturnData, handleApiError) presumably defined in an imported utilities module.

Troubleshooting

  • Common Issues:

    • Invalid or missing agent ID when updating an agent will cause errors.
    • Incorrect voice ID or system instructions may lead to unexpected agent behavior.
    • Network or authentication failures with the ElevenLabs API.

  • Error Messages:

    • API errors are caught and handled; error details are returned in the node output.
    • If the API returns an error (e.g., 404 for non-existent agent), the node will provide the error message.

  • Resolutions:

    • Verify that the agent ID exists before attempting to update.
    • Ensure the API key credential is correctly configured and has necessary permissions.
    • Validate input fields for correct formats and required values.

Links and References

Discussion