Troubleshooting

Common issues and solutions.

E01: Agent Not Authorized

Error: Agent lacks required role

Fix: Ensure agent has R-AA role and valid sponsor:

1
2
3
4
{
  "role": "R-AA",
  "sponsor": "R-DS:valid-sponsor"
}

E02: HITL Rejection

Error: HITL approval required but not granted

Fix: Ensure sponsor approves action, or mark skill as non-mutating.

E03: SoD Violation

Error: Self-approval not permitted

Fix: Different person must approve than proposed.

E04: Break-Glass Expired

Error: Break-glass window expired

Fix: Request renewal (max 2) or restore normal governance.

E05: A2A Connection Failed

Error: Cannot connect to external agent

Fix:

1. Check agent card at /.well-known/agent.json
2. Verify authentication scheme
3. Check network connectivity

Debug Commands

1
2
3
4
5
6
7
8
# Check agent config
GET /ai-agents/{id}/config

# View audit log
GET /governance/audit?agentId={id}

# Check break-glass status
GET /governance/break-glass/active

Last Updated: January 2026