From 6c624319dbfbdb3a9aa020dd606f5b25409309c3 Mon Sep 17 00:00:00 2001 From: Hayato Kishikawa Date: Wed, 26 Nov 2025 14:13:15 -1000 Subject: [PATCH] Python: docs: Update Python orchestration documentation (#2087) * docs: Update Python orchestration documentation Remove outdated 'coming soon' statements for GroupChat, Sequential, and Concurrent orchestrations in core package README and transparency FAQ. Add links to existing samples in python/samples/getting_started/workflows/orchestration/. Note: python/README.md was already updated in PR #1914 (2499262f). Fixes documentation inconsistency found in Issue #1899. * Address review feedback: make TRANSPARENCY_FAQ language-neutral Remove Python-specific sample links from TRANSPARENCY_FAQ.md as it should pertain to all MAF languages (Python and .NET), not strictly Python. The python/packages/core/README.md retains the specific sample links as that is Python-specific documentation. * Update Learn documentation link in README --------- Co-authored-by: kishikawa-hayato <84244732+HerBest-max@users.noreply.github.com> Co-authored-by: Victor Dibia --- TRANSPARENCY_FAQ.md | 2 +- python/packages/core/README.md | 7 +++++-- 2 files changed, 6 insertions(+), 3 deletions(-) diff --git a/TRANSPARENCY_FAQ.md b/TRANSPARENCY_FAQ.md index 8fc8c23aec..3a09f191eb 100644 --- a/TRANSPARENCY_FAQ.md +++ b/TRANSPARENCY_FAQ.md @@ -44,7 +44,7 @@ Microsoft Agent Framework relies on existing LLMs. Using the framework retains c - **Platform Requirements**: Python 3.10+ required, specific .NET versions (.NET 8.0, 9.0, 10.0, netstandard2.0, net472) - **API Dependencies**: Requires proper configuration of LLM provider keys and endpoints -- **Orchestration Features**: Advanced orchestration patterns like GroupChat, Sequential, and Concurrent orchestrations are "coming soon" for Python implementation +- **Orchestration Features**: Advanced orchestration patterns including GroupChat, Sequential, and Concurrent workflows are now available in both Python and .NET implementations. See the respective language documentation for examples. - **Privacy and Data Protection**: The framework allows for human participation in conversations between agents. It is important to ensure that user data and conversations are protected and that developers use appropriate measures to safeguard privacy. - **Accountability and Transparency**: The framework involves multiple agents conversing and collaborating, it is important to establish clear accountability and transparency mechanisms. Users should be able to understand and trace the decision-making process of the agents involved in order to ensure accountability and address any potential issues or biases. - **Security & unintended consequences**: The use of multi-agent conversations and automation in complex tasks may have unintended consequences. Especially, allowing agents to make changes in external environments through tool calls or function execution could pose significant risks. Developers should carefully consider the potential risks and ensure that appropriate safeguards are in place to prevent harm or negative outcomes, including keeping a human in the loop for decision making. diff --git a/python/packages/core/README.md b/python/packages/core/README.md index 80cf6b4068..4113eca061 100644 --- a/python/packages/core/README.md +++ b/python/packages/core/README.md @@ -213,7 +213,10 @@ if __name__ == "__main__": asyncio.run(main()) ``` -**Note**: Advanced orchestration patterns like GroupChat, Sequential, and Concurrent orchestrations are coming soon. +**Note**: GroupChat, Sequential, and Concurrent orchestrations are available today. See examples in: +- [python/samples/getting_started/workflows/orchestration/](https://github.com/microsoft/agent-framework/tree/main/python/samples/getting_started/workflows/orchestration) +- [group_chat_simple_selector.py](https://github.com/microsoft/agent-framework/blob/main/python/samples/getting_started/workflows/orchestration/group_chat_simple_selector.py) +- [group_chat_prompt_based_manager.py](https://github.com/microsoft/agent-framework/blob/main/python/samples/getting_started/workflows/orchestration/group_chat_prompt_based_manager.py) ## More Examples & Samples @@ -228,4 +231,4 @@ if __name__ == "__main__": - [Python Package Documentation](https://github.com/microsoft/agent-framework/tree/main/python) - [.NET Package Documentation](https://github.com/microsoft/agent-framework/tree/main/dotnet) - [Design Documents](https://github.com/microsoft/agent-framework/tree/main/docs/design) -- Learn docs are coming soon. +- [Learn Documentation](https://learn.microsoft.com/en-us/agent-framework/user-guide/workflows/orchestrations/overview)