Context Layer: o cérebro jurídico que abastece nossas IAs

1O que é, em uma frase

O Context Layer é uma biblioteca jurídica viva e organizada que entrega à inteligência artificial o trecho exato da lei certo para cada pergunta — sempre atualizado e com a fonte citada.

Tese por trás disso: hoje o modelo de IA é commodity (qualquer um tem acesso). O que diferencia a Horus é o contexto — a inteligência de dados jurídicos bem curada. É esse o nosso ativo.

2O problema que ele resolve

Uma IA sozinha, sem fonte, tende a inventar (o termo técnico é "alucinar"): cita um artigo que não existe, inventa número de processo, mistura leis. Para um produto jurídico, isso é inaceitável.

O Context Layer elimina isso com uma regra de ouro: a IA só pode responder com base nos trechos reais que a biblioteca entregou, e cada afirmação precisa apontar o artigo de onde saiu. Se a base não sustenta a resposta, a IA é obrigada a dizer isso — em vez de chutar.

3As 3 camadas (a biblioteca por dentro)

Por baixo, o Context Layer tem três partes que trabalham juntas:

4Como ele responde a uma pergunta

Quando o Estagiário (ou outro produto) recebe uma dúvida jurídica, acontece isto nos bastidores, em segundos:

1. Busca dupla na estanteProcuramos os trechos relevantes de dois jeitos ao mesmo tempo: por significado (a impressão digital matemática) e por palavra exata (número do artigo, termo técnico). Os dois resultados são combinados.
2. Um "juiz" reordena os melhoresUma segunda IA leve (o reranking) lê os ~20 melhores candidatos e os coloca em ordem de relevância para aquela pergunta. É como um revisor que separa "o que realmente responde" do "que só parece".
3. Resposta aterrada e com fonteA IA escreve a resposta usando apenas esses trechos, citando o artigo e copiando o texto literal. Proibido inventar. Se os trechos não bastam, ela avisa.
4. O uso vira memóriaA pergunta e a resposta são registradas. Se depois um advogado aceita ou corrige aquela resposta, esse retorno melhora a base — o sistema fica mais inteligente com o tempo.

5O loop diário que mantém tudo vivo

Todo dia, automaticamente (às 9h), o sistema roda um ciclo de 6 passos. É o que torna a base viva em vez de uma biblioteca empoeirada:

Esse desenho segue o "método Atlan": o dado não fica parado esperando ser consultado — ele vai atrás do time quando há algo importante.

6Como ele avisa o time (e os agentes)

No fim do dia, o sistema gera um resumo de inteligência e o entrega nos canais onde as pessoas e as IAs já trabalham:

7Como provamos que funciona

Não confiamos no "achismo": medimos. Todo dia rodamos uma prova com perguntas de gabarito (sabemos a resposta certa) e checamos se a busca encontra o artigo correto. A métrica principal é o recall — a % de vezes em que o artigo certo aparece entre os melhores resultados.

Acerto da busca, por área (medição real)

A meta interna era ~80%. Chegamos perto de 100% depois de descobrir e corrigir um problema de organização dos trechos — algo que só apareceu porque medimos. Sem a prova diária, o erro ficaria invisível.

8Quem usa o quê (mapa de conexões)

O Context Layer é uma base compartilhada no centro. À esquerda, quem pergunta (puxa contexto). À direita, quem recebe avisos (o sistema empurra). Cada seta mostra como a conexão é feita.

Resumindo: produtos da Horus (Estagiário, JurisLab) puxam contexto por uma porta HTTP interna; qualquer agente de IA de fora pluga pela tomada universal MCP; e os canais (painel, WhatsApp, Slack, e-mail) recebem os resumos e alertas que o sistema empurra todo dia.

9Como conectar a biblioteca em qualquer ferramenta (via MCP)

O MCP (Model Context Protocol) é um padrão universal — pense numa tomada/USB para inteligência artificial. Qualquer ferramenta compatível (Claude Desktop, Claude Code, Cursor, e outras) pode "plugar" no Context Layer e, na hora, ganhar a capacidade de consultar a base jurídica. Não precisa reprogramar nada: é só apontar a ferramenta para o nosso servidor MCP.

O que você ganha ao conectar

Depois de plugado, o agente passa a ter 3 ferramentas novas que ele usa sozinho quando precisa de Direito:

Como conectar — passo a passo

{
  "mcpServers": {
    "horus-context": {
      "command": "pnpm",
      "args": ["--filter", "@horus/context-mcp", "start"],
      "env": {
        "SUPABASE_URL": "https://awayzohsotdxleimgnef.supabase.co",
        "SUPABASE_SERVICE_ROLE_KEY": "<pedir ao time — fica no cofre>",
        "OPENAI_API_KEY": "<pedir ao time — fica no cofre>"
      }
    }
  }
}

// Em produtos próprios (web/app), em vez do MCP usa-se a porta HTTP interna (a Edge Function legal-rag-query), que já entrega a resposta pronta e aterrada. O MCP é o caminho para agentes e ferramentas de terceiros.

Em uma frase

Conectar = colar um bloco de configuração + 3 chaves → e qualquer agente de IA passa a "saber Direito" puxando da nossa biblioteca, com fonte citada.

10Glossário rápido (sem medo dos termos)

Corpus

O acervo de textos de lei organizado para a IA usar. Nossa "estante".

Chunk (trecho)

Um pedaço da lei — no nosso caso, geralmente um artigo inteiro.

Embedding (impressão digital)

A tradução do significado de um texto em números, para o computador buscar por sentido e não só por palavra.

RAG (busca + resposta aterrada)

O método de primeiro buscar os trechos reais e só então responder com base neles. É o que evita a IA inventar.

Reranking (o juiz)

Uma segunda passada que reordena os melhores trechos por relevância à pergunta, melhorando a precisão.

Recall (acerto)

A medida de qualidade: com que frequência o artigo certo aparece entre os melhores resultados.

Alucinação

Quando a IA inventa uma informação que parece verdadeira mas não é. O Context Layer existe para impedir isso.

MCP

Um "padrão de tomada" universal para conectar agentes de IA a fontes de dados — como uma USB para inteligência artificial.

Edge Function

Uma pequena porta de programa na nuvem que os produtos próprios chamam para obter a resposta jurídica pronta.

Sinal

Um aviso automático gerado pela base quando há algo a fazer (lei mudou, falta cobertura, qualidade caiu).