> ## Documentation Index
> Fetch the complete documentation index at: https://strattumai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# GraphRAG

> Como o Memory expande o contexto de uma entidade pelas suas relações — profundidade de traversal configurável por request, de lookup simples a dois hops.

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.

| Profundidade        | Contexto retornado                               | Latência típica |
| ------------------- | ------------------------------------------------ | --------------- |
| `none` (0 hop)      | Apenas perfil + timeline                         | 10–20ms         |
| `immediate` (1 hop) | Entidade + vizinhos diretos (empresa, contratos) | 50–150ms        |
| `extended` (2 hops) | Entidade + vizinhos + vizinhos dos vizinhos      | 200–500ms       |

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`

<Tip>
  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.
</Tip>

***

## O que o traversal percorre

O grafo do Memory guarda três coisas que o GraphRAG combina em cada resposta:

| Elemento     | O que traz para o contexto                             |
| ------------ | ------------------------------------------------------ |
| **Nós**      | As entidades vizinhas — empresa, contrato, produto     |
| **Arestas**  | As relações entre elas — `TRABALHA_NA`, `TEM_CONTRATO` |
| **Timeline** | Os eventos conectados à entidade, em ordem cronológica |

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

<AccordionGroup>
  <Accordion title="Renovação em risco pelo entorno">
    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.
  </Accordion>

  <Accordion title="Contexto enxuto para consulta rápida">
    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.
  </Accordion>
</AccordionGroup>

***

## Próximos passos

<CardGroup cols={2}>
  <Card title="Entity Resolution" icon="object-group" href="/memory/entity-resolution">
    Entenda como as entidades que o GraphRAG percorre são consolidadas.
  </Card>

  <Card title="Memory" icon="brain" href="/memory/overview">
    Volte à visão geral do grafo de contexto.
  </Card>

  <Card title="MCP Server" icon="plug" href="/mcp-server/index">
    Veja como os agentes consomem o contexto expandido via Model Context Protocol.
  </Card>

  <Card title="Memory API" icon="terminal" href="/api-reference/memory/introduction">
    Consulte entidades e escolha a profundidade via API REST.
  </Card>
</CardGroup>