Endpoints para CEO Agent - Implementação
📋 Status dos Endpoints
✅ Endpoints Implementados
1. Executive Dashboard (csuite-context)
Base URL: https://csuite.internut.com.br/context/api/executive/dashboard
| Endpoint | Status | Descrição |
|---|---|---|
GET /kpis |
✅ Implementado | KPIs consolidados do dashboard |
GET /inbox |
✅ Implementado | Inbox do dia por vendedor |
GET /daily-focus |
✅ Implementado | Foco diário de vendas |
GET /sellers |
✅ Implementado | Dados de vendedores (heatmap) |
GET /rupture |
✅ Implementado | Top 20 produtos em ruptura |
GET /lowturn |
✅ Implementado | Top 20 produtos com baixo giro |
GET /targets-status |
✅ Implementado | Status detalhado de metas |
Arquivo: csuite-context/approot/app/routers/executive_dashboard.py
Nota: O script do CEO Agent tenta múltiplas URLs:
- https://csuite.internut.com.br/api/executive/dashboard/* (via gateway)
- https://csuite.internut.com.br/context/api/executive/dashboard/* (direto)
2. Policy Engine (csuite-executive)
Base URL: https://csuite.internut.com.br/executive
| Endpoint | Status | Descrição |
|---|---|---|
POST /v1/policy/evaluate |
⚠️ A implementar | Avaliação de decisões (policy gate) |
GET /v1/policy/guardian/pending |
✅ Implementado | Casos pendentes do Policy Guardian |
Arquivo: csuite-executive/csuite-api/app/policy_engine/router.py
Nota: O endpoint /v1/policy/evaluate ainda retorna 404. O script usa fallback ESCALATE quando falha.
3. Cases API (csuite-executive)
Base URL: https://csuite.internut.com.br/executive
| Endpoint | Status | Descrição |
|---|---|---|
GET /v1/cases |
✅ Criado | Lista casos (alias para Policy Guardian) |
GET /v1/cases/{case_id} |
✅ Criado | Detalhes de um caso específico |
Arquivo: csuite-executive/csuite-api/app/routers/cases.py
Nota: Este endpoint é um alias para /v1/policy/guardian/pending para compatibilidade com o CEO Agent.
4. Memory API (csuite-executive)
Base URL: https://csuite.internut.com.br/executive
| Endpoint | Status | Descrição |
|---|---|---|
POST /v1/memory/query |
✅ Funcionando | Consulta conversacional à memória |
Arquivo: csuite-executive/csuite-api/app/routers/memory.py
Melhorias aplicadas:
- Busca em pg_case para casos recentes
- Busca em mm_item para precedentes
- Retorna fontes (sources) para rastreabilidade
- Fallback gracioso em caso de erro
🔧 Configuração do Script
O script do CEO Agent (workflows/scripts/ceo_agent_daily_brief.py) foi atualizado para:
- Tentar múltiplas URLs:
- Gateway:
https://csuite.internut.com.br/api/executive/dashboard/* -
Direto:
https://csuite.internut.com.br/context/api/executive/dashboard/* -
Usar endpoint correto de cases:
/v1/policy/guardian/pending(endpoint principal)-
/v1/cases(alias para compatibilidade) -
Melhor tratamento de erros:
- Logs como WARNING (não ERROR)
- Continua execução mesmo com alguns endpoints falhando
- Graceful degradation
📊 Testes
Testar Endpoints do Dashboard
# KPIs
curl "https://csuite.internut.com.br/context/api/executive/dashboard/kpis?org_id=0"
# Inbox
curl "https://csuite.internut.com.br/context/api/executive/dashboard/inbox?org_id=0"
# Daily Focus
curl "https://csuite.internut.com.br/context/api/executive/dashboard/daily-focus?org_id=0"
Testar Cases API
# Lista casos
curl "https://csuite.internut.com.br/executive/v1/cases?limit=10"
# Via Policy Guardian (endpoint original)
curl "https://csuite.internut.com.br/executive/v1/policy/guardian/pending?limit=10"
Testar Memory API
curl -X POST "https://csuite.internut.com.br/executive/v1/memory/query" \
-H "Content-Type: application/json" \
-d '{
"question": "CEO daily brief: risks, precedents, recurring violations",
"context": {"org_id": 0}
}'
🚀 Próximos Passos
Endpoints a Implementar
- Policy Engine
/v1/policy/evaluate - Status: ⚠️ Retorna 404
- Prioridade: Alta (policy gate do CEO Agent)
-
Arquivo:
csuite-executive/csuite-api/app/policy_engine/router.py -
Melhorias no Memory API
- Integração com LLM para respostas mais ricas
- Busca semântica em
mm_item -
Agregação de scores e trends
-
Roteamento do Gateway
- Verificar se
/api/executive/dashboard/*está roteando corretamente - Adicionar roteamento se necessário
📚 Documentação Relacionada
- CEO Agent:
docs/agent/CEO_AGENT.md - Guia de APIs Executive:
docs/guides/GUIA_USO_APIS_EXECUTIVE.md - Guia de APIs Context:
docs/guides/GUIA_USO_APIS_CONTEXT_EXECUTIVE.md - Notas de Endpoints:
workflows/scripts/NOTAS_ENDPOINTS.md
Última atualização: 2025-01-04