PolarPOLAR

Análise Processual

API de análise processual Raio-X. Faça upload dos detalhes de um caso e receba análise completa com precedentes, perfil do magistrado e avaliação de risco.

Visão Geral

O Raio-X é a ferramenta de análise processual da Jurisia. Envie os detalhes de um caso jurídico e receba uma análise abrangente que inclui casos similares, precedentes relevantes, perfil do magistrado, avaliação de risco e teses jurídicas recomendadas. A análise é feita com RAG (Retrieval-Augmented Generation) sobre toda a base jurídica da Polar.

Endpoint

POST /v1/jurisia/analyze

Parâmetros

ParâmetroTipoObrigatórioDescrição
case_numberstringNãoNúmero do processo (formato CNJ)
descriptionstringSimDescrição detalhada do caso
areastringSimÁrea do direito (civil, penal, trabalhista, consumidor, tributario, etc.)
documentsarrayNãoLista de documentos anexos
documents[].namestringSimNome do documento
documents[].contentstringSimConteúdo textual do documento
documents[].typestringNãoTipo (peticao, sentenca, contrato, prova, outros)
tribunalstringNãoTribunal em que o caso tramita
judgestringNãoNome do magistrado responsável
rolestringNãoPosição do cliente (autor, reu, terceiro)
optionsobjectNãoOpções de análise
options.include_precedentsbooleanNãoIncluir precedentes (padrão: true)
options.include_judge_profilebooleanNãoIncluir perfil do juiz (padrão: true)
options.include_risk_assessmentbooleanNãoIncluir avaliação de risco (padrão: true)
options.max_similar_casesintegerNãoNúmero máximo de casos similares (padrão: 5)

Resposta

{
  "analysis_id": "anl_abc123",
  "status": "completed",
  "summary": "Caso de responsabilidade civil por danos morais em relação de consumo...",
  "risk_assessment": {
    "overall_risk": "medium",
    "success_probability": 0.72,
    "factors": [
      {
        "factor": "Jurisprudência favorável no STJ",
        "impact": "positive",
        "weight": 0.85
      },
      {
        "factor": "Falta de documentação comprobatória",
        "impact": "negative",
        "weight": 0.60
      }
    ]
  },
  "similar_cases": [
    {
      "case_number": "REsp 1.234.567/SP",
      "tribunal": "STJ",
      "similarity_score": 0.91,
      "outcome": "procedente",
      "summary": "Caso similar envolvendo...",
      "relevance": "Alta relevância por tratar de danos morais em relação consumerista"
    }
  ],
  "precedents": [
    {
      "reference": "Súmula 387/STJ",
      "content": "É lícita a cumulação das indenizações de dano estético e dano moral",
      "applicability": "Diretamente aplicável ao caso"
    }
  ],
  "judge_profile": {
    "name": "Dr. João Silva",
    "tribunal": "TJSP",
    "favorability_rate": 0.68,
    "avg_processing_days": 180,
    "tendencies": "Tendência a fixar indenizações moderadas em casos de consumo"
  },
  "recommended_strategies": [
    {
      "strategy": "Enfatizar jurisprudência do STJ sobre responsabilidade objetiva",
      "confidence": 0.85,
      "basis": "Art. 14 do CDC e precedentes do STJ"
    }
  ],
  "processing_time_ms": 4500
}

Exemplos

Análise Completa de um Caso

import requests

response = requests.post(
    "https://api.polarai.com.br/v1/jurisia/analyze",
    headers={"Authorization": "Bearer pk-sua-chave-aqui"},
    json={
        "description": """
            Cliente adquiriu produto eletrônico em loja online que apresentou
            defeito após 15 dias de uso. Procurou a loja que se recusou a
            realizar a troca ou devolução do valor. Cliente possui nota fiscal
            e registros de reclamação no SAC da empresa.
        """,
        "area": "consumidor",
        "tribunal": "TJSP",
        "role": "autor",
        "options": {
            "include_precedents": True,
            "include_judge_profile": True,
            "include_risk_assessment": True,
            "max_similar_cases": 10
        }
    }
)

analysis = response.json()

print(f"Probabilidade de êxito: {analysis['risk_assessment']['success_probability']:.0%}")
print(f"Risco geral: {analysis['risk_assessment']['overall_risk']}")
print(f"\nCasos similares encontrados: {len(analysis['similar_cases'])}")

for case in analysis["similar_cases"][:3]:
    print(f"  [{case['similarity_score']:.2f}] {case['case_number']}{case['outcome']}")

Análise com Documentos Anexos

response = requests.post(
    "https://api.polarai.com.br/v1/jurisia/analyze",
    headers={"Authorization": "Bearer pk-sua-chave-aqui"},
    json={
        "case_number": "1234567-89.2024.8.26.0100",
        "description": "Ação de indenização por danos morais e materiais",
        "area": "civil",
        "documents": [
            {
                "name": "petição inicial",
                "content": "Exmo. Sr. Dr. Juiz de Direito da Vara Cível...",
                "type": "peticao"
            },
            {
                "name": "contrato de prestação de serviços",
                "content": "CONTRATO DE PRESTAÇÃO DE SERVIÇOS que entre si...",
                "type": "contrato"
            }
        ],
        "judge": "Dr. Maria Santos",
        "role": "autor"
    }
)

Usando cURL

curl -X POST https://api.polarai.com.br/v1/jurisia/analyze \
  -H "Authorization: Bearer pk-sua-chave-aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Empregado demitido sem justa causa após 5 anos de serviço, sem pagamento de verbas rescisórias",
    "area": "trabalhista",
    "role": "autor",
    "options": {
      "max_similar_cases": 5
    }
  }'

Campos da Resposta

risk_assessment

CampoTipoDescrição
overall_riskstringNível de risco: low, medium, high
success_probabilityfloatProbabilidade de êxito (0.0 a 1.0)
factorsarrayFatores que influenciam o resultado

similar_cases

CampoTipoDescrição
case_numberstringNúmero do processo similar
tribunalstringTribunal de origem
similarity_scorefloatPontuação de similaridade (0.0 a 1.0)
outcomestringResultado: procedente, improcedente, parcialmente_procedente
summarystringResumo do caso

judge_profile

CampoTipoDescrição
namestringNome do magistrado
favorability_ratefloatTaxa de decisões favoráveis ao autor (0.0 a 1.0)
avg_processing_daysintegerTempo médio de processamento em dias
tendenciesstringTendências decisórias observadas

Limites

  • Tamanho máximo da description: 50.000 caracteres
  • Máximo de documentos: 10
  • Tamanho máximo por documento: 100.000 caracteres
  • Tempo máximo de processamento: 60 segundos

On this page