agent/agent-framework
1
0
Fork 0
mirror of https://github.com/microsoft/agent-framework.git synced 2026-06-16 21:04:09 +08:00
Code Issues Packages Projects Releases Wiki Activity

Python: [BREAKING] Python: Provider-leading client design & OpenAI package extraction (#4818)

Browse Source 
* Python: Provider-leading client design & OpenAI package extraction

Major refactoring of the Python Agent Framework client architecture:

- Extract OpenAI clients into new `agent-framework-openai` package
- Core package no longer depends on openai, azure-identity, azure-ai-projects
- Rename clients for discoverability: OpenAIResponsesClient → OpenAIChatClient,
  OpenAIChatClient → OpenAIChatCompletionClient
- Unify `model_id`/`deployment_name`/`model_deployment_name` → `model` param
- New FoundryChatClient for Azure AI Foundry Responses API
- New FoundryAgent/FoundryAgentClient for connecting to pre-configured Foundry agents
- Remove OpenAIBase/OpenAIConfigMixin from non-deprecated client MRO
- Deprecate AzureOpenAI* clients, AzureAIClient, OpenAIAssistantsClient
- Reorganize samples: azure_openai+azure_ai+azure_ai_agent → azure/
- ADR-0020: Provider-Leading Client Design

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

* fix: missing Agent imports in samples, .model_id → .model in foundry_local sample

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

* fix: CI failures — mypy errors, coverage targets, sample imports

- azure-ai mypy: add type ignores for TypedDict total=, model arg, forward ref
- Coverage: replace core.azure/openai targets with openai package target
- project_provider: add type annotation for opts dict

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

* fix: populate openai .pyi stub, fix broken README links, coverage targets

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

* fixes

* updated observabilitty

* reset azure init.pyi

* fix errors

* updated adr number

* fix foundry local

* fixed not renamed docstrings and comments, and added deprecated markers to old classes

* fix tests and pyprojects

* fix test vars

* updated function tests

* update durable

* updated test setup for functions

* Fix Foundry auth in workflow samples

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

* Stabilize Python integration workflows

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

* Update hosting samples for Foundry

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

* Trigger full CI rerun

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

* Trigger CI rerun again

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

* trigger rerun

* trigger rerun

* fix for litellm

* undo durabletask changes

* Move Foundry APIs into foundry namespace

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

* Fix Foundry pyproject formatting

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

* Split provider samples by Foundry surface

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

* Restore hosting sample requirements

Also fix the Foundry Local sample link after the provider sample move.

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

* updated tests

* udpated foundry integration tests

* removed dist from azurefunctions tests

* Use separate Foundry clients for concurrent agents

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

* fix client setup in azfunc and durable

* disabled two tests

* updated setup for some function and durable tests

* improved azure openai setup with new clients

* ignore deprecated

* fixes

* skip 11

* remove openai assistants int tests

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
Eduard van Valkenburg
2026-03-25 10:56:29 +01:00
committed by GitHub
Unverified
parent 4b533608b6
commit 5e056b672e
485 changed files with 9784 additions and 12084 deletions
Download Patch File Download Diff File Expand all files Collapse all files
python/samples/02-agents/tools/agent_as_tool_with_session_propagation.py
+5 -3
View File
@@ -3,7 +3,7 @@
import asyncio
from collections.abc import Awaitable, Callable
from agent_framework import AgentContext, AgentSession, FunctionInvocationContext, tool
from agent_framework import Agent, AgentContext, AgentSession, FunctionInvocationContext, tool
from agent_framework.openai import OpenAIResponsesClient
from dotenv import load_dotenv
@@ -65,7 +65,8 @@ async def main() -> None:
client = OpenAIResponsesClient()
research_agent = client.as_agent(
research_agent = Agent(
client=client,
name="ResearchAgent",
instructions="You are a research assistant. Provide concise answers and store your findings.",
middleware=[log_session],
@@ -80,7 +81,8 @@ async def main() -> None:
propagate_session=True,
)
coordinator = client.as_agent(
coordinator = Agent(
client=client,
name="CoordinatorAgent",
instructions=(
"You coordinate research. Use the 'research' tool to start research "
python/samples/02-agents/tools/control_total_tool_executions.py
+13 -7
View File
@@ -3,7 +3,7 @@
import asyncio
from typing import Annotated
from agent_framework import tool
from agent_framework import Agent, tool
from agent_framework.openai import OpenAIResponsesClient
from dotenv import load_dotenv
@@ -88,7 +88,8 @@ async def scenario_max_iterations():
client.function_invocation_configuration["max_iterations"] = 3
print(f" max_iterations = {client.function_invocation_configuration['max_iterations']}")
agent = client.as_agent(
agent = Agent(
client=client,
name="ResearchAgent",
instructions=(
"You are a research assistant. Use the search_web tool to answer "
@@ -125,7 +126,8 @@ async def scenario_max_function_calls():
print(f" max_iterations = {client.function_invocation_configuration['max_iterations']}")
print(f" max_function_calls = {client.function_invocation_configuration['max_function_calls']}")
agent = client.as_agent(
agent = Agent(
client=client,
name="ResearchAgent",
instructions=(
"You are a research assistant. Use the search_web and get_weather "
@@ -155,7 +157,8 @@ async def scenario_max_invocations():
print("Scenario 3: max_invocations — lifetime cap on a tool")
print("=" * 60)
agent = OpenAIResponsesClient().as_agent(
agent = Agent(
client=OpenAIResponsesClient(),
name="APIAgent",
instructions="Use call_expensive_api when asked to analyze something.",
tools=[call_expensive_api],
@@ -212,12 +215,14 @@ async def scenario_per_agent_tool_limits():
agent_b_lookup = tool(name="lookup", approval_mode="never_require", max_invocations=5)(_do_lookup)
client = OpenAIResponsesClient()
agent_a = client.as_agent(
agent_a = Agent(
client=client,
name="AgentA",
instructions="Use the lookup tool to answer questions.",
tools=[agent_a_lookup],
)
agent_b = client.as_agent(
agent_b = Agent(
client=client,
name="AgentB",
instructions="Use the lookup tool to answer questions.",
tools=[agent_b_lookup],
@@ -270,7 +275,8 @@ async def scenario_combined():
print(f" premium_lookup.max_invocations = {premium_lookup.max_invocations}")
agent = client.as_agent(
agent = Agent(
client=client,
name="MultiToolAgent",
instructions="Use all available tools to answer comprehensively.",
tools=[search_web, get_weather, premium_lookup],
python/samples/02-agents/tools/function_invocation_configuration.py
+2 -2
View File
@@ -3,7 +3,7 @@
import asyncio
from typing import Annotated
from agent_framework import tool
from agent_framework import Agent, tool
from agent_framework.openai import OpenAIResponsesClient
from dotenv import load_dotenv
@@ -33,7 +33,7 @@ async def main():
client.function_invocation_configuration["max_iterations"] = 40
print(f"Function invocation configured as: \n{client.function_invocation_configuration}")
agent = client.as_agent(name="ToolAgent", instructions="Use the provided tools.", tools=add)
agent = Agent(client=client, name="ToolAgent", instructions="Use the provided tools.", tools=add)
print("=" * 60)
print("Call add(239847293, 29834)")
python/samples/02-agents/tools/function_tool_declaration_only.py
+3 -2
View File
@@ -2,7 +2,7 @@
import asyncio
from agent_framework import FunctionTool
from agent_framework import Agent, FunctionTool
from agent_framework.openai import OpenAIResponsesClient
from dotenv import load_dotenv
@@ -25,7 +25,8 @@ async def main():
description="Get the current time in ISO 8601 format.",
)
agent = OpenAIResponsesClient().as_agent(
agent = Agent(
client=OpenAIResponsesClient(),
name="DeclarationOnlyToolAgent",
instructions="You are a helpful agent that uses tools.",
tools=function_declaration,
python/samples/02-agents/tools/function_tool_from_dict_with_dependency_injection.py
+6 -3
View File
@@ -21,7 +21,7 @@ Usage:
import asyncio
from agent_framework import FunctionTool
from agent_framework import Agent, FunctionTool
from agent_framework.openai import OpenAIResponsesClient
from dotenv import load_dotenv
@@ -61,8 +61,11 @@ async def main() -> None:
# - "func": the parameter name that will receive the injected function
tool = FunctionTool.from_dict(definition, dependencies={"function_tool": {"name:add_numbers": {"func": func}}})
agent = OpenAIResponsesClient().as_agent(
name="FunctionToolAgent", instructions="You are a helpful assistant.", tools=tool
agent = Agent(
client=OpenAIResponsesClient(),
name="FunctionToolAgent",
instructions="You are a helpful assistant.",
tools=tool,
)
response = await agent.run("What is 5 + 3?")
print(f"Response: {response.text}")
python/samples/02-agents/tools/function_tool_recover_from_failures.py
+3 -2
View File
@@ -3,7 +3,7 @@
import asyncio
from typing import Annotated
from agent_framework import tool
from agent_framework import Agent, tool
from agent_framework.openai import OpenAIResponsesClient
from dotenv import load_dotenv
@@ -45,7 +45,8 @@ def safe_divide(
async def main():
# tools = Tools()
agent = OpenAIResponsesClient().as_agent(
agent = Agent(
client=OpenAIResponsesClient(),
name="ToolAgent",
instructions="Use the provided tools.",
tools=[greet, safe_divide],
python/samples/02-agents/tools/function_tool_with_approval_and_sessions.py
+3 -3
View File
@@ -4,7 +4,7 @@ import asyncio
from typing import Annotated
from agent_framework import Agent, Message, tool
from agent_framework.azure import AzureOpenAIChatClient
from agent_framework.foundry import FoundryChatClient
from azure.identity import AzureCliCredential
from dotenv import load_dotenv
@@ -32,7 +32,7 @@ async def approval_example() -> None:
print("=== Tool Approval with Session ===\n")
agent = Agent(
client=AzureOpenAIChatClient(credential=AzureCliCredential()),
client=FoundryChatClient(credential=AzureCliCredential()),
name="CalendarAgent",
instructions="You are a helpful calendar assistant.",
tools=[add_to_calendar],
@@ -68,7 +68,7 @@ async def rejection_example() -> None:
print("=== Tool Rejection with Session ===\n")
agent = Agent(
client=AzureOpenAIChatClient(credential=AzureCliCredential()),
client=FoundryChatClient(credential=AzureCliCredential()),
name="CalendarAgent",
instructions="You are a helpful calendar assistant.",
tools=[add_to_calendar],
python/samples/02-agents/tools/function_tool_with_explicit_schema.py
+3 -2
View File
@@ -17,7 +17,7 @@ Two approaches are shown:
import asyncio
from typing import Annotated
from agent_framework import tool
from agent_framework import Agent, tool
from agent_framework.openai import OpenAIResponsesClient
from dotenv import load_dotenv
from pydantic import BaseModel, Field
@@ -69,7 +69,8 @@ def get_current_time(timezone: str = "UTC") -> str:
async def main():
agent = OpenAIResponsesClient().as_agent(
agent = Agent(
client=OpenAIResponsesClient(),
name="AssistantAgent",
instructions="You are a helpful assistant. Use the available tools to answer questions.",
tools=[get_weather, get_current_time],
python/samples/02-agents/tools/function_tool_with_kwargs.py
+3 -2
View File
@@ -3,7 +3,7 @@
import asyncio
from typing import Annotated
from agent_framework import FunctionInvocationContext, tool
from agent_framework import Agent, FunctionInvocationContext, tool
from agent_framework.openai import OpenAIResponsesClient
from dotenv import load_dotenv
from pydantic import Field
@@ -43,7 +43,8 @@ def get_weather(
async def main() -> None:
agent = OpenAIResponsesClient().as_agent(
agent = Agent(
client=OpenAIResponsesClient(),
name="WeatherAgent",
instructions="You are a helpful weather assistant.",
tools=[get_weather],
python/samples/02-agents/tools/function_tool_with_max_exceptions.py
+3 -2
View File
@@ -3,7 +3,7 @@
import asyncio
from typing import Annotated
from agent_framework import tool
from agent_framework import Agent, tool
from agent_framework.openai import OpenAIResponsesClient
from dotenv import load_dotenv
@@ -35,7 +35,8 @@ def safe_divide(
async def main():
# tools = Tools()
agent = OpenAIResponsesClient().as_agent(
agent = Agent(
client=OpenAIResponsesClient(),
name="ToolAgent",
instructions="Use the provided tools.",
tools=[safe_divide],
python/samples/02-agents/tools/function_tool_with_max_invocations.py
+3 -2
View File
@@ -3,7 +3,7 @@
import asyncio
from typing import Annotated
from agent_framework import tool
from agent_framework import Agent, tool
from agent_framework.openai import OpenAIResponsesClient
from dotenv import load_dotenv
@@ -24,7 +24,8 @@ def unicorn_function(times: Annotated[int, "The number of unicorns to return."])
async def main():
# tools = Tools()
agent = OpenAIResponsesClient().as_agent(
agent = Agent(
client=OpenAIResponsesClient(),
name="ToolAgent",
instructions="Use the provided tools.",
tools=[unicorn_function],
python/samples/02-agents/tools/function_tool_with_session_injection.py
+3 -2
View File
@@ -3,7 +3,7 @@
import asyncio
from typing import Annotated
from agent_framework import AgentSession, FunctionInvocationContext, tool
from agent_framework import Agent, AgentSession, FunctionInvocationContext, tool
from agent_framework.openai import OpenAIResponsesClient
from dotenv import load_dotenv
from pydantic import Field
@@ -36,7 +36,8 @@ async def get_weather(
async def main() -> None:
agent = OpenAIResponsesClient().as_agent(
agent = Agent(
client=OpenAIResponsesClient(),
name="WeatherAgent",
instructions="You are a helpful weather assistant.",
tools=[get_weather],
python/samples/02-agents/tools/tool_in_class.py
+3 -2
View File
@@ -3,7 +3,7 @@
import asyncio
from typing import Annotated
from agent_framework import tool
from agent_framework import Agent, tool
from agent_framework.openai import OpenAIResponsesClient
from dotenv import load_dotenv
@@ -49,7 +49,8 @@ async def main():
# Applying the tool decorator to one of the methods of the class
add_function = tool(description="Add two numbers.")(tools.add)
agent = OpenAIResponsesClient().as_agent(
agent = Agent(
client=OpenAIResponsesClient(),
name="ToolAgent",
instructions="Use the provided tools.",
)