The complete pattern library for agent orchestration on OCI: Sequential, Concurrent, Group Chat, Handoff, Orchestrator-Worker, and Human-in-the-Loop. Decision criteria, OCI service mapping, and when to use each pattern.

TL;DR: Not all agent workflows are equal. This pattern library maps six orchestration patterns to OCI services, with explicit decision criteria for each. Match your workflow requirements to the right pattern before you write a single line of code.
Most teams pick an orchestration pattern based on what they saw in a tutorial, not what their workflow actually requires.
This leads to:
The solution: Pattern-first design. Understand your workflow characteristics, then select the pattern that fits.
Definition: Chains agents in a predefined linear order. Each agent processes the output from the previous agent, creating a pipeline of specialized transformations.
| Use When | Avoid When |
|---|---|
| Stages have clear linear dependencies | Stages can be parallelized |
| Each stage adds specific value for the next | Single agent can handle the full task |
| Workflow progression is predictable | Workflow requires backtracking |
| Performance of each stage is well-understood | Agents need to collaborate dynamically |
| Component | OCI Service | Configuration |
|---|---|---|
| Runtime | OCI AI Agent Platform | Workflow definition with sequential steps |
| State | Autonomous JSON DB | Document state accumulates across stages |
| Orchestration | OKE + LangGraph | StateGraph with linear edges |
| Monitoring | OCI APM | Trace spans for each stage |
Definition: Runs multiple agents simultaneously on the same task. Each agent provides independent analysis from its unique perspective. Results are aggregated for final output.
| Use When | Avoid When |
|---|---|
| Tasks can run in parallel | Agents need to build on each other's work |
| Multiple perspectives improve quality | Deterministic, reproducible results required |
| Time-sensitive scenarios | Resource constraints limit parallelization |
| Brainstorming, ensemble decisions | Conflict resolution logic is too complex |
| Component | OCI Service | Configuration |
|---|---|---|
| Runtime | OKE with parallel pods | Each agent in separate pod |
| Orchestration | LangGraph parallel nodes | parallel_branch construct |
| Aggregation | OCI Functions | Weighted voting, consensus logic |
| Monitoring | OCI APM | Parallel span tracking |
Definition: Multiple agents solve problems through shared conversation threads. A chat manager coordinates flow, determining which agents respond and when.
| Use When | Avoid When |
|---|---|
| Creative brainstorming with multiple perspectives | Simple task delegation suffices |
| Iterative refinement through discussion | Real-time processing required |
| Quality control with maker-checker loops | Clear hierarchical decision-making |
| Multidisciplinary problems | Chat manager can't determine completion |
| Component | OCI Service | Configuration |
|---|---|---|
| Runtime | OCI AI Agent Platform | Multi-agent conversation |
| Chat Manager | OCI Functions | Turn selection logic |
| Message Store | Autonomous JSON DB | Conversation history |
| Monitoring | Logging Analytics | Full conversation audit |
A common group chat pattern where one agent creates and another validates:
Definition: Enables dynamic delegation between specialized agents. Each agent assesses whether to handle the task directly or transfer to a more appropriate agent based on context.
| Use When | Avoid When |
|---|---|
| Specialized knowledge required dynamically | Appropriate agent known upfront |
| Expertise requirements emerge during processing | Simple rule-based routing suffices |
| Multiple domains but one at a time | Multiple agents needed concurrently |
| Logical signals indicate capability limits | Risk of infinite handoff loops |
| Component | OCI Service | Configuration |
|---|---|---|
| Runtime | OCI AI Agent Platform | Agent-to-agent routing |
| Router | OCI Functions | Handoff decision logic |
| State | Autonomous JSON DB | Conversation context persists |
| Escalation | Oracle Digital Assistant | Human handoff integration |
Definition: A manager agent dynamically builds a task ledger with goals and subgoals, invoking specialized worker agents as needed. The plan evolves as context changes.
| Use When | Avoid When |
|---|---|
| Complex problems without predetermined solution | Solution path is deterministic |
| Multiple specialists needed to develop valid plan | No requirement for documented plan |
| Plan review required before/after implementation | Time-sensitive (pattern focuses on planning) |
| Agents interact with external systems | Low complexity where simpler patterns suffice |
| Component | OCI Service | Configuration |
|---|---|---|
| Orchestrator | LangGraph on OKE | Dynamic subgraph spawning |
| Task Ledger | Autonomous JSON DB | Real-time plan updates |
| Workers | OCI AI Agent Platform | Specialized agents with tools |
| Tools | MCP Servers on OKE | External system integration |
| Audit | OCI Audit + Logging | Complete decision trail |
Definition: Explicit breakpoints where human approval is required before the workflow continues. Critical for high-stakes decisions.
| Use When | Avoid When |
|---|---|
| High-stakes decisions (financial, legal, medical) | All decisions can be automated |
| Compliance requires human approval | Approval latency is unacceptable |
| Building trust in AI system | Volume makes human review impossible |
| Training data collection | Clear rules can replace judgment |
| Component | OCI Service | Configuration |
|---|---|---|
| Approval UI | OCI APEX | Approval queue with context |
| State Persistence | Autonomous JSON DB | Workflow paused state |
| Notifications | OCI Notifications | Slack, email, SMS alerts |
| Timeout | OCI Events + Functions | Auto-escalate on timeout |
| Audit | OCI Audit | All approval decisions logged |
Quick reference for pattern selection:
| Pattern | Primary OCI Service | Supporting Services |
|---|---|---|
| Sequential | AI Agent Platform | Autonomous DB, Object Storage |
| Concurrent | OKE + LangGraph | Functions, APM |
| Group Chat | AI Agent Platform | Logging Analytics, JSON DB |
| Handoff | AI Agent Platform | Digital Assistant, Functions |
| Orchestrator-Worker | LangGraph on OKE | Agent Platform, Audit |
| Human-in-Loop | APEX + Agent Platform | Notifications, Events |
Part 3: The Operating Model — Evaluation pipelines, CI/CD for AI, incident response, cost management, and the 5-tier maturity roadmap.
This is Part 2 of a 3-part series on production LLM and agentic AI systems on OCI.
Part 1: Six-Plane Architecture | Part 3: Operating Model
Read on FrankX.AI — AI Architecture, Music & Creator Intelligence
Join 1,000+ creators and architects receiving weekly field notes on AI systems, production patterns, and builder strategy.
No spam. Unsubscribe anytime.