Actions8
Adicionar Documentos
AI-generatedOverview
This node manages knowledge bases and their documents for ElevenLabs conversational agents. It allows users to create, retrieve, update, delete knowledge bases, and manage documents within those bases by adding, listing, or removing them.
The "Adicionar Documentos" (Add Documents) operation specifically enables adding a document to an existing knowledge base by providing the document's URL and type. This is useful for enriching a knowledge base with new content from web pages or files accessible via URLs.
Practical examples:
- Adding a company policy document hosted on a web page to a customer support knowledge base.
- Uploading a PDF file URL containing product manuals into a technical knowledge base.
- Organizing documents under namespaces or assigning custom names for better management.
Properties
| Name | Meaning |
|---|---|
| ID da Base de Conhecimento | The unique identifier of the knowledge base where the document will be added. |
| URL do Documento | The URL of the document to add to the knowledge base. |
| Tipo do Documento | The type of document being added. Options: "URL da Web" (web_url), "URL do Arquivo" (file_url). |
| Nome Personalizado do Documento (optional) | A custom name to assign to the document within the knowledge base. |
| Espaço de Nomes (optional) | Namespace to organize the document within the knowledge base. |
Output
The node outputs JSON data representing the response from the ElevenLabs API after attempting to add the document. This typically includes details about the newly added document such as its ID, name, URL, type, namespace, and status.
No binary data output is produced by this operation.
Dependencies
- Requires an active API key credential for ElevenLabs API authentication.
- Relies on the ElevenLabs conversational knowledge base REST API endpoints.
- The node uses helper functions to build request options and handle API requests.
Troubleshooting
Common issues:
- Invalid or missing knowledge base ID: Ensure the knowledge base exists and the ID is correct.
- Incorrect document URL or inaccessible resource: Verify the URL is reachable and publicly accessible.
- Insufficient permissions or invalid API key: Confirm the API key has rights to modify the knowledge base.
Error messages:
- API errors returned from ElevenLabs will be propagated; typical messages include "Not Found" for invalid IDs or "Unauthorized" for authentication failures.
- Network or timeout errors may occur if the API endpoint is unreachable.
Resolutions:
- Double-check all input parameters for correctness.
- Validate API credentials in n8n settings.
- Test document URLs independently to confirm accessibility.
Links and References
- ElevenLabs Knowledge Base API documentation (refer to official ElevenLabs developer resources)
- n8n documentation on creating and using custom nodes and credentials