# AI_ISSUE_FAIL: Issue AI agent failed

- Module: AI. AI-assisted classifiers and content tools
- Severity: Error
- Impact: Operators. Organisation staff should take a look. Customers are not affected.
- Retry: Manual. Safe for an operator to retry the action.
- Reference: https://docs.bizkithub.com/en/system-codes/AI_ISSUE_FAIL

## What happened

The AI issue-resolving agent could not complete its background analysis. The issue itself is unaffected; retriggering the workflow will attempt the analysis again.

## Likely causes

- The AI provider returned an error or timed out during the background analysis of an issue.
- The agent could not finish because of an internal error while gathering issue context.

## How to resolve

1. Open the issue in admin and retrigger the AI workflow.
2. If failures persist across issues, check the AI provider configuration in Settings and the AI budget of the organisation.

## Related codes

- AI_ISSUE_OK: Issue AI agent produced an analysis
- AI_ORCH_FAIL: Issue orchestrator run failed
- TRIAGE_AI_FAIL: Issue triage classifier failed
- AI_BYOK_FALLBACK: Organisation AI key failed, shared key used
- AI_ISSUE_BRANCH: AI branch classification of an issue failed
- AI_ISSUE_TAG: AI skipped an issue tag proposal
