> ## Documentation Index
> Fetch the complete documentation index at: https://docs.strattum.ai/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.

***

## 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

> **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.

> **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.

***

## Próximos passos

> **[Entity Resolution](https://docs.strattum.ai/memory/entity-resolution.md)**
>
> Entenda como as entidades que o GraphRAG percorre são consolidadas.

> **[Memory](https://docs.strattum.ai/memory/overview.md)**
>
> Volte à visão geral do grafo de contexto.

> **[MCP Server](https://docs.strattum.ai/mcp-server/index.md)**
>
> Veja como os agentes consomem o contexto expandido via Model Context Protocol.

> **[Memory API](https://docs.strattum.ai/api-reference/memory/introduction.md)**
>
> Consulte entidades e escolha a profundidade via API REST.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.