* 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 <chuvidi2003@gmail.com>
* Propagate orchestration ID (if any).
* Add integration test for orchestration ID in entity state.
* Update schema.
* Fixup formatting issues.
* Fix more formatting issues.
* draft commit
* Added Cosmos agent thread and tests
* revert unnecessary changes and fix tests
* add multi-tenant support with hierarchical partition keys (and tests).
* enhance transactional batch
* address review comments
* Address PR review comments from @westey-m
* Merge upstream/main - resolve slnx conflicts
* use param validation helpers
* Replace useManagedIdentity boolean with TokenCredential parameter
* Remove redundant suppressions and fix tests
* Rename project from Microsoft.Agents.AI.Abstractions.CosmosNoSql to Microsoft.Agents.AI.CosmosNoSql
* Refactor constructors to use chaining pattern
* Reorder deserialization constructor parameters for consistency
* Remove database/container IDs from serialized state
* Remove auto-generation of MessageId
* Optimize AddMessagesAsync to avoid enumeration when possible
* Add MaxMessagesToRetrieve to limit context window
* Make Role nullable instead of defaulting
* Fix net472 build without rebasing 19 commits
* Add Cosmos DB emulator to CI workflow
* Fix Cosmos DB emulator tests: use Skip.If instead of Assert.Fail and start emulator before unit tests
* Replace Skip.If() with conditional return to fix compilation
* Use env var to skip Cosmos tests on non-Windows CI
* Add Xunit.SkippableFact package to properly skip Cosmos tests on Linux
* Change [Fact] to [SkippableFact] for proper test skipping behavior
* Remove stale Microsoft.Agents.AI.Abstractions.CosmosNoSql directory
* Fix code formatting: add braces, this. qualifications, and final newlines
* Fix file encoding to UTF-8 with BOM, fix import ordering, and remove unnecessary using directives
* Convert backing fields to auto-properties and remove Azure.Identity using directive
* Fix CosmosChatMessageStore.cs encoding back to UTF-8 with BOM
* Fix test file formatting: indentation, encoding, imports, this. qualifications, naming conventions, and simplify new expressions
* Fix const field naming violations: Remove s_ prefix from const fields and add this. qualification to Dispose call
* Add local .editorconfig for Cosmos DB tests to suppress IDE0005 false positives from multi-targeting
* Fix IDE1006 naming violations: Rename TestDatabaseId to s_testDatabaseId and add final newlines
* Address PR review comments
Address Wesley's review comments:
- Remove Cosmos DB package references from core projects
- Delete duplicate test files from old package structure
- Remove redundant parameter validation from extension methods
Address Kiran's review comments:
- Remove redundant 429 retry logic (SDK handles automatically)
- Add explicit RequestEntityTooLarge error handling
- Remove dead code in GetMessageCountAsync
- Add defensive partition key validation comments
* Fix IDE0001 formatting error in AgentProviderExtensions.cs. Use type alias to resolve namespace conflict between Azure.AI.Agents.Persistent.RunStatus and Microsoft.Agents.AI.Workflows.RunStatus. This eliminates the need for global:: qualifier which triggered the formatter warning.
* Update package versions for Aspire 13.0.0 compatibility
* Fix TargetFrameworks in Cosmos DB projects
- Replace with which is defined in Directory.Build.props
- Fix package reference from System.Linq.Async to System.Linq.AsyncEnumerable to match Directory.Packages.props
* Remove redundant counter, add partition key validation, use factory pattern for deserialization
* Standardize orchestration outputs as list of chatmessage. Add chat options to group chat prompt manager
* refactor group chat
* Improve group chat manager
* README Update
* Cleanup
* Add comment
* More cleanup
* Standardize termination condition for group chat
* Improvements on termination logic
* Fix tests
* Fix new line
* PR feedback
* Update ChatKit based on OpenAI type change
* Raise error if response format is not expected type
* Only one starting executor required. Add tests.
* Add magentic start executor test
* WIP
* WIP
* Simple call working
* Update Thinking sample
* Non-Streaming Function calling working
* Update Anthropic Impl
* Public Preps
* UT + IT working
* Update documentation + samples
* Update variable
* Revert nuget.config
* Add IT for BetaService implementation
* Remove polyfill + enable IT to run for netstandard 2.0
* Skipping Anthropic IT's for manual execution and avoid pipeline execution
* Fix compilation error
* Address error in UT
* Apply suggestions from code review
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Fix warning
* Net 10 update
* Update for NET 10, remove Anthropic.Foundry due to vulnerability
* Final missing adjustments for NET 10
* Address PR comments
* Remove unused code
* Address feedback
---------
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* make tool call view optional in devui + other link fixes
* fix#2310, ensure correct port is shown in command
* fix dialog bug
* ensure executor ids are tracked per items, fix bug where data from concurrent executors where not seperated properly fix#2351
* fix: Enable multi-round human-in-the-loop (HIL) in DevUI workflows
- Backend: Enrich RequestInfoEvents with response schemas in send_responses_streaming path
- Frontend: Replace old HIL requests with new ones instead of accumulating them
- Frontend: Fix HIL response state management to prevent sending stale request responses
This allows workflows to properly handle sequential HIL requests, showing only the
current request to users and progressing through multiple input rounds correctly.
fixes#2334
* fix bug to ensure in memory entities cannot be reloaded in ui
* Upgrade to .NET 10
- Require .NET 10 SDK
- Include net10.0 assets in all assemblies
- Move net9.0-only targets to net10.0
- Update LangVersion to latest
- Remove complicated distinctions between debug target TFMs and release target TFMs
- Remove unnecessary package dependencies when built into netcoreapp
- Clean up some ifdefs
- Clean up some analyzer warnings
* Fix CI
* feat(mcp): add full _meta field support for CallToolResult objects
- Extract and preserve complete _meta field from MCP CallToolResult responses
- Merge metadata into additional_properties of converted content items
- Handle isError field for proper error state integration
- Support arbitrary metadata like token usage, costs, and performance metrics
- Maintain backward compatibility with existing tool execution workflows
- Add comprehensive test coverage for all metadata scenarios including edge cases
- Update documentation with metadata handling examples and patterns
Fixes protocol compliance violation where _meta fields were being dropped,
enables proper monitoring and cost tracking of MCP tool usage.
* Update python/packages/core/agent_framework/_mcp.py
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Clarify MCP _meta field test to use generic example metadata
- Updated test_mcp_call_tool_result_with_meta_arbitrary_data to use arbitrary metadata fields
- Added comments to emphasize that _meta structure is server-specific and not standardized
---------
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Python: Fix pyright errors and move search provider to core (#1546)
* address pablo coments
* update azure ai search pypi version to latest prev
* init update
* Fix MyPy type annotation errors in search provider
- Add type annotation to DEFAULT_CONTEXT_PROMPT
- Add type annotation to vectorizable_fields
- Add union type annotation to vector_queries
* Fix DEFAULT_CONTEXT_PROMPT MyPy error and update test
- Rename DEFAULT_CONTEXT_PROMPT to _DEFAULT_SEARCH_CONTEXT_PROMPT to avoid conflict with base class Final variable
- Update test to use new constant name
- All core package tests passing (1123 passed)
* Python: Move Azure AI Search to separate package per PR feedback
Addresses reviewer feedback from PR #1546 by isolating the beta dependency
(azure-search-documents==11.7.0b2) into a new agent-framework-aisearch package.
Changes:
- Created new agent-framework-aisearch package with complete structure
- Moved AzureAISearchContextProvider from core to aisearch package
- Added AzureAISearchSettings class for environment variable auto-loading
- Added support for direct API key string (auto-converts to AzureKeyCredential)
- Added azure_openai_api_key parameter for Knowledge Base authentication
- Updated embedding_function type to Callable[[str], Awaitable[list[float]]]
- Moved Role import to top-level imports
- Maintained lazy loading through agent_framework.azure module
- Removed beta dependency from core package
- Updated all tests to use new package location
- All quality checks pass: ruff format/lint, pyright, mypy (0 errors)
- All 21 unit tests pass with 59% coverage
Semantic search mode verified working with both API key and managed identity authentication.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Python: Clarify top_k parameter only applies to semantic mode
Updated documentation to clarify that the top_k parameter only affects
semantic search mode. In agentic mode, the server-side Knowledge Base
determines retrieval based on query complexity and reasoning effort.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
* Python: Add Knowledge Base output mode and retrieval reasoning effort parameters
Added support for configurable Knowledge Base behavior in agentic mode:
- knowledge_base_output_mode: "extractive_data" (default) or "answer_synthesis"
Some knowledge sources require answer_synthesis mode for proper functionality.
- retrieval_reasoning_effort: "minimal" (default), "medium", or "low"
Controls query planning complexity and multi-hop reasoning depth.
These parameters give users fine-grained control over Knowledge Base behavior
and enable support for knowledge sources that require answer synthesis.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
* effort and outputmode query params
* Address PR review feedback for Azure AI Search context provider
* comments eduward
* ed latest comments
---------
Co-authored-by: Farzad Sunavala <farzad.sunavala.enovate.ai>
Co-authored-by: farzad528 <farzad528@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>
* Add unit tests for create conversation executor
* Update indentation and comment typo.
* Added unit tests for declarative executor SetMultipleVariablesExecutor
* Updated comments and syntactic sugar
* Add unit test for declarative executor RetrieveConversationMessageExecutor
* Removed irrelevant code statements
* Updated based on copilot feedback.
Evan MattsonandGitHub
Laveesh RohraandGitHub
westeyandGitHub
Phillip HoffandGitHub
Theo van KraayandGitHub
Dmytro StrukandGitHub
Stephen ToubandGitHub
SergeyMenshykhandGitHub
Eduard van ValkenburgandGitHub
Giles OdigweandGitHub
Tomek SłomaandGitHub
Peter IbekweandGitHub
Korolev DmitryandGitHub
Tao ChenandGitHub
