Utilizando Resumo Inteligente de Processo (IA) na API do Escavador – Suporte da API

O Resumo Inteligente de Processos é uma funcionalidade avançada da API V2 do Escavador que utiliza Inteligência Artificial para analisar o histórico processual e extrair os elementos essenciais de uma ação judicial.

Esta ferramenta é ideal para otimizar rotinas jurídicas e de compliance, transformando processos extensos em textos concisos e estruturados, permitindo uma compreensão rápida do status atual e dos próximos passos de um processo sem a necessidade de leitura manual integral*.

Assim, há ganho enorme de agilidade na tomada de decisão estratégica e redução drástica do esforço cognitivo necessário para analisar grandes volumes de informações jurídicas.

*Importante: Embora nosso modelo passe por sucessivos treinamentos e melhorias, sendo projetado para ser altamente preciso, existe sempre possibilidade de erros no conteúdo. Utilize as informações recebidas com cautela.

Fluxo de Utilização via API Escavador

O processo de obtenção de um resumo inteligente é composto por três etapas distintas:

Solicitação;
Acompanhamento do status; e
Recuperação do conteúdo.

Etapa 1: Solicitar a Geração (ou atualização) do Resumo

Para iniciar a análise por IA, você deve registrar uma solicitação de geração, caso ainda não exista nenhum resumo para o processo; ou de atualização, caso já exista um resumo anterior para o processo.

Recomenda-se, contudo, que antes da geração ou atualização do resumo o processo tenha sido atualizado recentemente para garantir garantir que a IA do Escavador considere os dados mais novos existentes no Tribunal - vide seguinte suporte da API sobre o tema: Como atualizar um processo pela API v2?

Endpoint: POST api/v2/processos/numero_cnj/{numero}/ia/resumo/solicitar-atualizacao
Parâmetro: O número do processo deve obrigatoriamente estar no formato CNJ (Ex: 0000000-00.0000.0.00.0000).
Resposta: Retorna um objeto com o id da solicitação e o status inicial PENDENTE.
Documentação: Solicita a geração/atualização do resumo inteligente de um processo.

Etapa 2: Consultar o Status da Solicitação

Como a geração do resumo é uma tarefa que exige processamento, o retorno não é imediato. Você deve consultar o status da solicitação informando o mesmo número de processo utilizado na etapa anterior, agora adicionando "status" ao final da rota.

Endpoint: GET api/v2/processos/numero_cnj/{numero}/ia/resumo/status
Parâmetro: Número do processo da etapa anterior, no formato CNJ (Ex: 0000000-00.0000.0.00.0000).
Possíveis Status:
- PENDENTE: O robô ainda está gerando o resumo.
- FINALIZADO: O resumo foi gerado com sucesso.
Resposta: Retorna um objeto com o id da solicitação, seu status atual, data e hora (timestamp) da criação (criado_em), numero_cnj do processo e, se aplicável, data e hora (timestamp) da conclusão da geração (concluido_em).
Documentação: Status da solicitação de resumo inteligente.

Etapa 3: Retornar o Resumo Inteligente

Após o status ser confirmado como FINALIZADO, você pode recuperar o conteúdo textual do resumo.

Endpoint: GET api/v2/processos/numero_cnj/{numero}/ia/resumo
Conteúdo do Retorno: Exibe o numero_cnj do processo resumido; a data e hora (timestamp) da última atualização (atualizado_em); o conteudo, que consiste no texto resumido com os elementos fundamentais do processo; e a estrutura qualidade_resumo, que relata os critérios de qualidade utilizados na elaboração do resumo (incluindo, ou não, movimentações, audiências, documentos do processo, estado de atualização do processo e estado de atualização do resumo).
Documentação: Retorna Resumo inteligente de um processo

Importante: caso não tenha sido solicitada a geração do resumo da etapa 1, é possível se deparar com um retorno do tipo "not found" (status http 404), informando que nenhum resumo inteligente foi gerado para o processo em questão. Um exemplo de retorno do tipo é o seguinte:

2. Diferenciais e Conteúdo do Resumo

O algoritmo do EscavAl (IA do Escavador) busca entregar uma visão 360° do processo, focando em:

Modelo proprietário e treinamento: O Escavador possui modelo de linguagem e treinamento próprio desses, otimizados para a compreensão de teses jurídicas aderentes ao Direito brasileiro.
Contextualização: Identificação das partes envolvidas, do objeto da lide (ex: ação trabalhista, dano moral, etc.) e das principais etapas dos procedimentos jurídicos.
Status Atual: Resumo das últimas movimentações relevantes, confrontado com a etapa processual respectiva.
Análise de Pedidos: Extração das solicitações feitas pelas partes e a situação de cada uma (procedente, improcedente ou pendente).

Relativo a