# AI_ORCH_FAIL: Issue orchestrator run failed

- Module: AI. AI-assisted classifiers and content tools
- Severity: Warning
- Impact: Operators. Organisation staff should take a look. Customers are not affected.
- Retry: Automatic. The platform retries or self-heals on its own.
- Reference: https://docs.bizkithub.com/en/system-codes/AI_ORCH_FAIL

## What happened

The AI issue orchestrator crashed or returned a failure during a run; the agent run record holds the error detail. The issue itself is unaffected because the orchestrator does not change comments, status or priority, so the only loss is the knowledge-base research pass. Investigate if the failure keeps repeating for one organisation.

## Likely causes

- The AI issue orchestrator run ended with an error, for example a provider failure or timeout.
- An internal error occurred while loading the issue context before the agent run started.

## How to resolve

1. No action is required for the issue itself; its comments, status, and priority are not changed by the orchestrator.
2. Review the run in AI agent runs in admin to see the error and tool-call trace.
3. If failures repeat for one organisation, check its AI provider configuration and AI budget.

## Related codes

- AI_ISSUE_FAIL: Issue AI agent failed
- AI_SCOPE_LEAK: Reporter-scoped tool attempted cross-contact access
- AI_PI_DETECTED: Prompt-injection patterns detected in agent input
- AI_BYOK_FALLBACK: Organisation AI key failed, shared key used
- AI_ISSUE_TAGBOOT: AI issue tag catalogue bootstrap failed
- AI_ROUTE_FAIL: AI routing failed
