Grafo de conhecimento para agentes de IA: comece com cinco entidades
Um grafo pequeno vence documentos quando o agente precisa ligar clientes, pedidos e regras. Comece com cinco tipos de entidade, ligados a uma tarefa.

Um grafo de conhecimento para agentes de IA é um conjunto pequeno de coisas nomeadas com as quais sua empresa trabalha, como clientes, pedidos, produtos e regras, somado a ligações explícitas entre elas. Ele supera documentos simples quando o agente precisa juntar fatos que vivem em registros diferentes, como a qual conta um pedido pertence e qual versão de contrato se aplica. Comece com cinco tipos de entidade, ligue-os a uma única tarefa e amplie somente quando uma falha mostrar que o grafo está deixando algo de fora.
Principais pontos
- Um grafo compensa quando as respostas dependem de relações entre registros, e não da redação de um único documento.
- Comece com cinco tipos de entidade ligados a uma tarefa, e não com a empresa inteira.
- Dê a cada entidade um identificador, um responsável nomeado e uma fonte da verdade em um dos seus sistemas.
- Mantenha o conjunto pequeno o bastante para que uma pessoa consiga revisá-lo em uma sessão por mês.
- Mantenha documentos simples para políticas e tom de voz, e use o grafo para as perguntas que começam com qual, para quem e a partir de quando.
Quando documentos simples bastam
Documentos simples funcionam bem quando a resposta está inteira dentro de um único texto. Uma política de devolução, um procedimento de limpeza, um guia de tom de voz ou uma lista de integração podem ser recuperados, lidos e citados sem muita estrutura. A maioria dos agentes de empresa deveria começar assim, porque uma pasta organizada com documentos atualizados é mais barata de manter do que qualquer grafo e já responde a boa parte das dúvidas rotineiras.
Documentos também bastam quando os fatos mudam pouco e ninguém precisa combiná-los. Se o agente apenas explica como um processo funciona, um conjunto bem organizado de documentos, com versões claras, costuma ser suficiente. Nessa fase, os erros geralmente vêm de versões antigas e de responsabilidades mal definidas, e não da falta de estrutura. Esses problemas merecem atenção primeiro, e o guia sobre como dar a um agente de IA uma fonte da verdade confiável os trata de forma prática.
Quando um grafo pequeno supera documentos
Documentos têm dificuldade quando a resposta está entre registros. Pense em uma pergunta da equipe como esta: quais pedidos em aberto pertencem à conta que pediu um novo endereço de entrega, e essa conta já aceitou as condições atuais? O agente precisa conectar um cliente, um pedido, uma cláusula contratual e uma data. A busca em texto consegue encontrar cada peça separadamente, mas não guarda a junção entre elas. Assim, o agente pode associar uma cláusula de um contrato antigo a um pedido novo e produzir uma resposta que soa bem e está errada.
Um grafo armazena essa junção de forma explícita. Este pedido pertence a esta conta, esta conta está sujeita a esta versão de contrato, e esta versão substituiu a anterior em uma data conhecida. O agente não precisa deduzir a ligação a partir da redação, o que elimina uma classe inteira de erros. A identidade também importa aqui, porque o mesmo cliente pode aparecer com nomes diferentes nos seus sistemas. A lógica por trás das regras para unificar cadastros de clientes é uma boa companhia para qualquer desenho de grafo.
Use este guia curto de decisão antes de construir qualquer coisa:
- Escolha documentos quando a resposta estiver contida em um só texto e esse texto mudar raramente.
- Escolha um grafo pequeno quando a resposta exigir cruzar dois ou mais registros que o agente não pode confundir.
- Escolha os dois quando as regras estiverem em documentos, mas os fatos a que se aplicam estiverem em sistemas operacionais.
- Espere quando ainda não for possível nomear o responsável pelos fatos. Um grafo com registros sem dono se deteriora rápido.
Os cinco tipos de entidade para começar
Para a maioria das pequenas e médias empresas, cinco tipos de entidade cobrem uma primeira tarefa útil. Cada um deve corresponder a algo que a equipe já procura à mão.
- Pessoa ou titular de conta: quem está perguntando, qual função exerce e o que pode ver.
- Cliente ou organização: a parte externa, com os identificadores que seus sistemas já usam.
- Pedido, serviço ou caso: a unidade de trabalho que o agente toca, com o status atual.
- Produto, ativo ou serviço: o assunto do trabalho, incluindo a versão ou o modelo que se aplica.
- Regra ou política: uma afirmação datada e com responsável, que governa o trabalho e está ligada ao documento que a define.
Mantenha as relações entre esses tipos poucas e explícitas no início. Uma pessoa age sobre um pedido, um pedido se refere a um produto, uma conta está sujeita a uma regra. Resista à vontade de criar um tipo de entidade para cada conceito da empresa. Cada tipo extra aumenta a manutenção, exige outro responsável e abre outra forma de errar. Você pode acrescentar um sexto tipo mais tarde, quando a primeira tarefa já estiver passando na revisão.
Cinco tipos de entidade são um ponto de partida restrito, não uma teoria sobre como empresas devem ser modeladas.
Um plano passo a passo para o primeiro grafo
O caminho mais confiável é começar por uma tarefa e trabalhar de trás para frente até os dados. A sequência a seguir mantém o escopo pequeno o bastante para ser concluído e revisado.
- Escolha a única tarefa que o agente executará primeiro e anote exatamente as perguntas que ele precisa responder.
- Liste os registros que uma pessoa experiente consulta hoje para responder a essas perguntas, incluindo os sistemas onde ela procura.
- Mapeie esses registros para os cinco tipos de entidade e descarte o que a tarefa não precisa.
- Atribua a cada entidade um identificador, um responsável nomeado e o sistema que é sua fonte da verdade.
- Defina as relações permitidas e proíba qualquer relação que não esteja na lista, até que alguém tenha um motivo para acrescentá-la.
- Carregue uma amostra de algumas dezenas de registros e faça ao agente as perguntas do primeiro passo.
- Registre cada resposta errada ou ausente e corrija o registro ou a relação na origem, em vez de apenas ajustar o prompt.
- Acrescente um novo tipo de entidade somente depois que a primeira tarefa tiver passado na revisão com um conjunto fixo de perguntas.
Os dois últimos passos são os mais importantes. Um grafo que nunca é testado com perguntas reais vira um diagrama que parece certo e responde mal. Para o conjunto de teste, uma lista curta de perguntas reais com respostas corretas conhecidas, funciona bem a abordagem de como testar a qualidade da busca em uma base de IA.
Cenário ilustrativo: um pedido recorrente que não deveria sair
O cenário a seguir é ilustrativo e não descreve uma empresa específica. Um pequeno distribuidor usa um agente para responder à equipe sobre pedidos recorrentes. A empresa tem um catálogo de produtos e uma página de condições. O catálogo marca um item como descontinuado, e um e-mail de um fornecedor menciona um substituto aprovado. Ao ler os dois documentos, o agente oferece o substituto em um pedido recorrente de uma conta cujo contrato proíbe substituições.
Em uma versão com grafo, a entidade do produto carrega uma cadeia de substituição que registra o substituto como proposta, e não como aprovação. A entidade de regra da conta afirma que substituições exigem aprovação da equipe, e a relação entre a conta e essa regra é explícita. Quando perguntado, o agente consegue dizer qual regra se aplica, por que o substituto não é automático e quem precisa aprovar. A correção não foi um prompt mais longo. Foi uma relação, um responsável pela regra de substituição e uma pergunta de teste acrescentada ao conjunto.
Quem pode alterar o grafo
Um agente que pode editar o próprio conhecimento precisa da mesma disciplina de qualquer usuário de sistema. O padrão seguro é que o agente leia o grafo, proponha alterações e uma pessoa aprove. As orientações de autorização da OWASP enfatizam o privilégio mínimo e a verificação de acesso em cada requisição, e os dois princípios se aplicam diretamente às gravações no grafo. Uma proposta de mudança em uma regra deve mostrar o valor antigo, o valor novo, a fonte e quem pediu.
As permissões também devem seguir as funções. Um líder de depósito pode ver relações de estoque que um assistente de vendas não vê, e um agente voltado ao cliente não deveria ver regras internas de margem. A estrutura de acesso por função descrita em acesso à memória de IA por função em empresas vale para entidades do grafo tanto quanto para documentos. Mantenha fora do grafo qualquer dado pessoal ou regulado que a tarefa não precise, e siga as orientações sobre dados sensíveis que nunca devem ser guardados na memória de agentes de IA.
Como a Be Human faz, e por onde começar
A Be Human desenha o primeiro conjunto de entidades em torno de um papel útil, depois define a memória e as ferramentas que esse papel precisa, os limites de aprovação para qualquer alteração e um critério de sucesso que alguém consiga observar. Depois do lançamento, a operação gerenciada cobre monitoramento, avaliações recorrentes sobre o conjunto de perguntas, revisões de permissão, manutenção das conexões com as fontes e atualizações controladas quando uma regra ou um sistema muda. O trabalho é remoto, em inglês ou em português, e permanece sob o seu controle em cada etapa.
Se você não tem certeza de qual tarefa deve vir primeiro, o diagnóstico gratuito de IA da Be Human ajuda a encontrar a primeira tarefa que vale a pena entregar a um agente.
Perguntas frequentes
Preciso de um banco de dados de grafo para começar? Não. Um grafo pequeno pode ser guardado em tabelas com identificadores e tabelas de relações, e a escolha de armazenamento importa menos que a disciplina de responsáveis, identificadores e revisão. Migre para um armazenamento dedicado somente quando as tabelas ficarem difíceis de manter ou as relações crescerem além do que sua equipe consegue revisar.
Em que um grafo de conhecimento difere de embeddings? Embeddings encontram textos parecidos com uma pergunta, o que é útil para localizar documentos relevantes. Um grafo armazena ligações explícitas entre registros, como qual pedido pertence a qual conta. As duas abordagens costumam funcionar juntas: os embeddings encontram os documentos candidatos, e o grafo confirma qual registro e qual regra se aplicam.
Com que frequência o grafo deve ser revisado? Revise a lista de entidades e as relações em um calendário fixo, como mensalmente, e revise qualquer mudança em uma regra ou sistema de origem assim que ela acontecer. Atribua um responsável nomeado por tipo de entidade, para que alguém responda pelos registros desatualizados ou contestados, e registre a data de cada revisão.
O que fazer quando o agente responde errado a partir do grafo? Trate o erro primeiro como um problema de dados ou de relação. Registre a pergunta, a resposta e os registros que o agente usou, depois corrija a fonte ou a relação e rode de novo a mesma pergunta no seu conjunto de teste antes de encerrar o chamado.
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.


