RAG Profundo · indexação hierárquica recursiva

O índice profundo guarda o conhecimento que não pode ser fatiado sem perder sentido. Internamente é RAPTOR. Em comunicação externa, descrevemos sempre como indexação hierárquica recursiva ou estrutura em camadas, nunca pelo nome.

O que entra no índice profundo

• Livros e obras de referência de agricultura regenerativa, biologia do solo e agroecologia tropical.
• Manuais técnicos densos e protocolos longos, por exemplo manuais de MIP, manejo de pastagens, sistemas agroflorestais.
• Teses, dissertações e revisões científicas validadas pela curadoria GAAS.
• Normas e protocolos de certificação, por exemplo certificação orgânica, onde a resposta exige fidelidade ao texto da norma e ao seu contexto.

Caráter transversal: o índice profundo não tem recorte de cultura. É a base que serve qualquer setor quando a pergunta pede fundamento, conceito ou texto normativo.

Por que RAPTOR e não chunk simples

Em um RAG comum, um livro vira centenas de pedaços soltos. Uma busca recupera o pedaço mais parecido com a pergunta, mas perde o contexto do capítulo. RAPTOR resolve construindo uma árvore: os pedaços originais são as folhas, grupos de pedaços parecidos viram um resumo, grupos de resumos viram um resumo de nível acima, e assim por diante até a raiz. O agente passa a recuperar tanto o trecho específico quanto o resumo que o contextualiza.

Pipeline de ingestão

Recuperação no MVP · árvore colapsada

Para o MVP usamos a estratégia de árvore colapsada: a consulta busca em todos os níveis ao mesmo tempo e devolve os melhores nós, sejam folhas ou resumos. É mais simples de operar que a travessia nível a nível e entrega a maior parte do ganho. A travessia guiada fica para depois, quando houver volume para justificar.

// Nó do índice profundo, ficha de metadados
{
  "id": "raptor_solo_vivo_cap3_n12",
  "indice": "raptor",
  "pilar": "formal",
  "nivel_arvore": 2,            // 0 = folha, sobe ate a raiz
  "vinculo_pai": "raptor_solo_vivo_cap3_raiz",
  "vinculo_filhos": ["..._n07", "..._n08", "..._n09"],
  "classe_ontologica": ["processo", "estrutura"],
  "ramo_arvore": "fundamentos.biologia_do_solo",
  "tipo_evidencia": "cientifica",
  "fonte": "Livro X, cap. 3",
  "ano": 2021,
  "validacao_gaas": true,
  "escopo_setor": "transversal"
}

Quando o índice profundo é acionado

• Padrão Conceitual e fundamentos. Aqui ele é o índice primário, buscando sobre os resumos de alto nível da Árvore do Conhecimento.
• Consulta a texto normativo. Quando a pergunta pede o que a norma ou o livro diz, por exemplo regras de certificação orgânica.
• Apoio a qualquer padrão que precise de fundamento científico para justificar uma intervenção.
• Baixa confiança no índice geral aplicado. Se o índice aplicado devolve pouco ou nada no segmento, o roteador expande a busca para o índice profundo.

RAG Geral Aplicado · um índice no lançamento

No lançamento, todo o conhecimento aplicado e vivo vive em um único índice. A especificidade por cultura e bioma não vem de índices separados, vem do filtro de metadados ontológicos. A partição física é adiada e nasce dos evals, não de uma decisão de mesa.

O que entra no índice geral aplicado

• Manejo aplicado e protocolos curtos, o como fazer, o passo a passo, formato mais pedido pelos produtores.
• Notas de insumo e bioinsumo descritas por função e classe ontológica, nunca por marca, com a origem funcional marcada.
• Casos da rede GAAS, a memória de campo, o pilar do Conhecimento Vivo, anonimizada conforme as regras de dados.
• Insumos para as calculadoras determinísticas, parâmetros de custo e dose que o ciclo produtivo e a comercialização consomem.

O conhecimento longo e conceitual não entra aqui, fica no RAPTOR. Este índice é o aplicado e o vivo, pontual e acionável.

A especificidade vem do filtro, não do índice

A frustração número 1 da rede é a resposta genérica. A resposta a isso é o pré-filtro ontológico aplicado antes da busca semântica, não um índice por cultura. Um cafeicultor no segundo ano de transição na Mata Atlântica recebe uma busca já restrita a café, Mata Atlântica e às classes ontológicas do passo do CoT. O ruído de outras culturas some pelo filtro.

Os eixos de segmentação, que hoje são filtro

Os mesmos campos que filtram a busca hoje são os candidatos a virar partição amanhã. Quando um deles concentrar volume e ruído, ele sai para um índice próprio.

A ficha de metadados única

Todo pedaço de conhecimento, no RAPTOR e no índice geral aplicado, carrega a mesma ficha de metadados derivada da ontologia. É essa ficha que permite filtrar antes de buscar por semântica, e é também o eixo pelo qual o índice geral será particionado mais tarde. Os dois documentos estruturais travam isto: a Ontologia define o esquema da ficha e a Árvore do Conhecimento é o vocabulário controlado do campo ramo_arvore.

// Ficha de metadados, comum a todos os indices
{
  "id": "aplicado_diag_nodulacao_caso_041",
  "indice": "geral_aplicado", // no lancamento: raptor ou geral_aplicado
  "pilar": "vivo",            // formal, aplicado, vivo
  "classe_ontologica": ["sintoma", "causa_provavel", "processo"],
  "subclasse": "baixa_nodulacao",
  "ramo_arvore": "manejo.fixacao_biologica",
  "bioma": ["cerrado"],
  "cultura": ["soja"],
  "escala": "talhao",
  "origem_funcional": "propria",    // propria, regional, importada
  "tipo_evidencia": "validada",    // cientifica, validada, emergente
  "confiabilidade": 0.8,
  "validacao_gaas": true,
  "fonte": "Caso GAAS, fazenda anonimizada",
  "ano": 2025,
  "nivel_raptor": null,        // preenchido so no indice profundo
  "tags_situacionais": ["transicao_em_curso"]
}

Os campos e para que servem

Filtro estruturado antes da busca semântica

O ganho dessa ficha é simples: o roteador aplica filtros estruturados, por exemplo bioma igual a Cerrado, cultura igual a soja e classe ontológica entre sintoma, causa, processo e intervenção, antes de rodar a similaridade vetorial. Isso reduz o espaço de busca em uma ordem de grandeza e é o que evita a resposta genérica. A busca semântica trabalha sobre um subconjunto já pertinente.

Evidência e os três pilares

O campo de tipo de evidência amarra a ficha aos três pilares e à exigência de transparência. Conhecimento científico, vindo do índice profundo, é evidência científica. Manejo documentado e validado é evidência validada. Casos recentes da rede ainda sem validação ampla são evidência emergente. A resposta sempre informa de onde veio cada peça, e o agente não trata emergente como se fosse científico.

Roteamento sobre os dois índices

O roteamento por seis padrões já está definido. Aqui mostramos como cada padrão se materializa em buscas concretas sobre os dois índices físicos do lançamento, o RAPTOR e o geral aplicado, sem a complexidade do GraphRAG ou da política por reforço, que ficam para depois.

Fluxo do Orquestrador

Matriz padrão por índice no MVP

O índice geral aplicado é primário nos padrões operacionais, sempre com o pré-filtro ontológico de classe, cultura e bioma. O RAPTOR é primário no conceitual e apoio nos demais. Quando um segmento virar partição, o nome do índice primário muda, a lógica não.

Exemplo de decisão de roteamento

// Pergunta: meu solo esta com baixa nodulacao no segundo ano de soja
{
  "perfil": { "cultura": "soja", "bioma": "cerrado", "estagio": "transicao" },
  "padrao_detectado": "diagnostico",
  "plano_indices": {
    "primario": "geral_aplicado",
    "apoio": "raptor",
    "modo": "hibrida + rerank"
  },
  "filtros": {
    "bioma": ["cerrado"],
    "cultura": ["soja"],
    "classe_ontologica": ["sintoma", "causa_provavel", "processo", "intervencao"]
  },
  "casos_semelhantes": true     // reforcado pela Skill transicao_em_curso
}

Fan out: hoje por filtro, amanhã por índice

No índice único, o equivalente ao fan out é combinar filtros dentro do mesmo índice. Um perfil de ILPF, que mistura grãos e pecuária, dispara uma busca com cultura em soja e em pastagem ao mesmo tempo, mais o RAPTOR para o fundamento. Não há vários índices a consultar ainda. Quando os evals indicarem que um segmento merece índice próprio, esse mesmo fan out passa a cruzar índices físicos, e a lógica de roteamento não muda. É por isso que o adiamento é seguro.

Modo Conversa e Modo Técnico

Sinalizações que disparam fallbacks

Assistente de Perguntas · gerar e salvar prompts

A qualidade da resposta começa na pergunta. A frustração com resposta genérica nasce, em boa parte, de perguntas curtas e sem contexto. Esta funcionalidade ajuda o usuário a transformar uma dúvida solta em uma pergunta rica, e a guardar as boas perguntas para reusar.

Gerar · da pergunta solta à pergunta rica

Dois caminhos, conforme o esforço que o usuário quer ter.

A anatomia do prompt segue a cadeia

Salvar · a tela Minhas Perguntas

• Salvar próprios e curados. O usuário guarda as perguntas que criou e também as da galeria GAAS.
• Organizar por cultura, tema ou talhão. Etiquetas simples para achar depois.
• Rodar rápido. Um toque executa a pergunta salva, com opção de reatualizar o contexto, por exemplo a safra atual, antes de rodar.
• Editar e duplicar. Partir de uma pergunta salva para criar uma variação.

Curadoria e inteligência coletiva

Dois selos, coerentes com a lógica de reconhecimento já desenhada para o blog.

As melhores perguntas dos usuários entram no acervo curado, e esse é o motor da inteligência coletiva. Com consentimento LGPD, os prompts e os resultados instrumentados alimentam, mais à frente, a política de roteamento automático.

Onde a funcionalidade aparece na interface

Modelo de dados do prompt

// Objeto prompt, persistido em Postgres
{
  "id": "prompt_a1b2",
  "user_id": "usr_338",
  "titulo": "Baixa nodulacao na soja, segundo ano",
  "corpo": "... pergunta enriquecida ...",
  "padrao_alvo": "diagnostico",
  "categoria": "solo_e_fertilidade",
  "persona": "produtor",
  "cultura": ["soja"],
  "bioma": ["cerrado"],
  "origem": "proprio",        // proprio, curado, derivado
  "status": "privado",        // privado, submetido, validado
  "run_count": 3,
  "consentimento_lgpd": true,
  "criado_em": "2026-06-10"
}

O que fecha o MVP

O MVP sobe enxuto: o RAPTOR para o conhecimento longo e um único RAG geral aplicado com os filtros ontológicos. A partição em segmentos não é entrega de lançamento, é evolução guiada pelos evals. Com a base de conhecimento e o Assistente de Perguntas entregues, o MVP fecha sobre a arquitetura, a ontologia e o roteamento já prontos.

Entregas deste pacote

• Dois índices no lançamento. Um RAPTOR para o conhecimento formal e longo, e um RAG geral aplicado para o aplicado e o vivo, ambos com a ficha de metadados única.
• Roteador instanciado. Os seis padrões traduzidos em buscas sobre os dois índices, com o pré-filtro ontológico, os fallbacks e os dois modos.
• Eval e gatilhos de quebra. O processo de avaliação rodando, com as métricas por segmento e os limiares que disparam a partição.
• Assistente de Perguntas. Gerar, salvar, galeria curada e sugestões na interface, com consentimento LGPD.

Roteiro de implementação

Dependências

• Curadoria GAAS. Sem o comitê definindo o que entra, os índices não ganham qualidade. É o guardião epistêmico.
• LGPD. Consentimento de captura, mais apagar e exportar, é pré-requisito do Assistente de Perguntas e do uso coletivo dos dados.
• Instrumentação desde o dia 1. Sem a série histórica de métricas por segmento, a decisão de quebrar vira impressão. A captura tem que nascer junto com os índices.

O que fica para depois do MVP

Tudo abaixo se assenta sobre os dois índices iniciais. O substrato já nasce pronto para receber estas camadas, sem reescrita.

• Partições do índice geral. A quebra em segmentos por cultura, bioma ou ramo, disparada pelos gatilhos de eval, não por calendário.
• GraphRAG. Síntese transversal sobre grafo de entidades, para o planejamento e o avançado.
• Multi-hop sobre o grafo ontológico. Navegação encadeada sintoma a intervenção como passos explícitos da ontologia.
• Política por reforço. O roteador deixa de ser determinístico e aprende a escolher a estratégia.
• Roteamento automático e agentes. O sistema reconhece a intenção e ativa o squad de agentes proativos.

Definição de pronto

Processo de eval

O eval é o que torna o caminho enxuto seguro. Ele mede a qualidade da recuperação e da resposta de forma contínua e, principalmente, por segmento. É o eval que diz quando um segmento parou de ser bem servido pelo índice único e virou candidato a partição.

As quatro etapas

As métricas que acompanhamos

Ferramentas

Gatilhos de quebra do RAG

A pergunta do caminho enxuto é como saber a hora de quebrar. A resposta: não se mede o tamanho do índice, mede-se a qualidade da recuperação por segmento. O tamanho é só o alarme antecipado, não o gatilho.

Os quatro sinais

Limiares pré-comprometidos

Os números abaixo são um ponto de partida para fixar com a equipe. O valor importa menos que o compromisso de decidir por dado, e não por impressão. Calibre na primeira leitura de produção.

Processo de quebra do RAG

Quando um gatilho dispara, a quebra é uma operação mecânica e incremental. Tira-se um segmento por vez do índice geral para um índice próprio, sempre o que está sofrendo, e repete-se quantas vezes os evals pedirem. Nada de redesenho de mesa.

O passo a passo de uma quebra

O que muda no roteador, em concreto

A mudança é uma entrada na tabela de roteamento, não uma reescrita. Antes, todo recorte aponta para o índice geral. Depois, o recorte partido aponta para a partição.

// Antes: um indice geral atende todos os recortes
{
  "default": "geral_aplicado"
}

// Depois da 1a quebra: o recorte de cafe vai para a particao
{
  "regras": [
    { "se": { "cultura": "cafe" }, "usa": "aplicado_cafe" }
  ],
  "default": "geral_aplicado"
}

// Depois da Na quebra: mais recortes, mesma estrutura
{
  "regras": [
    { "se": { "cultura": "cafe" }, "usa": "aplicado_cafe" },
    { "se": { "cultura": "soja" }, "usa": "aplicado_graos" }
  ],
  "default": "geral_aplicado"
}

O fan out continua valendo

Um perfil que cruza recortes, por exemplo ILPF com grãos e pecuária, depois da quebra consulta as duas partições mais o RAPTOR e sintetiza. É o mesmo fan out que antes combinava filtros dentro do índice único. A passagem de filtro para índice é invisível para a lógica de roteamento.