| # ⚖️ Para.AI — Documentação Técnica |
|
|
| **Para.AI Assuntos Jurídicos API** — busca full-text sobre **5.184 assuntos jurídicos** |
| do CNJ indexados em Elasticsearch 8.12 com analyzer específico para o português jurídico. |
|
|
| --- |
|
|
| ## 🚀 Quick Start |
|
|
| ```bash |
| curl "https://caarleexx-para-ai-assuntos.hf.space/busca?q=dano+moral&size=3" |
| |
| curl -X POST "https://caarleexx-para-ai-assuntos.hf.space/busca-q" \ |
| -d '{"q":"benefício deficiência","retornar":["titulo","introducao","normas"],"topk":3}' |
| ``` |
|
|
| --- |
|
|
| ## 📡 Endpoints |
|
|
| | Endpoint | Método | p50 | Descrição | |
| |----------|--------|-----|-----------| |
| | [/busca](/busca?q=aposentadoria) | GET/POST | ~800ms | Full-text + filtros + facets | |
| | [/busca-q](/docs#/Busca) | GET/POST | ~74ms | Estruturada para LLMs | |
| | [/autocomplete](/autocomplete?q=furto) | GET | ~45ms | Sugestões por prefixo | |
| | [/hierarquia](/hierarquia) | GET | ~250ms | Árvore 22 ramos | |
| | [/grafo/filhos](/grafo/filhos?ancestor=DIREITO+PENAL) | GET | ~100ms | Drill-down | |
| | [/assuntos/{id}](/docs#/Assuntos) | GET | ~20ms | Documento por ID | |
| | [/health](/health) | GET | ~10ms | Status ES | |
|
|
| [Swagger UI](/docs) · [ReDoc](/redoc) |
|
|
| --- |
|
|
| ## 📚 Documentos |
|
|
| | Arquivo | Público | Conteúdo | |
| |---------|---------|---------| |
| | [README](README) | Todos | Deploy HF Spaces + Docker | |
| | [INFO](INFO) | Usuários | O que é, casos de uso | |
| | [DEV](DEV) | Devs | Stack, estrutura, env vars | |
| | [MODELCARD](MODELCARD) | LLM devs | Tool calling OpenAI/Anthropic | |
| | [FLUXOGRAMA](FLUXOGRAMA) | Devs | Fluxo de dados por endpoint | |
| | [ROADMAP](ROADMAP) | Todos | v1.0 → v2.0 (2027) | |
| | [fixes](fixes) | Devs | Diário de bordo, FIX #1 | |
|
|
| --- |
|
|
| *Para.AI · v1.0.0 · MIT · CNJ dados públicos* |
|
|
