Skip to content

Commit 04ff769

Browse files
authored
Merge pull request #14334 from v-stsavell/14218
Pipeline: [NEW] AI Agent Design Pattern guide
2 parents 09b01c5 + 1d41006 commit 04ff769

19 files changed

+515
-5
lines changed

docs/ai-ml/architecture/baseline-azure-ai-foundry-chat-content.md

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -151,6 +151,26 @@ Dynamic agent management increases flexibility but also introduces the burden of
151151

152152
Choose the agent approach that aligns with your workload's user experience requirements.
153153

154+
#### Single-agent or multi-agent orchestration
155+
156+
**Current approach:** This reference architecture uses a single agent that has access to all necessary knowledge sources and tools to handle most user interactions effectively.
157+
158+
**Alternative approach:** You can orchestrate multiple specialized agents, where each agent focuses on specific domains, uses different models, or accesses distinct knowledge stores and tools.
159+
160+
Consider a multi-agent approach when your workload exhibits the following characteristics:
161+
162+
- Requests span multiple expertise areas, such as financial analysis, legal review, and technical implementation. Specialized agents provide deeper, more accurate responses within their respective domains.
163+
164+
- Information requires different permission levels. An HR agent might access employee data, while a customer service agent accesses only product information. Multi-agent architectures enable granular security boundaries at the agent level.
165+
166+
- Different query interactions benefit from different models. A lightweight model handles simple questions, while a more powerful model processes complex reasoning tasks. This approach optimizes both cost and latency.
167+
168+
- The chat experience serves as a front end to business processes that involve sequential or parallel steps that require different specialists.
169+
170+
Multi-agent approaches introduce coordination complexity and increased latency because of communication between agents. Use a single agent when your use case is well-defined, doesn't require strict access isolation, and can be handled effectively by one model with a reasonable set of tools.
171+
172+
For guidance about how to implement multiple coordinated agents, see [AI agent orchestration patterns](../guide/ai-agent-design-patterns.md). This article covers sequential, concurrent, group chat, handoff, and magentic orchestration approaches. You can implement some patterns within Foundry Agent Service. Other patterns require self-hosted orchestration by using an SDK such as Semantic Kernel.
173+
154174
## Considerations
155175

156176
These considerations implement the pillars of the Azure Well-Architected Framework, which is a set of guiding tenets that you can use to improve the quality of a workload. For more information, see [Microsoft Azure Well-Architected Framework](/azure/well-architected/).
@@ -612,6 +632,6 @@ Other contributors:
612632
## Related resources
613633

614634
- An Azure Well-Architected Framework perspective on [AI workloads on Azure](/azure/well-architected/ai/get-started)
615-
- [Azure OpenAI](https://azure.microsoft.com/products/ai-services/openai-service)
616635
- [Azure OpenAI models](/azure/ai-services/openai/concepts/models)
617636
- [Content filtering](/azure/ai-services/openai/concepts/content-filter)
637+
- [AI agent orchestration patterns](/azure/architecture/ai-ml/guide/ai-agent-design-patterns)

docs/ai-ml/guide/_images/concurrent-pattern-example.svg

Lines changed: 1 addition & 0 deletions
Loading

docs/ai-ml/guide/_images/concurrent-pattern.svg

Lines changed: 1 addition & 0 deletions
Loading

docs/ai-ml/guide/_images/group-chat-pattern-example.svg

Lines changed: 1 addition & 0 deletions
Loading

docs/ai-ml/guide/_images/group-chat-pattern.svg

Lines changed: 1 addition & 0 deletions
Loading

docs/ai-ml/guide/_images/handoff-pattern-example.svg

Lines changed: 1 addition & 0 deletions
Loading

docs/ai-ml/guide/_images/handoff-pattern-sample.svg

Lines changed: 1 addition & 0 deletions
Loading

docs/ai-ml/guide/_images/handoff-pattern.svg

Lines changed: 1 addition & 0 deletions
Loading

docs/ai-ml/guide/_images/magentic-pattern-example.svg

Lines changed: 1 addition & 0 deletions
Loading

docs/ai-ml/guide/_images/magentic-pattern.svg

Lines changed: 1 addition & 0 deletions
Loading

0 commit comments

Comments
 (0)