Sua primeira recuperação
Adicione um documento, conecte um agente e verifique as passagens exatas citadas e a pontuação de suporte que ele retorna.
Adicione uma fonte que você pode verificar
Comece com um documento curto cujo conteúdo você conhece. Você precisará de acesso ao seu workspace do Takibi e de um agente ou terminal que possa executar o Node.js 20 ou mais recente.
- Abra Documentos e escolha Nova coleção. Dê um nome que descreva o cliente ou o trabalho.
- Crie uma pasta com Nova pasta e escolha Enviar arquivos.
- Selecione seu arquivo, verifique seu destino e escolha Enviar. Aguarde Indexado.
- Abra o documento e verifique se o texto convertido inclui as informações sobre as quais você deseja perguntar.
Se o arquivo estiver retido ou falhar, use Arquivos retidos ou com falha antes de continuar. Agentes não podem recuperar conteúdo retido.
Crie um Perfil para o agente
Um Perfil define o que um agente pode ler e fazer. Uma chave permite que uma ferramenta use esse Perfil. Todas as chaves em um Perfil compartilham seu acesso.
- Abra Perfis → Novo perfil. Nomeie-o de acordo com sua função, como Suporte.
- Revise seu orçamento diário de tokens e limite de perguntas. Deixe Criar tarefas, Orquestrador e os interruptores de notas desativados para uma ferramenta que só precisa recuperar conhecimento e trabalhar em suas próprias tarefas.
- Na etapa de escopo, selecione a pasta que você acabou de criar.
- Termine de criar o Perfil e copie a chave do seu cartão de colagem. O segredo é mostrado uma única vez.
Armazene a chave localmente, fora do controle de versão. Veja Acesso & chaves antes de conceder uma coleção inteira.
Conecte e pergunte
Siga Conectar um agente para instalar o CLI e salvar a chave. Em seguida, faça uma pergunta específica que o documento responde:
takibi ask -q "What is our refund policy?" --jsonSe o Perfil puder acessar várias coleções, passe --project <project-uuid>. Use uma pergunta relevante para sua fonte; a pergunta sobre reembolso é apenas um exemplo.
Verifique o resultado em relação ao documento
Uma recuperação bem-sucedida retorna passagens exatas da fonte, além de citações que identificam seus documentos e trechos. No JSON, essas passagens são chamadas de spans. Abra o documento citado e compare a passagem com o contexto original.
O Takibi não escreve uma resposta em seu nome. Seu agente pode usar essas passagens para responder. Se a resposta disser que se absteve (abstained: true), nenhuma passagem foi retornada; verifique o status do documento, o acesso do Perfil e a redação da pergunta.
Leia como interpretar evidências para pontuações de suporte, evidências parciais e sinais de conflito.
Escolha seu próximo passo
Depois de verificar sua primeira recuperação, escolha um destes próximos passos: