Agente de suporte com base própria
Publicar um agente que responde dúvidas a partir da documentação interna da empresa.
É o caso de uso mais comum da plataforma: um Agente que responde dúvidas recorrentes de política de despesas, processo de férias ou catálogo de produtos, a partir dos documentos que a empresa já tem.
Este guia vai além do primeiro agente: trata do que faz a diferença entre um agente que demonstra bem e um que aguenta uso real.
Pré-requisitos
- Papel de Proprietário, Curador ou Editor no workspace.
- Ao menos um modelo habilitado em Configurações › Modelos.
- Os documentos que sustentam as respostas, em formato com texto selecionável.
Recortar as coleções
Separe por assunto, não por origem
Uma Coleção por tema, como "Políticas de RH" ou "Catálogo de produtos", funciona melhor que uma Coleção única com tudo.
O recorte por assunto deixa a busca mais precisa e permite tirar um conjunto de circulação sem afetar o resto.
Descarte o que está desatualizado
Documentos contraditórios são o modo mais comum de um Agente dar respostas erradas com aparência de certas. Duas versões da mesma política, ambas indexadas, e o Agente cita a antiga.
Antes de subir, confirme qual é a versão vigente de cada documento.
Espere a indexação
Confira em Coleções › Arquivos que todos os documentos chegaram ao estado Ativo. Documentos em processamento não participam das respostas, e não há aviso disso na tela do Agente.
Escrever o prompt
O texto padrão do formulário cobre tom e formato. Para um agente de suporte, acrescente três coisas:
- O papel e o público: quem ele atende e sobre o que responde.
- A ordem de prioridade: responder a partir dos documentos recuperados, não do conhecimento geral do modelo.
- O comportamento na lacuna: dizer que não encontrou, e indicar a quem recorrer.
A terceira é a que mais economiza retrabalho. Sem ela, o modelo completa a lacuna com o que aprendeu no treino, e a resposta sai plausível, sem referências e errada.
Testar antes de publicar
Teste com perguntas reais, não com as que você escreveria. Três categorias que revelam problemas:
- Perguntas ambíguas, que podem se referir a dois documentos.
- Perguntas fora de escopo, para conferir se ele recusa em vez de inventar.
- Perguntas cuja resposta mudou recentemente, para checar se a versão certa está indexada.
Em cada resposta, abra o bloco de Referências e confira se o trecho citado sustenta o que foi dito.
Publicar e acompanhar
Marque Publicar ao salvar. O Agente passa a aparecer no seletor do Chat para o workspace.
Nas primeiras semanas, duas telas respondem se ele está servindo:
- Registros › Conversas mostra o que as pessoas de fato perguntam, que raramente é o que se imaginou.
- Registros › Avaliação das Respostas concentra os casos que deram errado.
A leitura dessas duas costuma render a segunda versão do prompt e uma lista de documentos que faltavam.
Próximos passos
- Ajuste o texto de instruções em Escrever o prompt.
- Limite o custo do agente em Quotas.