|
| 1 | +--- |
| 2 | +title: 'Subagents' |
| 3 | +description: 'AI-powered agents that investigate and analyze your workflows' |
| 4 | +icon: 'sparkles' |
| 5 | +--- |
| 6 | + |
| 7 | +<Info> |
| 8 | +**Subagents** is an Enterprise edition feature. See [pricing](https://www.openops.com/pricing/) for details. |
| 9 | +</Info> |
| 10 | + |
| 11 | +Subagents are specialized AI agents that run in isolated environments to handle complex, long-running analysis tasks on your behalf. Unlike the general-purpose AI assistant, each subagent is purpose-built for a specific domain and can work through large amounts of data autonomously before returning a structured result. |
| 12 | + |
| 13 | + |
| 14 | + |
| 15 | +## Investigation subagent |
| 16 | + |
| 17 | +The first available subagent is the **Investigation** agent. It analyzes workflow execution data to help you understand why a workflow run failed, behaved unexpectedly, or performed poorly. |
| 18 | + |
| 19 | +The investigation subagent can help you: |
| 20 | + |
| 21 | +- **Diagnose failures** — identify which step failed, why it failed, and what the error means. |
| 22 | +- **Trace unexpected behavior** — follow data through each step to explain why a workflow produced an unexpected result. |
| 23 | +- **Spot performance issues** — find bottlenecks or steps that took longer than expected. |
| 24 | + |
| 25 | +After completing its analysis, the agent streams a structured report with findings, and a root cause assessment. |
| 26 | + |
| 27 | +## Using the investigation subagent |
| 28 | + |
| 29 | +The investigation subagent is available as a tool inside the OpenOps AI chat interface. |
| 30 | + |
| 31 | +To start an investigation: |
| 32 | + |
| 33 | +1. Open the AI chat in your OpenOps environment. |
| 34 | +2. Describe the issue you want to investigate — for example: *"Why did this workflow fail?"* or *"The last run produced unexpected output in the final step, can you check what happened?"* |
| 35 | +3. Provide the **workflow run ID** you want to analyze. |
| 36 | +4. The agent runs in the background and streams progress updates as it works. When complete, it returns its findings directly in the chat. |
| 37 | + |
| 38 | +## How it works |
| 39 | + |
| 40 | +Subagents run in isolation from the rest of your environment, with no persistent storage and no access to external systems beyond the data they are given. |
| 41 | + |
| 42 | +## Enabling subagents for your environment |
| 43 | + |
| 44 | +To learn more or to enable subagents for your environment, contact your OpenOps account manager. |
0 commit comments