Actions8
Criar Base de Conhecimento
AI-generatedOverview
This node manages knowledge bases for ElevenLabs conversational agents. It allows users to create, retrieve, update, list, and delete knowledge bases, as well as add, list, and remove documents within those knowledge bases. This is useful for organizing and maintaining structured information that conversational AI agents can reference to provide accurate responses.
Practical examples include:
- Creating a new knowledge base to store FAQs or product documentation.
- Adding web URLs or file URLs as documents to enrich the knowledge base.
- Updating descriptions or names of existing knowledge bases.
- Removing outdated documents from a knowledge base.
- Listing all knowledge bases or documents to audit or manage content.
Properties
| Name | Meaning |
|---|---|
| Nome da Base de Conhecimento | The name of the knowledge base to create or update. |
| Descrição | A description of the knowledge base to create or update. |
| Opções Avançadas | Collection of advanced options when adding documents: |
| - Nome Personalizado do Documento | Custom name for the document being added to the knowledge base. |
| - Espaço de Nomes | Namespace to organize documents within the knowledge base. |
Note: These properties are shown only when the operation is "Criar Base de Conhecimento" (createKnowledgeBase) or "Atualizar Base de Conhecimento" (updateKnowledgeBase).
Output
The node outputs JSON data representing the response from the ElevenLabs API for each operation performed. The structure varies depending on the operation:
- For creation and update operations, it returns details of the created or updated knowledge base including its ID, name, and description.
- For listing operations, it returns arrays of knowledge bases or documents with their metadata.
- For deletion operations, it returns a success message confirming the removal.
- For adding documents, it returns confirmation and details about the added document.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for ElevenLabs API authentication.
- Uses HTTP requests to ElevenLabs endpoints under the path
conversational/knowledge-bases. - The node depends on helper functions (
createBaseOptions,formatReturnData,handleApiError) defined in an external utility module bundled with the node.
Troubleshooting
Common issues:
- Missing or invalid API credentials will cause authentication errors.
- Providing incorrect knowledge base IDs or document IDs will result in not found errors.
- Invalid URLs or unsupported document types when adding documents may cause request failures.
Error messages:
- Authentication errors typically indicate missing or wrong API keys; verify your credentials.
- "Not Found" errors mean the specified knowledge base or document does not exist; check IDs carefully.
- Validation errors may occur if required parameters like knowledge base name or document URL are empty; ensure all mandatory fields are filled.
To resolve errors, confirm all input parameters, ensure valid API credentials, and verify network connectivity to the ElevenLabs API.
Links and References
- ElevenLabs official API documentation (for knowledge base management):
(Link not provided in source code; please refer to ElevenLabs developer resources)