Debugging incidents

July 27, 2026 ยท View on GitHub

Start with safe evidence: workflow ID, task reference, status, retry count, and reasonForIncompletion. Confirm server reachability and authentication before changing application code.

SymptomFirst check
Connection errorCONDUCTOR_SERVER_URL includes /api and the server is healthy.
Task remains scheduledA worker polls the exact task type and domain.
Authentication failureCONDUCTOR_AUTH_KEY and CONDUCTOR_AUTH_SECRET target the active server.
Agent cannot call a modelThe provider credential is configured on the server.

Use WORKFLOW.md and agents/reference/client.md for the relevant inspection APIs.