Base de conhecimento para agentes de voz: documentos e testes

Escolha informações que a equipe já confia

A base de conhecimento de um agente de voz deve conter informações aprovadas para a tarefa: horários, serviços, regras e respostas frequentes. Registre um responsável e uma data de revisão para cada fonte. Quando documentos discordam, resolva qual regra está vigente antes de disponibilizar o material ao agente.

Organize o conteúdo com títulos claros, parágrafos curtos e exemplos. Uma lista de serviços deve explicar o que cada serviço inclui; um nome interno, sozinho, pode não ser suficiente para responder à pessoa que liga.

Confirme o processamento e a seleção

No Tigy, carregue o documento na base de conhecimento e aguarde o processamento. Depois, selecione a fonte nas configurações de conhecimento do agente e salve. Um arquivo disponível no workspace não é automaticamente uma fonte de todos os agentes.

Conecte apenas os materiais relevantes para a tarefa. Um agente de recepção não precisa consultar toda a documentação de vendas para explicar como chegar à empresa.

Documento e consulta ao sistema têm papéis diferentes

Um documento pode explicar a política de entrega. Para saber onde está um pedido agora, o agente precisa consultar o sistema que acompanha aquela compra. Essa consulta depende de uma integração preparada, por exemplo uma ferramenta HTTP: uma conexão que permite pedir informações a outro sistema.

Se a fonte não tiver a informação, defina como o agente deve explicar esse limite e oferecer um próximo passo. Não preencha a lacuna com uma resposta apenas plausível.

Teste antes e depois de atualizar

Faça uma pergunta respondida diretamente pelo arquivo, outra que use uma seção diferente e uma que não esteja no material. Compare a fala com a fonte, incluindo números e exceções.

• O documento terminou de processar?
• O agente correto está usando a fonte atual?
• Existe algum material contraditório selecionado?
• Uma pergunta sem resposta recebe um encaminhamento claro?

Teste a resposta e a ausência de resposta

Imagine uma empresa com duas unidades e horários diferentes. O documento precisa relacionar unidade e horário sem deixar o agente juntar o endereço de uma com o funcionamento da outra. Teste uma pergunta direta, uma pergunta sem indicar unidade e uma comparação entre as duas.

Depois pergunte algo que não está no material, como disponibilidade de um profissional amanhã. O comportamento esperado é identificar a falta de informação e seguir o caminho permitido, não extrapolar o horário de funcionamento para uma agenda individual. A qualidade da base aparece também na maneira como o agente reconhece que ela não responde ao pedido.

Ao revisar uma falha, confira se o arquivo terminou de processar e se está selecionado no agente testado. Se a associação está correta, procure ambiguidade, versão antiga ou informação ausente no texto de origem. Acrescentar uma regra ao prompt pode ajudar na conversa, mas não substitui a correção de uma fonte contraditória.

Atualize com rastreabilidade

Uma mudança de horário deve começar no documento aprovado. Atualize a fonte, confira seu processamento, revise a seleção dos agentes e repita as perguntas afetadas. Evite manter duas versões contraditórias associadas ao mesmo atendimento. A versão antiga pode continuar disponível para arquivo interno, mas não deve disputar a resposta corrente.

Mantenha um registro simples de alteração: informação modificada, responsável, agentes atingidos e testes realizados. Quando o cliente receber uma resposta errada, esse histórico ajuda a localizar se o problema veio da aprovação, do processamento, da associação ou da interpretação.

Meça acerto por tipo de pergunta, não apenas uma média geral. Perguntas fáceis sobre endereço podem esconder erros em cancelamento ou condições de serviço. Inclua consultas com linguagem informal, documentos com regras específicas e solicitações sem resposta. A avaliação pode ser manual; não pressupõe que o Tigy ofereça automaticamente todos esses indicadores em um painel.

Perguntas sobre documentos e informações atuais

Posso colocar toda a documentação em um único arquivo? Você pode organizar o material dessa forma, mas uma divisão por tema facilita revisão e seleção. O critério principal é clareza: regras precisam carregar contexto suficiente para continuar compreensíveis quando consultadas como trechos.

Enviar o arquivo já ativa a fonte? Não. O documento precisa terminar o processamento e ser selecionado nas fontes do agente. Verifique ambos antes de investigar o modelo.

Devo guardar dados individuais na base? Políticas gerais e instruções aprovadas pertencem à base documental. Dados de uma conta ou pedido devem vir de uma consulta autorizada quando a tarefa exigir. Não transforme a base compartilhada em um arquivo de informações pessoais de clientes para evitar a necessidade de integração.

Faça um inventário de perguntas e fontes

Uma base de conhecimento começa com a informação que o atendimento precisa consultar, não com a quantidade de arquivos disponíveis. Liste perguntas recorrentes e associe cada uma à fonte aprovada. Horário de unidade, política de troca e condições de serviço podem estar espalhados entre páginas, manuais e mensagens internas. Essa associação revela tanto lacunas quanto conflitos antes de o agente começar a responder.

Para cada fonte, registre um responsável e o contexto de aplicação. Uma regra pode valer para uma unidade, um produto ou um contrato específico. Se essas condições não aparecem no documento, o agente pode aplicar uma informação correta ao caso errado. Inclua o escopo no próprio conteúdo de maneira legível, evitando depender de um nome de arquivo que o leitor não interpreta.

Separe informação pública, orientação interna de atendimento e dados individuais. Uma política geral explica o processo; não confirma o estado de uma compra particular. Arquivos compartilhados não devem substituir consultas autorizadas a sistemas atualizados. Esse limite também melhora manutenção: a política muda com menos frequência que os registros de cada cliente.

Considere uma loja fictícia com duas unidades. O manual diz que a retirada ocorre até dezoito horas, mas uma página antiga informa dezenove. Não envie os dois esperando que o modelo descubra qual é o correto. Confirme a regra com o responsável, corrija a fonte antiga ou retire-a do conjunto, e teste perguntas que mencionam os dois horários. A resposta deve corrigir a premissa ultrapassada.

Defina ainda quais perguntas não podem ser resolvidas pelos documentos. A lista de ausências esperadas ajuda a verificar se o agente admite o limite e oferece uma saída válida. Uma base confiável não precisa responder a tudo; precisa distinguir conteúdo disponível de conteúdo insuficiente.

Escreva conteúdo que preserve condições e exceções

Documentos feitos para apresentação comercial nem sempre servem bem ao atendimento. “Entrega rápida para todos” é uma promessa vaga. Uma política útil informa área atendida, condição de cálculo, exceções e onde consultar o prazo específico. Não é necessário escrever para o modelo com frases artificiais; é necessário deixar claro o que uma pessoa também precisaria saber para responder corretamente.

Use títulos que correspondam às dúvidas. Uma seção sobre cancelamento deve explicar quando ele é permitido, como solicitá-lo e quais confirmações dependem de sistema. Evite esconder uma exceção importante muito distante da regra geral. Se a regra exige um contexto, mantenha esse contexto perto da resposta. Isso reduz a chance de uma resposta incompleta parecer absoluta.

Revise tabelas e listas com atenção. Uma linha com preço pode depender de moeda, periodicidade e condição contratual. Se algum desses elementos fica apenas em nota isolada, a informação recuperada pode perder o significado. Escreva a unidade e a condição junto ao valor quando for possível. Para conteúdo que muda frequentemente, avalie se uma consulta de sistema é mais adequada que um documento estático.

Faça um exercício de explicação oral. Leia a informação para alguém que não conhece o processo e pergunte o que ela entendeu. Uma política correta, mas cheia de siglas e referências internas, pode gerar uma resposta difícil de ouvir. Acrescente definições e termos que clientes usam sem remover a precisão necessária. O agente pode explicar com linguagem simples, mas a fonte deve fornecer os limites.

Não coloque instruções de comportamento conflitantes nos documentos como se fossem fatos. A fonte pode explicar uma política; as instruções do agente definem como conversar e agir diante dela. Se um arquivo antigo manda confirmar toda solicitação, enquanto o prompt exige confirmação de sistema, o conflito pode dificultar o teste. Revise conteúdo que mistura orientações operacionais e informação factual.

No Tigy, confirme processamento do documento e associação às fontes do agente. O upload concluído não basta para provar que aquela conversa consulta o material. Use uma pergunta cuja resposta aparece apenas na fonte escolhida para verificar a configuração, e depois uma pergunta ausente para avaliar o limite.

Teste atualizações com perguntas antigas

Uma mudança de política exige mais do que adicionar o novo documento. Identifique a cópia anterior, revise a seleção de fontes e confirme quem responde pela atualização. Se o arquivo antigo continua disponível, a consulta pode encontrar respostas incompatíveis. Trate a remoção de conteúdo superado como parte da manutenção, com o cuidado necessário para preservar informação ainda válida.

Prepare uma pequena coleção de perguntas ligadas às fontes principais. Inclua a pergunta direta, uma versão informal e uma pergunta com premissa antiga. Depois da atualização, repita as três. A pergunta com premissa antiga é especialmente útil: ela mostra se o agente aceita a frase do cliente como fato ou corrige a informação pela fonte aprovada.

Quando uma resposta falha, examine se o conteúdo necessário existe, se foi recuperado e se foi explicado corretamente. Essas são etapas diferentes. Um documento ausente exige atualização de fonte. Informação disponível que não aparece na resposta pode exigir investigação de seleção ou recuperação. Uma explicação que distorce a condição exige revisão de instruções e novos exemplos de teste.

Acompanhe também perguntas sem resposta como demanda editorial. Agrupe por assunto e frequência, mas não transforme relatos individuais em política automaticamente. O responsável precisa aprovar a informação antes de incorporá-la. Essa disciplina mantém a base como referência confiável e permite ampliar cobertura sem confundir observações de atendimento com regras da empresa.