Este guia acompanha o workshop Agentes de IA: Vigilancia Judicial en Cobro de Cartera, que fizemos com o Houston em 3 de setembro de 2026. Ele serve para você repetir tudo passo a passo, no seu ritmo.
Objetivo#
Vamos deixar funcionando um agente que recebe um Excel com seus radicados, revisa toda manhã todos os seus processos na Rama Judicial e manda um único e-mail: as movimentações novas primeiro, com a anotação literal do tribunal, e a situação do resto da carteira logo abaixo. Sem abrir o portal processo por processo.
Desta vez não é preciso construir nada: o agente já vem pronto. Você instala, responde a algumas perguntas e ele passa a monitorar sua carteira. Como construir um do zero ficou no guia do workshop anterior.
Passo 1: baixe o Houston#
- Entre em gethouston.ai/pt e clique em Baixar o app. Há versão para macOS, Windows e Linux. O plano gratuito é mais do que suficiente para este workshop.
- Preencha o formulário com seus dados e baixe o instalador.
- Abra o app, crie sua conta e siga o onboarding até chegar ao seu espaço de trabalho.
Passo 2: instale o agente#
Na barra lateral, abra a Loja de agentes e procure Vigilancia Judicial, o do capacete verde, criado por tomas croma. Abra a página do agente e clique em Experimente agora: o agente é instalado na sua conta com as três habilidades prontas, carregar a carteira, a varredura diária e o relatório diário.
Passo 3: configure conversando#
Abra um chat com o agente e diga oi. Ele mesmo vai pedindo o que precisa, nesta ordem:
1. O e-mail que vai receber o relatório#
Diga para qual endereço enviar o relatório diário. Pode ser o seu, o de um colega ou vários: cada destinatário recebe só os próprios processos.
2. Sua lista de processos#
Um Excel ou CSV com uma coluna de radicados, o número de 23 dígitos de cada processo, e, se quiser, um apelido para reconhecer cada um. Só isso.
É a lista que usamos no workshop: dez processos reais e ativos. Se preferir montá-la você mesmo, este é o conteúdo completo:
Radicado,Alias
08001418901720190035500,Pequenas causas Barranquilla
11001031500020180188500,Consejo de Estado Bogota
11001310302220090001300,Civil circuito J049 Bogota
11001310502420220028500,Laboral J024 Bogota
11001334205720220016301,Tribunal administrativo Bogota
11001400300520220092200,Ejecucion J002 Bogota
11001400301620090053100,Ejecucion J016 Bogota
11001400302020200002900,Ejecucion J020 Bogota
11001400305020260026400,Civil municipal J050 Bogota
11001400306920110102800,Civil municipal J069 BogotaUma dica: no Excel, deixe a coluna do radicado em formato de texto. Se o Excel tratar a coluna como número, ele transforma o radicado em algo como 5,0013E+22 e o agente não consegue ler.
Ao receber a lista, o agente valida cada radicado na Rama Judicial e resume o que encontrou: quais passam a ser monitorados, quais são privados e quais ainda não aparecem publicados. Se quiser os detalhes da fonte, o guia da Rama Judicial está na documentação.
3. Sua conta na Croma#
Os dados judiciais vêm da Croma. Crie sua conta:
É grátis. Com a conta criada, abra platform.usecroma.com/mcp e aceite os termos. Quando o agente pedir para conectar a Croma, faça login com essa conta e pronto: sem chaves nem configuração, e a mesma conexão abre mais de 70 fontes oficiais.
4. Seu e-mail conectado ao Houston#
Para enviar o relatório, o Houston precisa de permissão sobre o seu e-mail. Se ainda não tiver, vá em Integrações, conecte o Gmail ou o e-mail do seu espaço de trabalho e autorize.
5. A rotina#
Com a carteira carregada, o agente propõe deixar duas tarefas agendadas: a varredura toda manhã de dia útil, no horário da Colômbia, e o relatório logo em seguida. Aceite e, a partir daí, o monitoramento roda sozinho, sem que ninguém abra um chat. Você pode mudar o horário quando quiser, ou pedir uma varredura manual: revise a carteira agora.
A carteira também é administrada conversando: adicione este radicado, tire o de Barranquilla, mude o e-mail do trabalhista. O agente atualiza a lista e segue.
O que chega no seu e-mail#
Um único e-mail por dia. Quando há movimentação, o assunto já diz logo de cara, com o apelido do processo e o tipo de movimentação: Se movió Laboral J024 Bogota: Fijación estado. Dentro, vêm primeiro as movimentações novas, com o juízo, a data e a anotação literal do tribunal, e embaixo a situação do resto da carteira. Quando não há movimentação, o e-mail chega do mesmo jeito: Vigilancia al día, sin movimientos. É o sinal de que o monitoramento está vivo. E, se um processo não pôde ser verificado, ele diz isso com essas palavras: nunca confunde com "sem movimentação".
O que é a Croma#
A Croma é a API de dados de governo da América Latina: uma única conexão abre mais de 70 fontes oficiais, Rama Judicial, RUES, SECOP, Registraduría, SIMIT e muitas outras, todas no mesmo formato e com a data da consulta. É a mesma infraestrutura com que bancos e equipes jurídicas monitoram diariamente a atividade judicial das suas carteiras. Explore as fontes, teste as ferramentas ou leia a documentação.
O que é o Houston#
O Houston é um app de desktop open source onde pessoas e agentes de IA trabalham juntos, com agentes compartilhados que aprendem com a sua equipe. Cada agente tem sua memória, suas habilidades e suas integrações, e na Loja de agentes você instala os que outras pessoas já construíram, como o deste workshop. O guia para conectar a Croma a qualquer agente do Houston está em /mcp/houston.
Outros agentes que você pode criar#
A fórmula é a mesma: um agente do Houston mais as fontes da Croma. Algumas ideias:
- Análise de crédito: antes de aprovar, valide o solicitante no RUES, revise as demonstrações financeiras dele na Supersociedades e os processos na Rama Judicial.
- Alerta de insolvência: monitore no SICAAC se um devedor da carteira entra em um processo de insolvência.
- Multas e veículos: revise o SIMIT e o RUNT para a frota da empresa e avise sobre novas autuações.
- Contratação pública: receba um aviso quando uma entidade publicar no SECOP processos do seu setor, ou quando um contrato for adjudicado a um concorrente.
- Lead enrichment: cruze RUES e Supersociedades sobre uma lista de empresas. Montamos isso no workshop anterior e o guia está no blog.
Participe da comunidade#
Se você deixou o agente funcionando, conte para a gente como foi. A comunidade da Croma está no WhatsApp: lá compartilhamos agentes e skills, tiramos dúvidas e avisamos sobre os próximos workshops.