agent-framework

Python: Add sample on how to share a thread between agents in a workflow (#3405 )

* Add sample on how to share a thread between agents in a workflow

* Fix sample

* Fix formatting

* Comments

* comment

Tao Chen · 2026-01-30 18:07:58 +00:00

0fcf075ea7

Python: Add coverage threshold gate for PR checks (#3392 ) (#3510 )

* Python: Add coverage threshold gate for PR checks (#3392)

- Add python-check-coverage.py script to enforce coverage threshold on specific modules
- Modify python-test-coverage.yml to run coverage check after tests
- Initial enforced module: agent_framework_azure_ai at 85% threshold
- Other modules are reported for visibility but don't block merges

* Fail if module not found

* Force unit test job to run

* Comment 1

* Fix coverage check to use full package paths for submodule support

* Update report format

Tao Chen · 2026-01-29 23:58:52 +00:00

0a0de4ac21

Python: added generic types to ChatOptions and ChatResponse/AgentResponse for Response Format (#3305 )

* added generic types to ChatOptions and ChatResponse/AgentResponse for response format

* fix typevar import

* fix for older python versions

* fix missing import

* fixed imports

* fixed mypy

* mypy fix

Eduard van Valkenburg · 2026-01-28 21:23:02 +00:00

1226828ec2

.NET: Python: [BREAKING] Renamed Github to GitHub (#3486 )

* Renamed Github to GitHub

* Small fix

* Updated package versions

Dmytro Struk · 2026-01-28 19:58:31 +00:00

45a020be43

Python: [BREAKING] changed AIFunction to FunctionTool and @ai_function to @tool (#3413 )

* changed AIFunction to FunctionTool and @ai_function to @tool

* test and mypy fixes

* mypy fix

* switch function tool to always_require

* fix noop

* fix github copilot imports

* test fixes

* fix ollama test

* fixes for tests

* fix tests

* reverted change to always_require and extended timeout

* fix test

Eduard van Valkenburg · 2026-01-28 14:53:53 +00:00

a7d924a7d2

Python: Add BaseAgent implementation for GitHub Copilot SDK (#3404 )

* Added GithubCopilotAgent

* Fixed errors

* Updated examples

* Updated naming and tests

* Resolved comments and more tests

* Updated tool handling

* Updated tool handling

* Small fixes

* Removed default permission handler

* Resolved comments

* Updated positional args

* Updated docstrings

* Small fixes and more examples

* Added example with MCP

Dmytro Struk · 2026-01-26 18:09:04 +00:00

407fb3025e

Python: add(azure-ai): support reasoning config for AzureAIClient (#3403 )

* add(azure-ai): support reasoning config for AzureAIClient

* Update sample

* Merge main

* improvements

* improve sample

Evan Mattson · 2026-01-23 09:37:23 +00:00

7b8777d1fc

Python: Azure AI mapping HostedImageGenerationTool to ImageGenTool (#3263 )

* azureai image gen sample fix

* mypy fixes

* addressed comments + mapping updates

* image model fix

* content type fix

Giles Odigwe · 2026-01-23 06:11:16 +00:00

a97bc322ac

Python: Fix local MCP tools with AzureAIProjectAgentProvider (#3315 )

* azureai v2 local mcp fix

* addressed copilot comments

Giles Odigwe · 2026-01-21 12:43:05 +00:00

88e0ee1a2c

Python: [Breaking] Simplified Content types to a single class with classmethod constructors. (#3252 )

* ported Content to a new model

* fixed linting

* fixes

* fixed data format handling

* fix for 3.10 mypy

* fix

* fix int test

Eduard van Valkenburg · 2026-01-20 22:09:39 +00:00

83e6229c11

Python: [BREAKING] Make response_format validation errors visible to users (#3274 )

* Make response_format validation errors visible to users

* Small fix

* Addressed comments

Dmytro Struk · 2026-01-19 17:20:46 +00:00

83e8965c8e

Python: Filter conversation_id when passing kwargs to agent as tool (#3266 )

* Filter conversation_id when passing kwargs to agent as tool

* Small fix

* Update python/samples/getting_started/agents/azure_ai/README.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update python/samples/getting_started/agents/openai/openai_responses_client_with_agent_as_tool.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update python/samples/getting_started/agents/azure_ai/azure_ai_with_agent_as_tool.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Dmytro Struk · 2026-01-19 12:54:06 +00:00

3243652df6

Python: Added rai_config to Azure AI agent creation (#3265 )

* Add kwargs to create_agent method

* Added test for kwargs

* Addressed comment

* Added doc string

Dmytro Struk · 2026-01-19 12:51:27 +00:00

915df3b404

Python: [BREAKING] Renamed create_agent to as_agent (#3249 )

* Renamed create_agent to as_agent

* Override for as_agent

* Added override

Dmytro Struk · 2026-01-16 19:21:52 +00:00

5687e13221

Create/Get Agent API - fixes and example improvements (#3246 )

Dmytro Struk · 2026-01-16 04:36:34 +00:00

b773830e4b

Python: Create/Get Agent API for OpenAI Assistants (#3208 )

* Added provider implementation

* Added example with response format

* Small improvements

Dmytro Struk · 2026-01-15 22:52:32 +00:00

b5ca0c8eda

Python: Create/Get Agent API for Azure V1 (#3192 )

* Added provider implementation for Azure AI V1

* Small fixes

* Fixed OpenAPI example

* Fixed local MCP example

* Fixed hosted MCP example

* Fixed file search sample

* Small fixes

* Resolved comments

* Doc updates

Dmytro Struk · 2026-01-15 22:19:03 +00:00

48d124efbe

Python: Properly configure structured outputs based on new options dict (#3213 )

* Properly configure structured outputs based on new options dict

* Fix mypy

Evan Mattson · 2026-01-15 11:41:46 +09:00

15d0c34d9f

Python: Added AzureAI sample for downloading code interpreter generated files (#3189 )

* added azure ai code interpreter file download sample

* copilot fix suggestions

* function name fixes + readme update

* small fix

Giles Odigwe · 2026-01-14 22:50:07 +00:00

9b9a0f178c

Python: Create/Get Agent API for Azure V2 (#3059 )

* Added get_agent method to Azure AI V2

* Small fixes

* Small fix

* Removed AzureAIAgentProvider

* Added create_agent method

* Small fixes

* Fixed code interpreter tool mapping

* Added agent provider for V2 client

* Updated response format handling

* Added provider example

* Fixed errors

* Update python/samples/getting_started/agents/azure_ai/README.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Small fix

* Updates from merge

* Resolved comments

* Resolved comments

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Dmytro Struk · 2026-01-14 19:35:01 +00:00

99c5718696

renamed all (#3207 )

Eduard van Valkenburg · 2026-01-14 05:54:07 +00:00

d8cf8361bd

Python: [BREAKING]: Introducing Options as TypedDict and Generic (#3140 )

* WIP typeddict for options

* updated all clients and ChatAgents

* updated everything

* added ADR

* fix mypy

* proper typevar imports

* fixed import

* fixed other imports

* slight update in the sample

* updated from feedback

* fixes

* fixed missing covariants and test fixes

* fixed typing

* updated anthropic thinking config

* ruff fixes

* fixed int tests

* fix tests and mypy

* updated integration tests

* updated docstring and test fix

* improved options handling in obser

* mypy fix

* updated a host of integration tests

* fix tests

* bedrock fix

Eduard van Valkenburg · 2026-01-13 16:41:05 +00:00

3e97425245

Python: [BREAKING]: removed display_name, renamed context_providers, middleware and AggregateContextProvider (#3139 )

* removed display_name, renamed context_providers, middleware and AggregateContextProvider

* fixes

* fixed test

* testfix

* removed mistakenly put back test

* updated new test

* rename middlewares to middleware

* middleware fixes

Eduard van Valkenburg · 2026-01-13 02:24:07 +00:00

203fb7b1c4

azureai direct a2a endpoint support (#3127 )

Giles Odigwe · 2026-01-12 22:03:04 +00:00

ef44fb4960

Fix Ollama model env var in documentation (#3156 )

Signed-off-by: Dina Suehiro Jones <dina.s.jones@intel.com>

Dina Suehiro Jones · 2026-01-12 14:15:49 +00:00

3a5fe31263

Python: Add tool call/result content types and update connectors and samples (#2971 )

* Add new AI content types and image tool support

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Add Python content types for tool calls/results and image generation tool support

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Address review feedback for tool content and samples

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Tighten image generation typing and sample tools list

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Align image generation output typing

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Handle MCP naming, image options mapping, and connector tool content

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Allow MCP call in function approval request

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Remove raw image_generation tool remapping

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Restore Anthropic tool_use to function calls unless code execution

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Fix lint issues for hosted file docstring and MCP parsing

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Import ChatResponse types in Anthropic client

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Fix Anthropics citation type imports and MCP typing for handoff/tools

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Skip lightning tests without agentlightning and fix function call import

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* fix lint on lab package

* rebuilt anthropic parsing

* redid anthropic parsing

* typo

* updated parsing and added missing docstrings

* fix tests

* mypy fixes

* second mypy fix

* add new class to other samples

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>
Co-authored-by: eavanvalkenburg <github@vanvalkenburg.eu>

Copilot · 2026-01-08 19:46:32 +00:00

3f7ea350dc

sharepoint sample fix (#3108 )

Giles Odigwe · 2026-01-06 22:57:54 +00:00

ea370f8ff6

Python: Preserve reasoning blocks with OpenRouter (#2950 )

* Preserve reasoning blocks with OpenRouter

* Put encrypted reasoning in TextReasoningContent

* Remove unneccessary change

* Fix docs

* Support streaming

* Fix handling None in TextReasoningContent.text

SuperKenVery · 2025-12-19 17:03:19 +00:00

85d70f01f6

Python: Move ollama samples to samples getting started dir (#2921 )

* Move ollama samples to samples getting started dir

* Address feedback

Evan Mattson · 2025-12-18 08:37:05 +00:00

ca1532cf22

Python: Azure AI Agent with Bing Grounding Citations Sample (#2892 )

* bing grounding sample with citations

* small fix

* fix

Giles Odigwe · 2025-12-17 00:43:38 +00:00

d5527982b6

Python : Ollama Connector for Agent Framework (#1104 )

* Initial Commit for Olama Connector

* Added Olama Sample

* Add Sample & Fixed Open Telemetry

* Fixed Spelling from Olama to Ollama

* remove"opentelemetry-semantic-conventions-ai ~=0.4.13" since its handled in a different pr

* Added Tool Calling

* Finalizing test cases

* Adjust samples to be more reliable

* Update python/packages/ollama/agent_framework_ollama/_chat_client.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update python/packages/ollama/pyproject.toml

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update python/packages/ollama/tests/test_ollama_chat_client.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update python/packages/ollama/agent_framework_ollama/_chat_client.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Improved Docstrings & Sample

* Update python/packages/ollama/agent_framework_ollama/_chat_client.py

Co-authored-by: Eduard van Valkenburg <eavanvalkenburg@users.noreply.github.com>

* Integrate PR Feedback
- Divided Streaming and Non-Streaming into independent Methods
- Catch Ollama Validation Error
- Add OTEL Provider Name
- Checked Ollama Messages
- Add Usage Statistics

* Revert setting, so it can be none

* Validate Message formatting between AF and Ollama

* Catch Ollama Error and raise a ServiceResponse Error

* Fix mypy error

* remove .vscode comma

* Add Reasoning support & adjust to new structure

* Add Ollama Multimodality and Reasoning

* Add test cases for reasoning

* Add Tests for Error Handling in Ollama Client

* Update python/samples/getting_started/multimodal_input/ollama_chat_multimodal.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Integrated Copilot Feedback

* Implement first PR Feedback

* Adjust Readme files for examples

* Adjust argument passing via additional chat options

* Implemented PR Feedback

* Removing Ollama Package from Core and moving samples

* Fix Link & Adding Samples to Main Sample Readme

* Fixing Links in Readme

* Moved Multimodal and Chat Example

* Fixed Link in ChatClient to Ollama

* Fix AgentFramework Links in Ollama Project

* Fix observability breaking change

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Eduard van Valkenburg <eavanvalkenburg@users.noreply.github.com>

Nico Möller · 2025-12-16 15:02:38 +00:00

2f06fe557a

Capture file IDs from code interpreter in streaming responses (#2741 )

Evan Mattson · 2025-12-11 07:30:19 +00:00

3481914981

azureai image gen sample update (#2709 )

Giles Odigwe · 2025-12-09 13:50:04 +00:00

b55095f0fb

Renamed async_credential to credential (#2648 )

Dmytro Struk · 2025-12-08 01:21:18 +00:00

cfcb71334a

Python: Added Azure OpenAI Responses File Search sample + Integration test update (#2645 )

* added azure responses file search sample + int test update

* sample update to use token credential

Giles Odigwe · 2025-12-05 19:01:48 +00:00

f5f909f2e2

Python: AzureAI Local MCP Sample (#2616 )

* added azure ai local mcp sample

* small fix

* handling for local mcp

* remove redundant local mcp handling

Giles Odigwe · 2025-12-04 19:10:00 +00:00

365e438981

Python: Added support for application endpoints in Azure AI client (#2460 )

* Added support for application endpoints in Azure AI client

* Fixed tests

* Update python/samples/getting_started/agents/azure_ai/azure_ai_with_application_endpoint.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Addressed comments

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Dmytro Struk · 2025-11-25 19:32:55 +00:00

5d8be5836c

Python: [BREAKING] Removed default "store" value (#2443 )

* Removed default store value

* Small fix

Dmytro Struk · 2025-11-25 17:53:08 +00:00

b8260ae24c

Python: Fix runtime response format for responses client (#2440 )

* Fix runtime response format for responses client

* Handle run time schema for Azure AI Client.

Evan Mattson · 2025-11-25 07:50:20 +00:00

2a4802eac3

Python: AzureAI OpenAPI + Memory Search Samples (#2390 )

* openapi + memory search samples

* readme update

* memory store name fix

Giles Odigwe · 2025-11-25 01:17:14 +00:00

e303cc963d

Python: renamed ai search and cleanup of samples and unified import logic (#2369 )

* renamed ai search and cleanup of samples and unified import logic

* fixed error messages

* fixed folder name

* remove old samples from readme

Eduard van Valkenburg · 2025-11-24 17:06:22 +00:00

9f43108ef1

a2a sample update (#2391 )

Giles Odigwe · 2025-11-24 10:57:00 +00:00

ec08ee541d

Python: Integration tests for Azure AI client and fixes in samples (#2387 )

* Added integration tests

* Update python/packages/azure-ai/tests/test_azure_ai_client.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Small fixes in samples

* Small fix

* Small fix

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Dmytro Struk · 2025-11-22 00:31:57 +00:00

ee8936d514

Python: feat(mcp): add full _meta field support for CallToolResult objects (#2286 )

* 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>

Bryan Ostdiek · 2025-11-21 08:43:24 +00:00

d18ce24bf8

Sample to show passing in JSON schema for structured outputs (#2362 )

Evan Mattson · 2025-11-21 01:42:46 +00:00

5bdf8a774a

Python: Feature/azure ai search agentic rag (search as separate package) (#2328 )

* 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>

Farzad Sunavala · 2025-11-20 22:34:46 +00:00

04e711cd55

Python: Clean up imports (#2318 )

* chore: tidy imports

* Update python/packages/azurefunctions/agent_framework_azurefunctions/_errors.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update python/packages/azurefunctions/agent_framework_azurefunctions/_callbacks.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* chore: revert stub file change

* chore: trigger pre-commit hook, re-add `annotations` import

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Brandon McConnell · 2025-11-19 23:41:01 +00:00

79bb87061b

Python: Added Foundry Sample for A2A + SharePoint Samples (#2313 )

* a2a + sharepoint samples

* small fixes

Giles Odigwe · 2025-11-19 11:13:47 +00:00

d5165e2532

Python: Anthropic foundry (#2302 )

* added anthropic foundry sample

* updated readme

* typo

Eduard van Valkenburg · 2025-11-18 16:03:40 +00:00

8a7260140a

Python: Updated documentation for Azure AI (#2280 )

* Updated documentation for Azure AI

* Small fixes

Dmytro Struk · 2025-11-17 19:14:07 +00:00

ea066771d9

125 Commits