Skip to main content

Troubleshooting

Agent Actions provides actionable error messages and multiple debugging options.

Logging Levels​

Environment VariableLevelShows
(default)CRITICALOnly critical system errors
AGENT_ACTIONS_LOG_LEVEL=INFOINFOProgress and status updates
AGENT_ACTIONS_LOG_LEVEL=DEBUGDEBUGFull exception chains, context, and tracebacks

Debug Mode​

Set the AGENT_ACTIONS_LOG_LEVEL environment variable to see full error context:

AGENT_ACTIONS_LOG_LEVEL=DEBUG agac run -a my_workflow

Debug mode reveals:

  • Full exception chains showing where errors originated
  • Context information (file paths, action names, operations)
  • Complete Python tracebacks
tip

Redirect debug output to a file for complex issues: AGENT_ACTIONS_LOG_LEVEL=DEBUG agac run -a my_workflow > debug.log 2>&1

Environment Variables​

VariableDescription
ANTHROPIC_API_KEYAnthropic API key
OPENAI_API_KEYOpenAI API key
GEMINI_API_KEYGoogle Gemini API key
GROQ_API_KEYGroq API key
MISTRAL_API_KEYMistral API key
COHERE_API_KEYCohere API key

Exit Codes​

CodeMeaning
0Success
1General error
2Usage error (invalid arguments)
130Interrupted by user (Ctrl+C)

Debugging Process​

  1. Start with AGENT_ACTIONS_LOG_LEVEL=INFO to see execution flow
  2. Use AGENT_ACTIONS_LOG_LEVEL=DEBUG to investigate specific errors
  3. Check exception chains for root causes
  4. Review context information (file paths, action names, operations)

See Also​