Skip to content

Troubleshooting ​

Start with docker compose ps -a, run details and the relevant service logs.

SymptomCheck
Bot does not answerChannel membership, mention, include_ids, reconcile_from, token
Workflow fails to loadvalidate, YAML, string revision, overlapping routes
unknown_profileExact profile name, profile activity and account activity in Settings
validation_errorerror.details for the invalid field path
capacity_exhaustedActive work, pending sandbox cleanup and concurrency limit
sandbox_provision_timeoutAgentBox availability and worker logs. The initial provisioning deadline expires separately from the run timeout
sandbox_cleanup_pending / sandbox_provision_conflictCheck sandbox.error, worker logs and resources in AgentBox. An empty search does not prove absence. The execution slot stays occupied until deletion is confirmed. The sandbox state remains unavailable afterwards
Model authentication errorAccount authorization, API/worker access to its S3 store, and model access
File preparation errorMattermost access from AgentBox, Python and file size
Answer arrives without fileOutbox instructions, after_run errors and file limits
Web reports no accessORPHEUS_BROWSER_AUTH, SSO and public origin
Updates arrive lateReverse-proxy SSE buffering and connection state
SAML callback returns 401Signatures, ACS, time, AuthnStatement and metadata
Old model or tools usedSaved session configuration and workflow revision

Collect diagnostic context ​

Record the user action, time, session_id, run_id, error code and phase. Check whether a fresh test task reproduces the issue. Remove secrets and unnecessary user data before sharing logs.

Do not start by deleting the database or recreating every session. A publication failure does not mean the agent must repeat its work. First check whether the result already exists in the destination system.

States and phases · API errors