Gerenciar documentos

Gerencie sua base de conhecimento pelo painel da base de conhecimento, pela CLI ou pela API. Para saber o que é uma base de conhecimento e como os agentes a utilizam, consulte Base de conhecimento.

Adicionar documentos

Os documentos podem ser criados a partir de arquivos, páginas da web ou texto simples. Depois de criados, vincule-os a um agente para disponibilizar o conteúdo nas conversas.

Agente de usuário do rastreador

As importações de URL e os trabalhos de rastreamento buscam páginas com o agente de usuário ElevenlabsBot/1.0.

O rastreador também respeita o robots.txt. Páginas não permitidas para ElevenlabsBot ou para todos os agentes de usuário são ignoradas. Portanto, verifique suas regras se uma página que você espera que seja indexada estiver ausente. Para permitir explicitamente o rastreador:

User-agent: ElevenlabsBot
Allow: /

Adicionar documentos existentes a um agente

Os documentos podem ser reutilizados entre agentes, portanto, o conhecimento compartilhado só precisa ser mantido uma vez.

1. Acesse a configuração do agente.
2. Encontre a seção da base de conhecimento e clique em Adicionar documento.
3. Selecione um documento existente da sua base de conhecimento ou envie um novo.

Editar documentos

Você pode editar o conteúdo de um documento diretamente, em vez de excluí-lo e enviá-lo novamente. A edição de um documento regenera automaticamente seus blocos de pesquisa de conteúdo e embeddings de RAG, mantendo a pesquisa e a recuperação do agente sincronizadas.

• Documentos de texto e arquivo: edite o conteúdo diretamente e salve.
• Documentos de arquivo: como alternativa, substitua o arquivo original por uma nova versão.
• Documentos de URL: edite o conteúdo quando a sincronização automática estiver desativada. Quando ela estiver ativada, o ciclo de sincronização gerencia o documento e as edições manuais são bloqueadas.

# 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"),
)

Manter o conteúdo de URL atualizado

Documentos criados a partir de uma URL podem ser atualizados para buscar novamente o conteúdo mais recente da fonte. A atualização reindexa o documento para que agentes com RAG usem o conteúdo atualizado.

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

No painel, você também pode ativar a sincronização automática para atualizar documentos de URL automaticamente em uma programação, mantendo o conteúdo atualizado sem intervenções manuais.

Organizar com pastas

As pastas agrupam documentos relacionados para facilitar o gerenciamento e a vinculação em massa. Crie uma pasta e mova documentos para ela pelo painel ou pela API.

Uma pasta vinculada a um agente disponibiliza todos os seus documentos por meio de RAG. Portanto, o agente precisa ter RAG ativado para usar pastas.

# 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,
)

Dependências e exclusão

Cada documento tem uma aba Agentes dependentes que lista os agentes que dependem dele no momento.

Um documento não pode ser excluído enquanto um agente depender dele. Primeiro, remova o documento desses agentes ou use a exclusão forçada para desvinculá-lo de todos os dependentes de uma vez.