Visão Geral
O HPE/PCX Agent é um sistema para gerenciar potencial e performance humana no ecossistema CSuite.
Objetivo
Medir, intervir e melhorar a capacidade de entrega das pessoas, sem os problemas clássicos de sistemas de performance:
- ❌ Não ranqueia pessoas
- ❌ Não infere personalidade
- ❌ Não age irreversivelmente sem humano
P1 (Potencial) = AI × (SW + HW)
P2 (Performance) = P1 × M
Onde:
- AI = Auto-Imagem Operacional (agência, autoridade percebida)
- SW = Software (habilidades: KH, LP, LT, LMO, INI, PER, CVP)
- HW = Hardware (saúde, carga, infraestrutura)
- M = Motivação (contextual, não permanente)
Agentes Dedicados
| Agente |
Domínio |
Descrição |
| HPE Orchestrator |
CORE |
Coordenador central |
| AI Guardian |
AI |
Estabiliza agência e autoridade |
| HW Sentinel |
HW |
Protege throughput humano |
| CVP Watcher |
CVP |
Detecta desalinhamento de valores |
| M Coach |
M |
Re-significação contextual (futuro) |
API Endpoints
Core
| Método |
Endpoint |
Descrição |
GET |
/health |
Health check |
GET |
/info |
Informações do agente |
Events
| Método |
Endpoint |
Descrição |
POST |
/events |
Ingestão de evento |
GET |
/events |
Listar eventos com filtros |
Scores
| Método |
Endpoint |
Descrição |
GET |
/scores/p1/{person_id} |
Score P1 (Potencial) |
GET |
/scores/p2/{person_id} |
Score P2 (Performance) |
GET |
/scores/latest/{person_id} |
Últimos scores |
Radar
| Método |
Endpoint |
Descrição |
GET |
/radar/teams |
Radar de times (28 dias) |
GET |
/radar/at-risk |
Pessoas em risco |
Cases
| Método |
Endpoint |
Descrição |
GET |
/cases |
Casos de intervenção |
GET |
/cases/violations |
Violações abertas |
GET |
/cases/violations/{person_id} |
Violações por pessoa |
Agent Execution
| Método |
Endpoint |
Descrição |
POST |
/execute/all |
Executar todos os agentes |
POST |
/execute/ai-guardian |
Executar AI Guardian |
POST |
/execute/hw-sentinel |
Executar HW Sentinel |
POST |
/execute/cvp-watcher |
Executar CVP Watcher |
GET |
/execute/agents |
Listar agentes disponíveis |
Pipeline
| Método |
Endpoint |
Descrição |
POST |
/pipeline/daily-run |
Executar pipeline diário |
Exemplos de Uso
1. Executar Análise Completa
curl -X POST https://csuite.internut.com.br/hpm/execute/all \
-H "Content-Type: application/json" \
-d '{
"person_id": "abc123",
"ai_state": "fragile",
"hw_risk": "high",
"burnout_signal": true,
"signals": {
"ai_escalation_rate": 0.35,
"ai_open_loop_count": 8,
"hw_concurrent_load": 12
}
}'
2. Consultar Score P1
curl https://csuite.internut.com.br/hpm/scores/p1/abc123?snapshot_date=2026-02-01
3. Ver Radar de Times
curl https://csuite.internut.com.br/hpm/radar/teams
Gatilhos dos Agentes
AI Guardian
Ativa quando:
- ai_state = 'fragile'
- ai_escalation_rate > 30%
- ai_reversal_rate > 20%
- ai_open_loop_count > 5
HW Sentinel
Ativa quando:
- hw_risk = 'high'
- burnout_signal = true
- hw_concurrent_load > 8
- hw_overtime_hours > 15
- hw_infra_blockers > 3
CVP Watcher
Ativa quando:
- cvp_policy_violation_count >= 3
- cvp_conflict_escalation_count >= 2
- cvp_noncompliance_pattern >= 0.3
Regras de Governança
O Sistema PODE:
- ✅ Sugerir intervenções
- ✅ Abrir casos para humanos decidirem
- ✅ Bloquear nova carga (WIP cap) - HW Sentinel pode auto-executar em emergência
- ✅ Explicar cada decisão com rationale completo
O Sistema NÃO PODE:
- ❌ Rankear pessoas
- ❌ Inferir personalidade
- ❌ Classificar pessoas como "boas" ou "ruins"
- ❌ Acessar mensagens pessoais
- ❌ Agir irreversivelmente sem humano
Regra de Conflito
HW Sentinel pode sobrescrever M Coach. Nunca o contrário.
Se HW indica risco alto, não adianta motivar. Primeiro resolve o hardware.
Banco de Dados
- Schema:
csuite_hpm
- Host: vallery.catmgckfixum.sa-east-1.rds.amazonaws.com
Tabelas Principais
| Tabela |
Descrição |
hpm_person |
Colaboradores |
hpm_event |
Eventos observados |
hpm_signal |
Sinais derivados |
hpm_p1_snapshot |
Scores P1 diários |
hpm_p2_snapshot |
Scores P2 diários |
hpm_policy_violation |
Violações de política |
hpm_intervention_case |
Casos de intervenção |
hpm_agent_run |
Execuções de agentes |
hpm_agent_action |
Ações sugeridas |
Deploy
Local (Desenvolvimento)
cd c-suite/agents/hpe-pcx
./deploy.sh dev
Produção
Docker Compose
docker build -t hpe-pcx-agent:latest .
docker stack deploy -c docker-stack.yml hpe-pcx
Documentação Adicional
- Swagger UI: https://csuite.internut.com.br/hpm/docs
- ReDoc: https://csuite.internut.com.br/hpm/redoc
- OpenAPI JSON: https://csuite.internut.com.br/hpm/openapi.json
Versão
- Versão: 1.0.0
- Porta: 8061
- Stack: FastAPI + aiomysql + Pydantic v2