ElevenLabs Knowledge Base icon

ElevenLabs Knowledge Base

Gerencie bases de conhecimento para os agentes da ElevenLabs

Actions8

Listar Documentos

AI-generated

Overview

This node manages knowledge bases and their documents for ElevenLabs conversational agents. It allows users to create, retrieve, update, delete knowledge bases, and add, list, or remove documents within those bases.

A common use case is maintaining a structured repository of information (knowledge base) that an AI agent can query to provide informed responses. For example, a customer support bot could use this node to keep its knowledge base updated with product manuals or FAQs by adding or removing documents dynamically.

Specifically, the "Listar Documentos" operation lists all documents contained in a specified knowledge base, enabling users to view what content is currently available for their conversational agents.

Properties

Name Meaning
ID da Base de Conhecimento The unique identifier of the knowledge base from which to list documents.
Opções Avançadas Collection of optional advanced settings:
- Nome Personalizado do Documento Custom name to assign to a document when adding it to the knowledge base (not used in listing).
- Espaço de Nomes Namespace to organize documents within the knowledge base (not used in listing).

Note: For the "Listar Documentos" operation, only the "ID da Base de Conhecimento" property is required and relevant.

Output

The output JSON contains the list of documents retrieved from the specified knowledge base. Each document's details are included as returned by the ElevenLabs API, typically including identifiers, names, URLs, namespaces, and other metadata related to each document.

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 under the path conversational/knowledge-bases/{knowledgeBaseId}/documents.
  • Relies on helper functions for request creation and error handling provided by bundled utilities.

Troubleshooting

  • Common Issues:

    • Invalid or missing knowledge base ID will cause the API request to fail.
    • Network connectivity problems may prevent successful API calls.
    • Insufficient permissions or invalid API credentials will result in authorization errors.

  • Error Messages:

    • Errors from the API are caught and handled; typical messages include "Not Found" if the knowledge base does not exist or "Unauthorized" if credentials are invalid.
    • If no documents exist, the response might be an empty list rather than an error.

  • Resolutions:

    • Verify the knowledge base ID is correct and exists.
    • Ensure the API key credential is properly configured and has necessary permissions.
    • Check network connectivity and retry if transient issues occur.

Links and References

  • ElevenLabs API Documentation (general reference for knowledge base and document management)
  • n8n Documentation on creating custom nodes and using HTTP Request helpers

Discussion