Skip to main content
GraphRAG é a forma como o Memory monta contexto percorrendo as relações de uma entidade, além dos seus atributos. Ele traz o ecossistema ao redor do nó consultado: a empresa, os contratos, os colegas, os eventos conectados. A profundidade desse percurso é configurável a cada request.

​
Por que GraphRAG existe

Um lookup simples devolve a entidade isolada. Serve para uma consulta pontual, mas perde o que dá sentido à situação: quem está ao redor e o que aconteceu nesse entorno. O que dá sentido a uma situação é o ecossistema da entidade: a empresa a que ela pertence, os contratos dela, os colegas ao redor. GraphRAG entrega esse entorno percorrendo as arestas do grafo a partir do nó consultado. Compare as duas respostas para a mesma pergunta: Sem GraphRAG (lookup simples):
“Maria Silva, plano Growth, 3 tickets nos últimos 30 dias.”
Com GraphRAG (traversal de relacionamentos):
“Maria Silva, CTO da TechCorp (12 funcionários na plataforma). TechCorp tem 3 contratos ativos. Nos últimos 30 dias: Maria abriu 3 tickets, colegas dela abriram 7 — 4 sobre o mesmo módulo. A empresa está no Q4 de renovação.”
A segunda resposta não trouxe mais dados sobre Maria. Trouxe os vizinhos dela no grafo.

​
Profundidade configurável

Você escolhe a cada request quantos saltos (hops) o Memory percorre a partir da entidade. Mais profundidade traz mais contexto e custa mais latência. Escolha a profundidade pela pergunta que o agente precisa responder:
  • Confirmar um atributo da própria entidade → none
  • Entender a conta e os contratos ligados a ela → immediate
  • Investigar padrões no entorno (colegas, empresas relacionadas) → extended
Não peça extended por padrão. Cada hop a mais aumenta a latência e o volume de contexto enviado ao agente. Comece em immediate e suba só quando a pergunta exigir o segundo grau de relações.

​
O que o traversal percorre

O grafo do Memory guarda três coisas que o GraphRAG combina em cada resposta: A none retorna só o nó consultado e sua timeline. Cada nível acima adiciona os nós alcançáveis por mais um salto de aresta.

​
Casos de uso

Um lookup mostra a conta saudável. Com extended, o contexto revela que colegas do contato abriram sete tickets no mesmo módulo no último mês. É um sinal de risco que só aparece percorrendo as relações.
Um agente que só precisa confirmar o plano contratado pede none. Resposta em dezenas de milissegundos, sem carregar o entorno que aquela pergunta não usa.

​
Próximos passos

Entity Resolution

Entenda como as entidades que o GraphRAG percorre são consolidadas.

Memory

Volte à visão geral do grafo de contexto.

MCP Server

Veja como os agentes consomem o contexto expandido via Model Context Protocol.

Memory API

Consulte entidades e escolha a profundidade via API REST.