Glossário da empresa para agentes de IA: ensine os termos internos
Como montar um glossário curto e com dono para agentes de IA: campos de cada termo, primeira versão, responsáveis e teste antes de entrar em operação.

Um glossário da empresa para agente de IA é uma lista curta e com dono dos termos internos, nomes de produtos, siglas e rótulos de status que o seu negócio usa, cada um com uma definição simples, a redação aprovada e um responsável nomeado que possa alterá-lo. Escreva essa lista antes de o agente atender trabalho real, limite-a aos termos que mudam o que o agente faz e carregue-a como memória que o agente consulta antes de interpretar um pedido.
Principais pontos
- Um agente sem definição para um termo interno costuma adivinhar, e a suposição soa como uma resposta correta.
- Comece pelos termos que disparam ações erradas, não por um dicionário completo da empresa.
- Cada entrada precisa de uma definição, uma linha de “não é”, o rótulo aprovado para o cliente e um responsável nomeado.
- Guarde o glossário como memória revisada, alterada por um processo registrado, e não por correções pontuais no chat.
- Teste o glossário com pedidos reais antes de qualquer agente agir com base nele.
Por que agentes adivinham termos internos
Um modelo de linguagem geral conhece o significado público da maioria das palavras. Ele não sabe que a equipe de expedição chama um lote urgente de “prioridade”, que “retenção” significa cobrança pausada e não estoque reservado, ou que um apelido interno se refere a um único módulo de agendamento. Quando o termo falta, o agente raramente admite a lacuna. Ele escolhe o significado mais provável pelo texto ao redor e segue em frente, e a resposta fica tão fluente que ninguém a questiona até que um cliente ou um colega aja com base nela.
Por isso, um glossário é um ativo diferente de uma biblioteca de documentos. Os documentos guardam procedimentos e políticas. O glossário guarda o sentido, e é a camada que ensina o agente a ler esses procedimentos. Se uma política diz “liberar a retenção após a verificação”, o agente precisa saber o que conta como retenção e o que verificação significa na sua empresa antes de agir. Quando a lacuna é uma pergunta que os documentos não respondem, registre-a para que o responsável possa fechá-la, como descrito em Lacunas de agentes de IA: como registrar perguntas sem resposta.
As notas de engenharia da Anthropic sobre engenharia de contexto apontam um ponto relacionado: um agente trabalha com o contexto que recebe, então esse contexto precisa ser escolhido de propósito, e não deixado para acumular. O glossário é uma das formas mais baratas de tornar esse contexto preciso.
O que cada entrada do glossário precisa conter
Mantenha cada entrada curta o bastante para que o responsável a revise em um minuto. Uma entrada útil tem cinco partes:
- O termo exatamente como a equipe escreve, com a grafia usada e as variações que aparecem em chamados e mensagens.
- Uma definição de uma ou duas frases, escrita para alguém que entrou na empresa na semana passada.
- Uma linha de “não é” que separa o termo do vizinho mais próximo, como “Devolução é o equipamento fisicamente retornado, não uma troca de garantia”.
- O rótulo aprovado para respostas ao cliente e qualquer rótulo interno que nunca deva aparecer em mensagem para o cliente.
- Um responsável nomeado que aprova mudanças e decide quando duas pessoas discordam sobre o sentido.
Inclua um marcador de versão em cada entrada, para que uma definição alterada seja rastreável e uma antiga possa ser aposentada sem perder o histórico. Se uma entrada começa a precisar de uma página de explicação, essa explicação provavelmente pertence a um documento de procedimento, e a entrada deve citar esse documento em vez de repeti-lo. Para ver como o glossário se encaixa entre outros conhecimentos da empresa, veja Glossário da empresa para agentes de IA: termos que o agente deve usar.
Um plano para escrever a primeira versão
A primeira versão deve levar a um grupo pequeno algumas sessões de trabalho, não um trimestre. Siga esta sequência:
- Reúna termos candidatos das últimas semanas de respostas de suporte, notas de passagem, registros de pedidos e conversas internas em que um colega novo perguntou o que algo significava.
- Reduza a lista aos termos que mudam uma ação: um status que dispara um fluxo, um módulo de produto que direciona um pedido, uma sigla que aparece em mensagens de clientes ou uma palavra que duas equipes usam de forma diferente.
- Peça ao responsável de cada área que escreva a definição e a linha de “não é” com as próprias palavras, em no máximo duas frases cada.
- Marque quais rótulos o cliente pode ver e quais ficam internos, e confirme isso com quem cuida da comunicação com clientes.
- Carregue as entradas aprovadas como memória da empresa, com responsável e versão registrados, e marque-as como revisadas para que o agente as diferencie de rascunhos.
- Rode um conjunto de pedidos reais que usem esses termos. Verifique se o agente usa o sentido aprovado e se pergunta quando aparece um termo que ainda não recebeu.
- Publique uma regra curta de mudança: qualquer pessoa pode propor, o responsável aprova e a mudança aprovada fica registrada com o motivo.
O último passo é o que as pequenas equipes mais pulam, e é ele que mantém o glossário verdadeiro depois do primeiro mês.
Cenário ilustrativo: uma palavra, dois sentidos
Cenário ilustrativo, não é um cliente real: uma pequena locadora de equipamentos usa “devolução” de duas formas. A equipe usa o termo para um cliente que devolve o equipamento ao depósito, e também para uma troca de garantia tratada pelo mesmo formulário. Um agente sem glossário recebe a mensagem “quero fazer uma devolução” e responde com a política de reembolso, que vale apenas para equipamento não usado dentro do prazo de locação. O cliente tem uma máquina com defeito e fica confuso sobre por que a resposta não serve.
Depois que os responsáveis incluem duas entradas, a situação muda. “Devolução” passa a significar o equipamento que volta fisicamente ao depósito. “Troca de garantia” é um termo separado, com formulário e fila próprios. Quando a mensagem é ambígua, o agente pergunta qual dos dois o cliente quer dizer e encaminha os casos de garantia para a equipe certa, sem citar a política de reembolso. A correção levou duas entradas e um pedido de teste, e é esse pedido de teste que comprova que a correção se sustenta.
Manter o glossário com dono e pequeno
Um glossário se deteriora de duas formas: cresce com entradas duplicadas e suas definições se afastam de como o negócio realmente funciona. As duas coisas são controladas por responsabilidade e revisão, e não por boa intenção. O guia Manutenção da base de conhecimento de IA: responsáveis e rotina descreve como definir esse ritmo para a base de conhecimento como um todo, e as mesmas regras valem aqui. O NIST AI Risk Management Framework trata papéis claros e supervisão documentada como parte da gestão de sistemas de IA, e um glossário com responsáveis nomeados é uma versão pequena e prática dessa ideia.
Um checklist curto mantém a revisão viável:
- Cada entrada tem exatamente um responsável e um papel aprovador.
- Nenhuma duas entradas definem a mesma coisa. Quando definem, una-as e mantenha o rótulo aprovado.
- Termos aposentados continuam visíveis como aposentados, com o substituto indicado, para que o agente não ressuscite um sentido antigo.
- Nomes de clientes, dados pessoais e opiniões da equipe ficam fora do glossário. Eles pertencem a registros com regras próprias.
- Cada novo termo passa pelo mesmo teste da primeira versão: muda uma ação, e um responsável escreveu sua definição.
- Há revisão em um ritmo fixo acordado pelo responsável, e também sempre que um termo causar uma resposta errada em teste ou em produção.
Quando uma resposta errada remonta a um termo, trate a mudança no glossário como a correção e confira-a com os mesmos pedidos que expuseram o problema.
Como a abordagem gerenciada da Be Human lida com isso
Na abordagem gerenciada da Be Human, o glossário faz parte do desenho de memória do primeiro projeto, junto com o papel do agente, as ferramentas e os limites de aprovação. Trabalhamos com os responsáveis de cada área para redigir as entradas com as próprias palavras, marcar quais rótulos podem chegar ao cliente e carregar as entradas aprovadas com responsável e versão registrados. Avaliações recorrentes verificam se o agente usa os sentidos aprovados e pergunta quando um termo é desconhecido. A revisão de permissões e as mudanças registradas mantêm as edições controladas depois da entrada em operação, e a resposta a incidentes cobre o caso em que um sentido errado chega ao cliente.
Se você não tem certeza de qual termo interno causaria mais respostas erradas, o diagnóstico gratuito de IA da Be Human ajuda a encontrar a primeira tarefa que vale entregar a um agente.
Perguntas frequentes
Quão longo deve ser um glossário da empresa para agente de IA? Uma primeira versão útil é curta, geralmente algumas dezenas de entradas que cubram os termos por trás de decisões reais e respostas a clientes. O tamanho importa menos do que a cobertura dos termos que mudam uma ação. Se a lista não para de crescer, procure duplicatas e entradas que pertencem a um documento de procedimento.
Quem deve escrever as definições? As pessoas responsáveis por cada área, porque elas sabem onde o termo é usado e onde ele se confunde com um vizinho. Um editor ou o líder de operações pode reunir os candidatos e revisar a clareza da redação, mas o sentido deve vir do responsável. Uma definição escrita por alguém de fora da área tende a estar certa em termos gerais e errada nos detalhes que importam.
O glossário deve substituir os documentos do agente? Não. O glossário explica o que as palavras significam, e os documentos explicam como fazer as coisas e quais são as regras. O agente precisa dos dois, e o glossário o ajuda a ler os documentos corretamente. Quando uma entrada precisa de uma explicação longa, ela deve apontar para o documento pelo nome, em vez de repeti-lo.
Com que frequência o glossário deve ser revisado? Revise em um ritmo fixo que os responsáveis aceitem e também sempre que um termo causar uma resposta errada durante os testes ou em produção. O ritmo importa menos que a regra de que as mudanças são propostas, aprovadas pelo responsável e registradas. Um glossário revisado apenas quando alguém se lembra dele começa a se desviar em poucos meses de uso real.
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.


