Troubleshooting¶

Common issues and solutions for ACGP implementations.

Common Issues¶

Minimal Tier Warnings¶

Problem: Warnings about missing features when using Minimal conformance

Context: Minimal conformance is designed for development and learning. You may see warnings about: - Limited intervention types (only OK/BLOCK) - No governance contracts - No trust system - No advanced ARS/CTQ evaluation

Solutions: - These warnings are expected for Minimal tier - For production systems, upgrade to Standard Conformance - Minimal tier is perfect for learning, development, and batch jobs - All features are optional - add them when needed

High Latency¶

Problem: Actions take too long to complete

Solutions: - Use lower ACL tier (ACL-0 or ACL-1) - Implement async evaluation - Check network latency to steward - Optimize trace size

Too Many Interventions¶

Problem: Agent is constantly blocked or escalated

Solutions: - Review and adjust blueprint policies - Check tripwire thresholds - Improve trace reasoning quality - Consider lowering ACL tier temporarily

Authentication Errors¶

Problem: Connection to steward fails

Solutions: - Verify API keys/certificates - Check network connectivity - Confirm steward endpoint URL - Review firewall rules

Trust Score Issues¶

Problem: Trust score not changing as expected

Solutions: - Check trust calculation configuration - Verify outcome recording - Review trust adjustment events - Check for trust decay settings

Getting Help¶

Still stuck?

Debug Mode¶

Enable debug logging for detailed troubleshooting:

steward = GovernanceSteward(
    acl_tier="ACL-2",
    debug=True,
    log_level="DEBUG"
)

More troubleshooting content coming soon