Gestionar documentos

Gestiona tu base de conocimientos desde el panel de la base de conocimientos, la CLI o la API. Para saber qué es una base de conocimientos y cómo la usan los agentes, consulta Base de conocimientos.

Añadir documentos

Puedes crear documentos a partir de archivos, páginas web o texto sin formato. Una vez creados, asígnalos a un agente para que su contenido esté disponible en las conversaciones.

Agente de usuario del rastreador

Las importaciones de URL y los trabajos de rastreo recuperan páginas con el agente de usuario ElevenlabsBot/1.0.

El rastreador también respeta robots.txt. Se omiten las páginas no permitidas para ElevenlabsBot o para todos los agentes de usuario, así que revisa tus reglas si falta una página que esperabas que se indexara. Para permitir explícitamente el rastreador:

User-agent: ElevenlabsBot
Allow: /

Añadir documentos existentes a un agente

Puedes reutilizar documentos entre agentes, por lo que el conocimiento compartido solo necesita mantenerse una vez.

1. Ve a la configuración del agente.
2. Busca la sección de base de conocimientos y haz clic en Añadir documento.
3. Selecciona un documento existente de tu base de conocimientos o sube uno nuevo.

Editar documentos

Puedes editar directamente el contenido de un documento en lugar de eliminarlo y volver a subirlo. Al editar un documento se regeneran automáticamente sus fragmentos de búsqueda de contenido y sus embeddings de RAG, por lo que la búsqueda y la recuperación del agente se mantienen sincronizadas.

• Documentos de texto y archivos: Edita el contenido en línea y guarda los cambios.
• Documentos de archivo: También puedes sustituir el archivo subyacente por una nueva versión.
• Documentos de URL: Edita el contenido cuando la sincronización automática esté desactivada. Cuando está activada, el ciclo de sincronización gestiona el documento y bloquea las ediciones manuales.

# Update a document's name or content
elevenlabs.conversational_ai.knowledge_base.documents.update(
    documentation_id="i2YYI6huwBmcgYydAXARmQJc3pmX",
    name="Unladen Swallow Facts",
    content="The airspeed velocity of an unladen swallow (European) is 24 miles per hour.",
)
# Replace the underlying file of a file document
elevenlabs.conversational_ai.knowledge_base.document.update_file(
documentation_id="i2YYI6huwBmcgYydAXARmQJc3pmX",
file=open("/path/to/unladen-swallow-facts-v2.txt", "rb"),
)

Mantener actualizado el contenido de las URL

Puedes actualizar los documentos creados a partir de una URL para volver a obtener el contenido más reciente de su fuente. Al actualizarse, el documento se reindexa para que los agentes con RAG usen el contenido actualizado.

elevenlabs.conversational_ai.knowledge_base.document.refresh(
    documentation_id="i2YYI6huwBmcgYydAXARmQJc3pmX",
)

En el panel, también puedes activar la sincronización automática para actualizar los documentos de URL según una programación, de modo que su contenido se mantenga al día sin actualizaciones manuales.

Organizar con carpetas

Las carpetas agrupan documentos relacionados para que sea más fácil gestionarlos y añadirlos en bloque. Crea una carpeta y, después, mueve documentos a ella desde el panel o la API.

Una carpeta asignada a un agente pone todos sus documentos a disposición mediante RAG, por lo que el agente debe tener RAG activado para usar carpetas.

# Create a folder
folder = elevenlabs.conversational_ai.knowledge_base.documents.create_folder(
    name="Product documentation",
)
# Move a document into the folder
elevenlabs.conversational_ai.knowledge_base.documents.move(
document_id="i2YYI6huwBmcgYydAXARmQJc3pmX",
move_to=folder.id,
)

Dependencias y eliminación

Cada documento tiene una pestaña Agentes dependientes que muestra los agentes que dependen actualmente de él.

No puedes eliminar un documento mientras un agente dependa de él. Primero elimina el documento de esos agentes o usa la eliminación forzada para desvincularlo de todos los dependientes de una vez.