# Um agente para monitorar sua carteira de processos judiciais

**Publicado:** 3 de setembro de 2026 | **Autores:** Tomás Calle

---

Este guia acompanha o workshop *Agentes de IA: Vigilancia Judicial en Cobro de Cartera*, que fizemos com o [Houston](https://gethouston.ai/pt/) 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](/blog/lab10-lead-enrichment-skill).

## Passo 1: baixe o Houston

1. Entre em [gethouston.ai/pt](https://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.
2. Preencha o formulário com seus dados e baixe o instalador.
3. 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.

![A página do agente Vigilancia Judicial na Loja de agentes do Houston](/blog/houston-vigilancia-judicial/agente-vigilancia-judicial.png)

## 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.

[Baixe portafolio-demo.csv](https://usecroma.com/blog/houston-vigilancia-judicial/portafolio-demo.csv)

É a lista que usamos no workshop: dez processos reais e ativos. Se preferir montá-la você mesmo, este é o conteúdo completo:

```csv
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 Bogota
```

Uma 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](https://docs.usecroma.com/pt/guides/colombia/rama-judicial).

### 3. Sua conta na Croma

Os dados judiciais vêm da Croma. Crie sua conta:

[Criar minha conta na Croma](https://platform.usecroma.com/sign-up "cta")

É grátis. Com a conta criada, abra [platform.usecroma.com/mcp](https://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](/co/fuentes), 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](/co/fuentes), teste [as ferramentas](/co/tools) ou leia [a documentação](https://docs.usecroma.com/pt).

## 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](https://agents.gethouston.ai) 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](/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](/blog/lab10-lead-enrichment-skill).

## 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.

[Entrar na comunidade da Croma](https://chat.whatsapp.com/KjvKXdPgbhm2mYqymm8aEp?mode=gi_t "cta")

---

**Mais artigos:** [Ver todos os artigos do blog](/pt/blog/sitemap.md) | [Croma](https://usecroma.com)
