# Aula 2.5: Grafo e RAG no vault (passo a passo)

Você vai abrir o vault no Obsidian, ver o grafo de links e perguntar ao Claude sobre as notas, sempre com a fonte. No fim faz um teste contrário: uma pergunta cuja resposta não existe. Pré-requisito: o `CLAUDE.md` com o protocolo da aula 2.2 e as notas da aula 2.3. Prompts em `prompts.md`.

## Grafo e RAG em uma frase cada
- O **grafo** é um mapa: cada nota é um ponto, cada link `[[assim]]` é uma linha. Você vê as ligações.
- **RAG** é um sistema de busca que escolhe os trechos certos e os entrega ao modelo.
- O que você vai usar aqui é um meio-termo: o Claude Code não tem índice, ele lê arquivos e busca texto (glob e grep) e segue os links como trilha. Para poucas notas isso basta. O nome mais honesto é "recuperação sem índice".

## Passo a passo
1. **Abra a pasta como vault.** No Obsidian: "Abrir pasta como cofre" e escolha a pasta do vault.
   Captura: o Obsidian com as dez notas do Café Aurora na lista de arquivos.
2. **Abra o grafo.** Clique no ícone "Open graph view" da barra lateral. O atalho comum é `Ctrl+G`, mas ele não consta na documentação oficial: confira em Configurações, Atalhos, "graph".
   Captura: o grafo com a nota central e as notas ligadas a ela.
3. **Abra a mesma pasta no VS Code** com o Claude Code. O `CLAUDE.md` do vault carrega no início da sessão.
4. **Pergunta 1, com fonte.** Cole a pergunta do fornecedor de leite (`prompts.md`). Resposta esperada: o nome do fornecedor e a nota de onde veio.
   Captura: resposta citando `[[nota]]`.
5. **Pergunta 2, com fonte.** O cliente que gosta do café. Abra a nota citada e confira o trecho.
6. **Teste contrário.** Pergunte o faturamento de dezembro, que não está nas notas. A resposta certa é "não encontrei no vault".
   Captura: o Claude avisando que não achou, em vez de inventar.
7. **Revise as notas criadas por IA.** Na gravação, o Claude havia escrito preços que ninguém forneceu quando criou as notas. A resposta foi fiel à nota, mas a nota estava errada. Use a lista `como-saber-se-inventou.md` e o `protocolo-rag.md` (duas linhas a mais contra dado inventado).
8. **Antes de subir documentos da sua empresa** para o chat, tire dados pessoais (LGPD, Lei 13.709/2018).

## Onde isso quebra
- **"Ele não vai alucinar" é falso.** A documentação da Anthropic diz que as técnicas reduzem as alucinações, mas não as eliminam. Valide o que importa. (Fonte 5)
- **Nota inventada, resposta fiel.** O protocolo só garante que a resposta vem das notas. Se a nota tem dado inventado, a resposta repete o erro.
- **Sem índice.** Com centenas de notas a busca fica lenta e gasta contexto. Aí vale um índice (decisão da casa: passando de umas 30 notas; é palpite técnico).
- **Cabe na janela? Então não precisa de RAG.** Para bases pequenas, a Anthropic sugere pôr tudo no prompt. Com janelas de 1 milhão de tokens o ponto de corte subiu; o número exato é palpite. (Fonte 4)
- **Documento escaneado ou mal convertido** responde errado com confiança. Olhe a entrada antes de culpar o modelo.
- **Obsidian fechado ou aberto não muda nada** para o Claude Code: ele lê os arquivos direto. Plugins e MCP só entram se você precisar buscar com o app aberto.

## Entrega (50 XP)
O protocolo no `CLAUDE.md` do seu vault, três capturas (pergunta com fonte, segunda pergunta com fonte, "não encontrei") e uma frase no README dizendo o que você aprendeu. O script de RAG com Ollama virou bônus (aula 3.9). Use `checklist.md`.

## Links oficiais (acesso em 30/10/2026)
1. https://code.claude.com/docs/en/how-claude-code-works (como o Claude lê e busca na pasta)
2. https://obsidian.md/help/plugins/graph (Graph view)
3. https://obsidian.md/help/links (wikilinks)
4. https://www.anthropic.com/news/contextual-retrieval (o que é RAG e quando dispensar, 19/09/2024)
5. https://platform.claude.com/docs/en/test-and-evaluate/strengthen-guardrails/reduce-hallucinations (permissão para "não sei", citações)
6. https://support.claude.com/en/articles/11473015-retrieval-augmented-generation-rag-for-projects (RAG nos Projects do claude.ai)