Ir para conteúdo
be-human.ai
← Voltar ao blog

Contexto e memória

Glossário da empresa para agentes de IA: termos que o agente deve usar

Um glossário controlado de termos de produto, trabalho e status mantém agentes de IA usando as mesmas palavras. Veja como montar, carregar e revisar.

Capa tipográfica do Be Human com o título: Glossário da empresa para agentes de IA: termos que o agente deve usar
Ilustração conceitual criada com IA · Be Human

Um glossário da empresa para agentes de IA é uma lista curta e com dono, com os termos de produto, trabalho e status que o seu negócio usa, e com um rótulo preferido e uma definição simples para cada um. Quando o agente lê essa lista antes de escrever, ele continua nomeando as mesmas coisas do mesmo jeito por semanas e meses, em vez de derivar para sinônimos que quebram relatórios, roteamento e respostas aos clientes. Este artigo explica quais termos incluir, como escrever entradas que um agente consiga seguir e como manter o glossário sob revisão.

Principais pontos

  • A deriva de linguagem é um problema de memória: o agente repete os rótulos que mais aparecem no seu contexto recente, então anotações inconsistentes geram linguagem inconsistente.
  • Limite o glossário aos termos que orientam decisões, roteamento, mudanças de status ou respostas visíveis ao cliente.
  • Cada entrada precisa de um rótulo preferido, uma definição simples, uma lista de sinônimos proibidos e um dono nomeado.
  • Carregue o glossário como memória revisada que o agente lê primeiro, e altere-o apenas por meio de uma etapa de aprovação registrada.
  • Teste a redação com uma periodicidade definida, para que a deriva apareça como uma verificação reprovada, e não como um cliente confuso.

Por que os agentes derivam na escrita

A deriva raramente parece um erro. Uma única resposta que chama um orçamento pendente de "aguardando aprovação" é um português razoável, e ninguém a marca. O problema começa quando essa formulação é copiada para um resumo, o resumo vira memória e uma resposta posterior volta a usar a nova expressão. Depois de alguns ciclos, o agente usa três rótulos para um mesmo status, e a ferramenta que espera o valor exato rejeita a atualização ou a registra na categoria errada.

As causas são comuns. A equipe usa palavras diferentes em cada canal. Documentos antigos trazem nomes de produtos desatualizados. Os resumos reformulam tudo o que comprimem. Um modelo não tem como saber, por conta própria, que em sua empresa uma visita técnica e uma vistoria são dois trabalhos diferentes, com pessoas e documentos diferentes. Ele conhece apenas o que está na sua frente. O glossário oferece uma referência fixa, para que o significado não dependa da anotação que por acaso foi recuperada por último.

Quais termos entram no glossário

Comece por três famílias. Os termos de produto são os nomes do que você vende, como clientes e equipe realmente os falam, além dos nomes que você quer usar por escrito. Os termos de trabalho nomeiam as unidades de serviço: triagem, orçamento, aditivo, turno, entrega, processo, agendamento. Os termos de status nomeiam os estados em que um trabalho ou pedido pode estar e as passagens entre eles. Uma quarta lista, pequena, reúne os sinônimos proibidos, as palavras que já causaram problemas antes.

Não tente definir todo o vocabulário da empresa. Um primeiro glossário útil costuma ter algumas dezenas de entradas, escolhidas porque aparecem em ferramentas, notas fiscais, agendas ou mensagens enviadas aos clientes. Inclua um termo quando pelo menos uma destas situações for verdadeira: ele muda um status, decide quem atende um pedido, aparece em um documento ou mensagem que o cliente vai ler, ou duas pessoas da equipe já discordam sobre o que ele significa. Deixe de fora palavras genéricas que não têm peso operacional.

Como escrever uma entrada que o agente consiga seguir

Uma entrada que funciona para uma pessoa muitas vezes falha para um agente, porque as pessoas preenchem lacunas com experiência, e os agentes preenchem lacunas com palpites. Cada entrada deve trazer o rótulo preferido exatamente como deve ser escrito, uma definição de uma ou duas frases, o que o termo não é, a lista de valores permitidos se for um status, o nome do dono que decide as mudanças, e um exemplo de uso correto e outro incorreto.

Cenário ilustrativo: uma pequena empresa de limpeza usa "cliente recorrente" na ferramenta de agendamento, "fixo" no site e "cliente de contrato" nas notas fiscais. Um agente que lê os três começa a escrever "clientes fixos de contrato" nos resumos. A solução é uma entrada que define "cliente recorrente" como único rótulo interno, o descreve como um cliente com serviço agendado em intervalo definido, afirma que um agendamento avulso não torna ninguém cliente recorrente e proíbe "fixo" e "cliente de contrato" em novas anotações. O texto do site pode manter a sua própria linguagem, mas os registros internos do agente não.

Escreva as definições na linguagem da empresa, não na linguagem de manual. Se a equipe de campo chama o serviço de "chamado" e o escritório chama de "processo", registre os dois e decida qual o agente usa em cada contexto, em vez de deixar que ele escolha a cada vez.

Uma entrada de glossário é uma decisão, escrita para que possa ser conferida.

Um plano passo a passo para montar o primeiro glossário

Monte a primeira versão em uma sessão de trabalho focada, com as pessoas que respondem pela operação, e depois refine-a com resultados reais. A sequência abaixo mantém o trabalho pequeno o bastante para ser concluído.

  • Reúna os termos candidatos nos lugares onde os rótulos já existem: campos de status na ferramenta de trabalhos ou no CRM, descrições de notas fiscais, títulos da agenda e uma amostra de mensagens recentes de clientes.
  • Agrupe os candidatos em termos de produto, trabalho e status, e marque aqueles de que um sistema ou um cliente depende.
  • Para cada conceito, escolha um rótulo preferido e designe um dono com autoridade para alterá-lo.
  • Escreva a definição, a linha do "não é", os valores permitidos para cada status e os sinônimos proibidos.
  • Confira cada valor de status com os valores exatos que o seu software aceita, para que o glossário e a ferramenta nunca divirjam.
  • Carregue o glossário aprovado na memória do agente como um registro versionado e revisado, e cite a versão em cada entrada do registro de mudanças.
  • Rode um pequeno conjunto de pedidos de teste e leia as saídas em busca de palavras proibidas e status inválidos antes que o agente grave qualquer coisa em registros compartilhados.
  • Defina uma revisão periódica, com uma pessoa nomeada, que inclua os termos que apareceram em disputas e retire os que ninguém mais usa.

Mantenha a primeira versão curta. Poucas entradas precisas são mais úteis do que muitas entradas vagas, porque o agente lê a lista inteira em cada tarefa, e uma lista carregada convida erros justamente nos pontos que mais importam.

Como fazer o glossário valer na leitura e na escrita

O glossário só funciona se estiver presente quando o agente lê e quando escreve. No lado da leitura, mantenha-o curto o bastante para ficar no topo de todo contexto de tarefa e carregue apenas as entradas relevantes para o trabalho atual, seguindo a mesma disciplina que você usaria para qualquer orçamento de contexto, como descrito no guia de orçamento de contexto para agentes de IA. No lado da escrita, resumos e atualizações de status devem usar os rótulos preferidos, e uma verificação simples pode sinalizar sinônimos proibidos antes que uma anotação seja salva como memória. Inclua essas verificações na rotina descrita no guia de auditoria de memória de agente de IA, para que as violações do glossário sejam apanhadas junto com os demais problemas de memória.

As mudanças precisam de um caminho definido. Quem pode editar uma entrada e quem pode aprovar um novo valor de status deve ser definido por função, e não por quem por acaso tem acesso. A orientação de autorização da OWASP enfatiza a verificação de permissões a cada acesso, em vez de presumi-las, o que se aplica diretamente à memória que controla a linguagem do trabalho voltado ao cliente. Cada mudança deve registrar o que foi alterado, quem aprovou e quais versões de agente foram afetadas. Quando duas memórias divergem sobre um termo, vale o glossário aprovado, e o conflito fica registrado para revisão, como explicado no guia sobre memórias conflitantes em agentes de IA.

A abordagem gerenciada da Be Human trata isso como parte da operação. O glossário é desenhado com o dono do negócio durante a primeira etapa do trabalho, carregado como memória revisada, com um dono nomeado e um registro de mudanças, e verificado nas avaliações periódicas e nas revisões de permissões. As mudanças de termos passam pela mesma fronteira de aprovação que as demais mudanças de memória, para que o agente não reescreva sozinho o vocabulário da empresa.

Detectar a deriva antes dos clientes

A deriva é mais fácil de pegar com um conjunto fixo de casos de teste. Prepare uma pequena coleção de pedidos realistas: um cliente perguntando se um serviço é recorrente, um integrante da equipe pedindo para mover um trabalho para o próximo status, um agente pedido para resumir uma ligação telefônica. Para cada um, escreva os rótulos esperados e as palavras proibidas. Rode o conjunto após cada mudança no glossário, após atualizações de modelo e em uma periodicidade definida. Trate uma verificação reprovada como um incidente com dono, e não como uma curiosidade.

O guia de avaliações da OpenAI descreve o padrão geral de criar verificações repetíveis para as saídas dos modelos, e esse padrão se encaixa bem na redação. Comece com verificações de correspondência exata para os valores de status, que são objetivas, e acrescente uma rubrica revisada para tom ou clareza apenas quando uma pessoa puder julgar de forma consistente. Mantenha o conjunto de teste separado dos exemplos usados para moldar o agente, para que uma nota de aprovação signifique que o agente generaliza, e não que decorou.

Com o tempo, os registros de falhas de redação mostram quais termos são de fato confusos. Um termo que falha repetidamente normalmente precisa de uma definição mais clara ou de um escopo mais estreito, e não apenas de mais uma proibição. Leve essas conclusões de volta à revisão do glossário, e o vocabulário se torna mais preciso, e não apenas mais longo.

Faça o diagnóstico gratuito de IA da Be Human para identificar a primeira tarefa que vale entregar a um agente e para ver se um glossário deve fazer parte desse primeiro passo.

Perguntas frequentes

O que é um glossário da empresa para agentes de IA? É uma lista curta e revisada dos termos de produto, trabalho e status do seu negócio, cada um com um rótulo preferido, uma definição simples e uma lista de sinônimos proibidos. Ele fica guardado como memória que o agente lê antes de trabalhar, para que o mesmo conceito seja nomeado do mesmo jeito em anotações, respostas e atualizações do sistema. Uma pessoa nomeada é a dona do glossário, e as mudanças passam por uma etapa de aprovação.

Quantos termos um primeiro glossário deve ter? Comece pelos termos que mudam um status, direcionam um trabalho ou aparecem em documentos ou mensagens que os clientes leem, o que normalmente resulta em uma lista curta. Algumas dezenas de entradas precisas são mais úteis do que centenas de entradas vagas, porque o agente lê a lista inteira em cada tarefa. Acrescente termos quando disputas ou falhas repetidas de redação mostrarem que um termo precisa de definição.

O glossário substitui a recuperação de documentos da empresa? Não. Os dois têm funções diferentes. O glossário fixa o significado das palavras, enquanto os documentos da empresa guardam as políticas detalhadas e os fatos que o agente recupera para cada caso. Quando um termo tem uma regra formal por trás, a entrada do glossário deve apontar para o documento aprovado que define essa regra.

Com que frequência o glossário deve ser revisado? Revise-o em uma periodicidade fixa, sob responsabilidade de uma pessoa nomeada, e também depois de qualquer mudança nos valores de status do seu software, de uma nova linha de serviço ou de uma atualização de modelo que altere a forma como o agente escreve. Falhas nas verificações de redação devem antecipar a revisão. Cada mudança deve ser registrada com a sua versão, para que saídas antigas possam ser rastreadas até o vocabulário que estava em vigor.

Seu próximo passo

Descubra primeiro onde um agente de IA cabe na sua empresa.

Faça o diagnóstico gratuito de IA da Be Human. Algumas perguntas sobre o seu trabalho mostram qual tarefa entregar primeiro a um agente, o que ele precisa saber e onde uma pessoa aprova.

Orientação editorial Be Human. Exemplos são ilustrativos, salvo atribuição explícita. Fontes oferecem contexto; a implementação depende do seu processo.

Menos tarefas. Mais espaço para você.

Traga o trabalho para o qual falta tempo.

Agende uma conversa e teste 7 dias grátis um agente de IA personalizado ↗Ou faça o diagnóstico gratuito de IA →