ElevenLabs Agents icon

ElevenLabs Agents

Use agentes de conversação da ElevenLabs

Actions7

Excluir Agente

AI-generated

Overview

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

Typical use cases include automating customer support, building interactive chatbots, or integrating voice-enabled AI assistants into workflows. For example, a user can create a new agent configured with a specific voice and system instructions, start a session with that agent, and send messages to simulate a conversation.

The "Excluir Agente" (Delete Agent) operation specifically deletes an existing agent by its ID, which is useful for cleaning up unused or obsolete agents in your ElevenLabs environment.

Properties

Name Meaning
ID do Agente The unique identifier of the agent to delete. Required for the delete operation.
Opções Avançadas Advanced options collection including:
- Conhecimentos Comma-separated IDs of knowledge bases associated with the agent (used in other operations).
- Forçar Resposta de Áudio Boolean flag to always generate audio responses even if not normally generated (used elsewhere).
- Limite de Pesquisa Maximum number of search results when querying knowledge bases (used elsewhere).
- Idioma Language code for the session, e.g., "pt-BR" or "en-US" (used in session start operation).

Note: For the "Excluir Agente" operation, only the "ID do Agente" property is required and used.

Output

The output JSON structure after deleting an agent contains at least:

{
  "success": true,
  "message": "Agente excluído com sucesso"
}
  • success: A boolean indicating whether the deletion was successful.
  • message: A confirmation message about the deletion.

No binary data is produced by this operation.

Dependencies

  • Requires an API key credential for ElevenLabs API authentication.
  • Uses HTTP requests to ElevenLabs endpoints under the path conversational/agents/{agentId} with the DELETE method.
  • No additional environment variables are explicitly required beyond the API key credential.

Troubleshooting

  • Common Issues:

    • Invalid or missing agent ID will cause the deletion to fail.
    • Network or authentication errors may prevent communication with the ElevenLabs API.

  • Error Messages:

    • If the agent ID does not exist, the API might return a 404 error indicating the agent was not found.
    • Authentication failures will result in 401 or 403 errors; ensure the API key credential is correctly configured.

  • Resolution:

    • Verify the agent ID is correct and exists.
    • Check API key validity and permissions.
    • Ensure network connectivity to the ElevenLabs API endpoint.

Links and References

Discussion