Agent Studio

BIBLIOTECA DE AGENTES · o front do Agno

Aqui se constrói e se testa o agente: prompt, skills, tools, subagentes e cenários de teste. O Studio não conhece caso, raia nem petição: quem amarra tipo de documento a agente é o sistema do lado do negócio. Um agente recebe um documento ou uma conversa, e devolve a resposta com um id de execução.

Como o modelo funciona, em três passos

Decidido na reunião de 27/08 com o Daniel. Não há roteador de I.A no meio do caminho: o documento já chega tipado, e o tipo diz qual agente atende.

1
Um agente por grupo?Certidões de nascimento, casamento e divórcio se conferem do mesmo jeito: um agente atende as três.
2
Uma skill por tipo de documento?O prompt do agente vale para o grupo inteiro. A skill traz o que é próprio de cada tipo.
3
Cenários de teste com gabarito?Casos reais que o time já julgou. Rodar antes de publicar é a boa prática combinada.

Onde estamos hoje

Precisa de atenção

🟡
Registro civil: a skill de Birth certificate mudou em 19/08 e ainda não rodouos cenários dessa skill estão desatualizados. Editado por Marcela S.
abrir a skill →
⚪
Identidade e status: sem dono definidoninguém assina a publicação deste agente
definir dono →
🟡
Credencial acad./prof.: é o caso que provavelmente precisa de subagenteso grupo não fecha só com prompt e tools. É o primeiro a testar na mão
ver o agente →
🔴
Mérito EB: grupo sem agente1.412 documentos continuam caindo na revisão manual
criar agente →

Biblioteca de agentes · todo agente daqui pode ser chamado por qualquer parte do sistema

O que não mora no Studio

Fica aqui · o agente
  • prompt do agente (validação geral do grupo)
  • skills (uma por tipo de documento)
  • tools
  • subagentes, quando o grupo precisa
  • cenários de teste e gabarito
  • trace de cada execução, com id
É o espelho do Agno. Só isso, e para todas as áreas da empresa, não só o jurídico.
Fica do lado do negócio · o processo
  • o vínculo tipo de documento → agente
  • as raias, que são processos de coleta
  • quais grupos cada caso coleta em cada raia
  • encadeamento entre documentos (um depende do outro)
  • prazos, donos e a petição
Quem chama o agente muda: intake, documento, tradução, agendador, SDR, financeiro. O Studio não sabe quem chamou, só devolve o id da execução.

Áreas da empresa

em breve
📈

Sales

SDR e transcrições comerciais. Vai usar os mesmos agentes comuns.

em breve
💰

Finance

NPS, cobrança e conciliação.

Atividade recente

Reunião com o Daniel: roteador removido, "família" vira grupo, "cartão" vira skill, e o Studio passa a ser isolado do negócio.
Marcela S. editou a skill de Birth certificate: passou a aceitar diferença de acento no nome.
Daniel publicou o Chat do caso. Publicação assinada e registrada.
Ana N. desligou a busca na web no agente de Registro civil: fonte não citável.

As palavras que valem a partir de 27/08

AgenteAtende um grupo de documentos. Tem prompt, skills, tools e, quando precisa, subagentes.
GrupoTipos de documento que se conferem do mesmo jeito. Substitui a palavra "família".
SkillA validação de um tipo de documento dentro do agente. Substitui a palavra "cartão".
ToolAção que o agente pode executar: consultar o dossiê, abrir tradução, chamar uma pessoa.
SubagenteQuando o grupo não fecha só com prompt e tools, o agente passa a chamar outros agentes.
Cenário de testeCaso real com gabarito. Substitui a palavra "placar".
TraceO registro de uma execução, com id, para o chamador amarrar do lado dele.
RaiaProcesso de coleta, do lado do negócio. Uma raia pode coletar vários grupos, e isso depende do caso.

Protótipo navegável · dados fictícios · estrutura decidida na reunião de 27/08: o Studio é o front do Agno, isolado do processo do escritório.

⚖️ Legal › Document Agents › Raia 1 › Registro civil › Birth certificate agente com subagentes ?
1 Entender o agente› 2 Ajustar prompt e skills› 3 Rodar os cenários› 4 Publicar A skill mudou depois do último teste. Recomendado rodar os cenários antes de publicar. Recomendado rodar os cenários de novo: o conjunto de subagentes mudou.
o que é este agentequem chama, o que entra, o que sai e quais recursos do AGNO ele usa
Esta aba responde: o que este agente é e quando ele entra em cena.

Comece por aqui quando você não sabe de onde saiu uma análise. Ela mostra qual grupo ele atende, o que recebe, o que devolve e o que ele tem permissão de usar. Nenhuma regra de conferência se muda aqui: isso é na aba Skills.

Especialista · Registro civil agente de grupo agent.legal.doc.raia1.registro_civil
perfil: validador de documento · modelo Claude Sonnet · estado: sandbox · versão v3
ATENDE ESTES DOCUMENTOS · vínculo fixo, gravado no banco
Birth certificateMarriage certificateDivorce certificateDeath certificate
O sistema descobre o agente pelo tipo do documento que chegou. O vínculo tipo → agente é dado, não adivinhação do LLM.
ENTRADA · O QUE ELE RECEBE
1 documento (os arquivos dele) o tipo do documento dados do caso (leitura)
Não recebe conversa nem o caso inteiro. Um documento por vez.
SAÍDA · O QUE ELE DEVOLVE
resultado: ok · com ressalva · rejeitado checagens com a prova campos lidos encaminhamento (a quem, por quê)
Formato fixo: é o que a tela do documento e o teste sabem ler.
PRECISA DE OUTRO DOCUMENTO PARA DECIDIR? · sem chamar outro agente
Ele não chama o agente do outro documento. Pede o arquivo por ferramenta, e a ferramenta só entrega os tipos que este agente tem permissão de olhar:
buscar arquivo do caso · tipos liberados: passaporte, forms, outras certidões
Exemplo: para conferir a filiação da certidão, ele busca o passaporte pela ferramenta. Quando um documento só existe por causa de outro e os dois precisam concordar, quem coordena isso é o lado do negócio, não o agente.
PODE ACIONAR ESTES AGENTES COMUNS · biblioteca compartilhada
Comparador de nomes e datasLeitor de documento (OCR)Tradutor assistido
Agentes comuns servem vários grupos. Um agente de grupo só aciona outro agente se estiver declarado como subagente.
RECURSOS DO AGNO NESTE AGENTE
Ferramentas6 liberadas neste agente
Base de conhecimentorequisitos legais (AILA) por consulta
Saída estruturadao formato fixo acima
Memóriadesligada: validador não precisa lembrar de conversa. Agente de chat precisa
Histórico de conversadesligado: cada documento é uma análise independente
Raciocínio estendidodesligado: encarece e aqui as checagens são objetivas
DE ONDE VÊM AS CHAMADAS · últimos 30 dias · rastreio
Caso A. Martins · EB1certidão de nascimento · filiação divergentefoi ao Specialist
Caso [Cliente] · I-130certidão de casamento · tudo conferidoaprovado
Caso [Cliente] · I-485certidão ilegível · pedido de reenviodevolvido ao cliente
Chegou aqui a partir de um documento que travou? É esta lista que fecha o caminho: da tela do documento você vem direto para este agente, e daqui volta para o caso.
v3editado por Marcela S. · 19/08o que mudou nesta skilldesfazervale só para este documento; as instruções são da família
Esta aba responde: o que a skill deste tipo de documento confere.

Cada tipo de documento tem uma skill dentro do agente. O que você muda aqui vale só para este tipo. A validação geral do grupo está no prompt do agente.

ACEITA
certidão de registro civil, cópia integralemitida por cartório/autoridade civilextrato/resumo: rejeitar
EXTRAI
nome completodata de nascimentolocalfiliaçãoautoridade emissoradata de emissão
CHECAGENS OBJETIVAS · o agente resolve sozinho
emissor oficial identificávellegível e completaidioma detectadoemissão recente se o consulado exigir
CRUZAMENTOS COM O DOSSIÊ · via consulta ao dossiê
filiação vs vínculo alegado na petiçãonome vs passaporte e formsdata de nascimento vs dossiê
TRADUÇÃO
regra: se não estiver em inglês abre o fluxo de tradução com prazo de 10 dias, automático
ESCALONA QUANDO · decisão humana
filiação não fecha com o vínculo → Specialistnome grafado diferente dos outros docs → Specialist
MENSAGEM DE REENVIO AO CLIENTE (PT · COMP-05)
v3 · em usovale para todo o grupo Registro civilhistóricocomparar versões
Esta aba responde: como este agente raciocina sobre o grupo inteiro.

É a validação geral, compartilhada por todos os tipos que ele atende. Regra que vale só para um tipo não entra aqui: vai na skill daquele tipo.

Instruções do especialista em Registro civil · certidões de nascimento, casamento, divórcio e óbito
As regras de cada tipo vêm da skill dele; aqui fica só o que vale para o grupo inteiro.
Seu papel: conferir a forma do documento, ler os campos e apontar qualquer
divergência contra o dossiê do caso. Você não decide mérito: quem decide é o time.
O que fazer, nesta ordem
1. Confira a qualidade do arquivo. Se estiver ilegível ou incompleto, pare aqui e
devolva ao cliente com a mensagem de reenvio da skill.
2. Leia os campos listados na skill (nome, filiação, datas, emissor).
3. Rode as checagens da skill. Para cada uma, diga se passou e onde está a prova (página).
4. Compare com o dossiê do caso. Nunca de memória: o que vale é o que está no sistema.
5. Documento em outro idioma e a skill exigir tradução: abra o fluxo de tradução.
6. Qualquer situação de escalonamento da skill: encaminhe a um humano com o achado pronto.
Regras que não se negociam
· Divergência de filiação ou de vínculo nunca é resolvida sozinha: sempre vai ao Specialist.
· A resposta sempre sai no formato padrão: resultado, checagens e as fontes de cada afirmação.
· O agente sugere; quem muda o estado do documento é uma pessoa ou uma regra objetiva.
· Dados pessoais não vão para registro interno: só o resumo.
Esta aba responde: ele decidiu igual ao time?

Cada teste roda o agente contra documentos reais que o time já julgou, com o motivo registrado. O que interessa não é a nota: é quantos ele aprovou por engano. Um só já reprova o teste.

✓ aprovadoTeste de hoje, 14:02 · 28 documentos já julgados pelo time
O agente julgou igual ao time em 26 dos 28. Resolveu 62% sem precisar de humano. Nenhum aprovado por engano · 2 devolvidos por excesso de rigor (o time tinha aceitado) · ver quais foram os 2 →
✗ reprovadoTeste de 18/08 · com a versão anterior da skill
1 aprovado por engano: aceitou um extrato como se fosse a certidão completa. Foi por isso que a v3 ganhou a regra "extrato/resumo: rejeitar".
O teste roda contra documentos reais que o time já julgou (com o motivo). Para ir a produção: nenhum aprovado por engano e pelo menos metade resolvida sem humano. Próximo passo combinado: trazer casos reais para o banco de teste e rodar de 10 a 40 execuções por agente, variando o documento (ilegível, incompleto, nome diferente), para ver onde ele quebra antes do cliente ver.
AGNOum agente é prompt + skills + tools. Quando isso não basta, ele passa a ter subagentes: continua sendo um agente só, mas por dentro ele chama outros.
Esta aba responde: por que este grupo precisa de mais de um agente.

Decisão de 27/08: não existe agente roteando documento. O documento chega tipado e o tipo já diz qual agente atende. O que existe é isto: um agente que, por dentro, chama outros quando a validação é complexa demais para um prompt só. Credencial é o primeiro candidato, e é o que vamos testar na mão.

POR QUE AQUI E NÃO NOS OUTROS
Na maioria dos grupos, o prompt do agente mais as skills por tipo resolvem. Aqui não: validar diploma estrangeiro envolve ler documento sujo, comparar grafias entre documentos e conferir a instituição emissora. Cada uma dessas coisas já é um agente que existe, e repetir a lógica dentro do prompt é o caminho de errar.
SUBAGENTES QUE ELE CHAMA · todos já existem na biblioteca
Leitor de documento (OCR)diploma e histórico costumam vir digitalizados tortosem produção
Comparador de nomes e dataso nome no diploma quase nunca é igual ao do passaporteem produção
Tradutor assistidotradução é obrigatória neste tipo, sem exceçãoem teste
Verificador de instituiçãoa instituição emissora existe e está reconhecidanão existe ainda
O QUE MUDA PARA QUEM CHAMA · nada
Quem chama continua mandando o documento e o tipo e recebendo uma resposta com um id. Ter subagentes por dentro é decisão do agente, não do chamador. É por isso que dá para começar sem subagente e adicionar depois, sem mexer no lado do negócio.
A DÚVIDA QUE FICOU EM ABERTO · testar na mão primeiro
Deixar 4 skills num agente só e confiar que ele escolhe a certa, ou quebrar em subagentes? Ninguém sabe ainda. O combinado foi levantar o sandbox, pegar um grupo enxuto e medir, em vez de decidir no papel.
+ Adicionar subagente: só da biblioteca. Um agente nunca cria outro agente; ele aponta para um que já existe e já foi testado.
v2 · em usoinstruções de coordenação · quem valida continua sendo o agente do grupohistóricocomparar versões
Esta aba responde: em que momento ele para e chama outro agente.

Isto não é roteamento de documento: o documento já chegou no agente certo. É o agente decidindo, no meio da própria análise, que precisa de ajuda especializada.

Coordenação do agente do grupo Credencial acadêmica e profissional
Você é o dono da análise. Os subagentes trabalham para você, e a resposta final é sua.
Quando chamar cada um
1. Leitor de documento: sempre, antes de qualquer coisa. Se a confiança de um campo
vier baixa, trate como não legível e devolva ao cliente. Não deduza.
2. Comparador de nomes e datas: quando o nome do diploma diferir do dossiê.
Diferença de acento ou de ordem de sobrenome não é divergência.
3. Tradutor assistido: sempre que o documento não estiver em inglês.
4. Verificador de instituição: quando a instituição não estiver na lista conhecida.
Regras da coordenação
· Chame um subagente por vez e use a resposta dele. Nunca chame todos por precaução.
· Subagente não decide sobre o documento: ele devolve um dado, e quem conclui é você.
· Se dois subagentes se contradisserem, escale a uma pessoa em vez de escolher.
· Registre no trace qual subagente foi chamado e o que ele devolveu.
O que NÃO é responsabilidade deste agente
· Encadear documentos no tempo (diploma hoje, avaliação em 20 dias): isso é do
lado do negócio, não do agente. Aqui só existe uma execução, começo e fim.
Esta aba responde: o agente decidiu igual ao time, e chamou quem precisava?

Aqui o cenário mede duas coisas: o resultado e o caminho. Um agente que acerta o resultado chamando quatro subagentes desnecessários passa no primeiro e reprova no segundo, porque custa caro e demora.

✓ aprovado14 cenários com diploma estrangeiro
Resultado igual ao do time em 13 de 14. Pegou 2 divergências de grau que hoje passariam direto. Chamou em média 2,1 subagentes por execução, dentro do esperado.
✗ reprovadoPrimeira versão, sem subagentes
Com as 4 validações dentro de um prompt só, ele ignorou a conferência de instituição em 6 dos 14. Foi esse resultado que justificou quebrar em subagentes. É exatamente o teste que o Daniel pediu para fazer na mão antes de decidir.
Todo cenário guarda o gabarito (o que o time decidiu na época) e o trace (o que o agente fez). Rodar os cenários antes de publicar é a boa prática combinada em 27/08: o sistema avisa, mas não trava.
Esta aba responde: o que aconteceu em cada execução deste agente.

Toda chamada gera um id de execução. O Studio guarda o que entrou, o que o agente fez (inclusive qual subagente chamou) e o que saiu. Quem chamou guarda esse id do lado dele, e é assim que os dois lados se conversam sem o Studio precisar saber o que é um caso.

Esta aba responde: onde este agente entra numa execução.

O documento chega já tipado e uma tabela do lado do negócio diz qual agente atende. Não há I.A escolhendo rota. O agente usa a skill daquele tipo, as tools que tem liberadas e, se o grupo precisar, subagentes. No fim devolve uma resposta com um id de execução, e quem chamou decide o que fazer com ela.

entradaregra do sistema, sem I.Aagentesubagentepessoa⤢ ajustar à tela / 100%
Este agente não sabe de caso, de raia nem de petição, e não sabe quem o chamou. Encadeamento entre documentos (um que só existe por causa do outro) é do lado do negócio, não daqui. O que volta é sempre a mesma coisa: resultado, checagens com a prova, e o id da execução.
Esta aba responde: quem chama quem numa execução.

Repare que não há agente decidindo a rota: o documento chega tipado e uma tabela do lado do negócio diz qual agente atende. Quem chama subagente é o próprio agente, já dentro da análise, e a conclusão continua sendo dele.

entradaregra do sistema, sem I.Aagentesubagentepessoa⤢ ajustar à tela / 100%
Três dos quatro subagentes já existem na biblioteca e são usados por outros agentes também. Ter subagentes é invisível para quem chama: continua sendo mandar documento e tipo, e receber uma resposta com id.
🧪 ÚLTIMO TESTE clique para expandir
julgou igual ao time 26/28resolveu sem humano 62%aprovado por engano 0devolvido por excesso de rigor 2
📄 Exemplo do teste: Certidão de nascimento · [Cliente] o agente encaminharia ao Specialist
✓ Emitida por cartório oficial, legível e completa
✓ Nome e data de nascimento conferem com o dossiê
⚠ A filiação no documento não confere com o vínculo alegado na petição (pág. 1)
Próximo passo sugerido: encaminhar ao Specialist com esse achado. Nada foi enviado ao cliente.
ver como o sistema registra (técnico)
membro certo 28/28ponta a ponta igual ao time 26/28tempo médio 8,4s2 agentes por documento
📄 Exemplo do teste: Certidão de nascimento · [Cliente] rota completa em 8,1s
1O sistema resolveu tipo → agente por tabela: grupo Registro civil (sem I.A)
2Chamou o agente Registro civil com o arquivo, o tipo e o dossiê
3O especialista rodou 4 checagens: 3 passaram, 1 falhou (filiação não confere, pág. 1)
4Encaminhou ao Specialist com o achado pronto · nada foi ao cliente
ver como o sistema registra (técnico)
AMBIENTE DE TESTE · nada daqui chega ao cliente modelo: Claude Sonnet grupo Registro civil · 3 skillsagente Credencial · 4 subagentes (3 prontos) base de teste: 28 docs julgados pelo timecenários: 14 casos com diploma estrangeiro cenários: sem aprovado por engano ✓ · metade resolvida sozinha ✓cenários: resultado 13/14 ✓ · 2,1 subagentes por execução ✓