Message Formats¶
ACGP message format specifications and examples.
Cognitive Trace Message¶
{
"version": "1.0",
"trace_id": "trace-12345",
"agent_id": "agent-abc",
"timestamp": "2025-11-03T12:00:00Z",
"reasoning": "User requested password reset for verified email address",
"action": "send_password_reset_email",
"parameters": {
"email": "user@example.com",
"verification_method": "sms"
},
"context": {
"user_id": "user-123",
"session_id": "session-456",
"previous_attempts": 0
},
"metadata": {
"agent_version": "1.0.0",
"model": "gpt-4"
}
}
Evaluation Response Message¶
{
"version": "1.0",
"trace_id": "trace-12345",
"evaluation_id": "eval-67890",
"timestamp": "2025-11-03T12:00:01Z",
"intervention": "OK",
"message": "Action approved. Reasoning is clear and appropriate.",
"ctq_score": 0.95,
"trust_impact": 0.01,
"metadata": {
"evaluation_time_ms": 45,
"evaluator_version": "1.0.0"
}
}
Intervention Types¶
| Intervention | Code | Description |
|---|---|---|
| OK | OK |
Proceed without interruption |
| Nudge | NUDGE |
Suggestion to reconsider |
| Flag | FLAG |
Log for review |
| Escalate | ESCALATE |
Request human approval |
| Block | BLOCK |
Prevent action |
| Halt | HALT |
Stop agent |
See ACGP-1003: Messages for complete specification