Agente de Intake/Triagem

Como funciona a integração - primeiro agente do "NEW FLOW LEGAL" (Agno)

Advisory · read-only Agno v2 · OpenRouter Status: spec aprovada - ainda não implementado

Quando um caso entra no Legal com status "Coordinator Case setup", o agente lê o caso, classifica o tipo, aponta falhas de requisitos que o comercial precisa corrigir e sinaliza red flags - e entrega tudo como um relatório na tela do Coordinator. Ele não altera o caso: quem decide é a Coordinator/attorney.

O fluxo ponta a ponta

Já existe hoje (sem o agente)

1 · Comercial

HubSpot

lead criado pelo comercial

→

2 · Airtable

tabela LEAD

Financeiro revisa e aprova (pagamento)

→

3 · Automação AT

cria client + case

status "Coordinator Case setup"

↓

O que o agente adiciona

4 · Gatilho

Supabase → backend

case entra em "Coordinator Case setup" (via sync)

→

5 · Agno

POST /triage

lê cases + clients + leads + regras

→

6 · LLM

análise estruturada

tipo · gaps · red flags

→

7 · Supabase

case_intake_reports

relatório salvo

→

8 · Frontend

card "Triagem"

Coordinator Case Setup

🧭

Quem faz o quê: o backend orquestra (detecta o evento e chama o agente - mesmo padrão do NPS). O Agno é a inteligência (stateless: recebe o case_id, lê, analisa, devolve o relatório). A Coordinator lê o relatório e age.

O que o agente analisa

Classificação

🗂️ Tipo de caso

Sugere o tipo entre os existentes (O-1B, Asilo, EB1/EB2/EB3/EB5, U, VAWA, AOS, Family Based…) com um nível de confiança.

Completude

📋 Falhas de requisitos

Compara o caso com a lista de requisitos objetivos por tipo e aponta o que falta/está inválido - com a dica do que o comercial precisa corrigir.

Risco

🚩 Red flags & urgências

Sinaliza pontos sensíveis (ex.: prazos, histórico, inconsistências) com severidade baixa / média / alta e o motivo, para alerta antecipado.

Componentes técnicos

Peça	Onde	Papel
Agente `intake-triage`	yousa-agno (AgentOS)	Recebe `case_id`, lê o Supabase, roda o LLM com saída estruturada, grava o relatório. Exposto como `POST /triage`.
Orquestração	apps/backend	Detecta o case em "Coordinator Case setup" e chama o Agno. Guarda credenciais. Mesmo mecanismo de evento do NPS.
Config de regras	repo do Agno (versionada)	Requisitos objetivos + red flags por tipo de caso. Editável sem código. Conteúdo fornecido pela equipe.
`case_intake_reports`	Supabase	Persiste o relatório (tipo sugerido, gaps, red flags, status, modelo).
Card "Triagem"	apps/frontend · Coordinator Case Setup	Exibe o relatório mais recente do caso para a Coordinator.

Princípios & limites

Segurança

✋ Advisory, não age

O agente só produz um relatório. Não altera campos do caso, não escreve no HubSpot e não dispara mensagens. A decisão é humana.

Compliance

⚖️ COMP-04 / COMP-06

Relatório com o aviso "sujeito à revisão do advogado responsável". PII processada via OpenRouter (mesmo caminho do NPS); resultado fica no sistema, sem ferramentas externas.

Escopo

🚧 Fora deste passo

Write-back no HubSpot, notificações automáticas, preenchimento do tipo no caso, e os próximos agents (Comunicação/Kickoff) - viram specs próprias.

Decisões em aberto (a confirmar)

Gatilho: trigger no Supabase (análogo ao NPS) vs. polling no backend - assumido o trigger.
Config de regras: a lista oficial de requisitos + red flags por tipo de caso será fornecida pela equipe (o esqueleto + exemplo já fazem parte do plano).
HubSpot: fora do MVP - o agente lê o lead já sincronizado no Supabase.