Eleven Labs Conversational icon

Eleven Labs Conversational

Interact with ElevenLabs Conversational AI API

Actions26

Knowledge Base → Get Dependent Agents

AI-generated

Overview

The "Get Dependent Agents" operation of the Knowledge Base resource retrieves a list of agents that depend on or are linked to a specific knowledge base document. This is useful in scenarios where you want to understand which conversational agents rely on particular knowledge base content, for example, to assess impact before updating or deleting a document.

Practical examples:

  • Before modifying a knowledge base document, check which agents use it to avoid breaking their functionality.
  • Audit dependencies between knowledge base documents and agents to maintain consistency.
  • Generate reports showing agent-document relationships for management or debugging purposes.

Properties

Name Meaning
Document ID The unique identifier of the knowledge base document whose dependent agents you want to retrieve.
Return All Boolean flag indicating whether to return all dependent agents or limit the number of results.
Limit Maximum number of dependent agents to return if "Return All" is false (range: 1-100).

Output

The output JSON contains an array of dependent agents related to the specified knowledge base document. Each item typically includes details about an agent that depends on the document. The exact structure depends on the API response but generally includes agent identifiers and metadata relevant to their dependency.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the ElevenLabs Conversational AI API.
  • An API authentication token (API key credential) must be configured in n8n credentials for ElevenLabs.
  • Network access to ElevenLabs services is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing Document ID: The node requires a valid document identifier; ensure it is correctly provided.
    • API authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.
    • Rate limiting or network errors from the ElevenLabs API may cause failures; retry or check service status.

  • Error messages:

    • "Document ID is required": Ensure the Document ID property is filled.
    • "Authentication failed": Check your API key credential configuration.
    • "Request limit exceeded": You may need to wait or upgrade your API plan.

Resolving these usually involves verifying input parameters, credentials, and network connectivity.

Links and References

Discussion