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

* 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>
2026-06-16 21:04:09 +08:00 · 2026-03-25 10:56:29 +01:00
parent 4b533608b6
commit 5e056b672e
485 changed files with 9784 additions and 12084 deletions
@@ -43,7 +43,7 @@ Shows how to create an agent that can search and retrieve information from Micro
 - Uses Azure CLI credentials for authentication
 - Leverages MCP to access Microsoft documentation tools

-**Requirements**: `pip install agent-framework-azure-ai --pre`
+**Requirements**: `pip install agent-framework-foundry --pre`

 **Key concepts**: Azure AI Foundry integration, MCP server usage, async patterns, resource management

@@ -53,7 +53,7 @@ Shows how to create an agent using an inline YAML string rather than a file.

 - Uses Azure AI Foundry v2 Client with instructions.

-**Requirements**: `pip install agent-framework-azure-ai --pre`
+**Requirements**: `pip install agent-framework-foundry --pre`

 **Key concepts**: Inline YAML definition.

@@ -15,11 +15,9 @@ async def main():
    # get the path
    current_path = Path(__file__).parent
    yaml_path = current_path.parent.parent.parent.parent / "agent-samples" / "azure" / "AzureOpenAIResponses.yaml"
-
    # load the yaml from the path
    with yaml_path.open("r") as f:
        yaml_str = f.read()
-
    # create the agent from the yaml
    agent = AgentFactory(client_kwargs={"credential": AzureCliCredential()}).create_agent_from_yaml(yaml_str)
    # use the agent
@@ -4,8 +4,8 @@ from pathlib import Path
 from random import randint
 from typing import Literal

-from agent_framework.azure import AzureOpenAIResponsesClient
 from agent_framework.declarative import AgentFactory
+from agent_framework.foundry import FoundryChatClient
 from azure.identity import AzureCliCredential
 from dotenv import load_dotenv

@@ -15,7 +15,6 @@ load_dotenv()

 def get_weather(location: str, unit: Literal["celsius", "fahrenheit"] = "celsius") -> str:
    """A simple function tool to get weather information."""
-
    return f"The weather in {location} is {randint(-10, 30) if unit == 'celsius' else randint(30, 100)} degrees {unit}."


@@ -24,14 +23,12 @@ async def main():
    # get the path
    current_path = Path(__file__).parent
    yaml_path = current_path.parent.parent.parent.parent / "agent-samples" / "chatclient" / "GetWeather.yaml"
-
    # load the yaml from the path
    with yaml_path.open("r") as f:
        yaml_str = f.read()
-
    # create the AgentFactory with a chat client and bindings
    agent_factory = AgentFactory(
-        client=AzureOpenAIResponsesClient(credential=AzureCliCredential()),
+        client=FoundryChatClient(credential=AzureCliCredential()),
        bindings={"get_weather": get_weather},
    )
    # create the agent from the yaml
@@ -14,9 +14,9 @@ This sample shows how to create an agent using an inline YAML string rather than
 It uses a Azure AI Client so it needs the credential to be passed into the AgentFactory.

 Prerequisites:
- `pip install agent-framework-azure-ai agent-framework-declarative --pre`
+- `pip install agent-framework-foundry agent-framework-declarative --pre`
 - Set the following environment variables in a .env file or your environment:
-    - AZURE_AI_PROJECT_ENDPOINT
+    - FOUNDRY_PROJECT_ENDPOINT
    - AZURE_OPENAI_MODEL
 """

@@ -33,7 +33,7 @@ model:
  id: =Env.AZURE_OPENAI_MODEL
  connection:
    kind: remote
-    endpoint: =Env.AZURE_AI_PROJECT_ENDPOINT
+    endpoint: =Env.FOUNDRY_PROJECT_ENDPOINT
 """
    # create the agent from the yaml
    async with (
@@ -132,9 +132,9 @@ async def run_azure_ai_example():
    print("Example 2: Azure AI with Foundry Connection Reference")
    print("=" * 60)

-    from azure.identity import DefaultAzureCredential
+    from azure.identity import AzureCliCredential

-    factory = AgentFactory(client_kwargs={"credential": DefaultAzureCredential()})
+    factory = AgentFactory(client_kwargs={"credential": AzureCliCredential()})

    print("\nCreating agent from YAML definition...")
    # Use async method for provider-based agent creation
@@ -12,11 +12,9 @@ load_dotenv()

 async def main():
    """Create an agent from a declarative yaml specification and run it."""
-
    # get the path
    current_path = Path(__file__).parent
    yaml_path = current_path.parent.parent.parent.parent / "agent-samples" / "foundry" / "MicrosoftLearnAgent.yaml"
-
    # create the agent from the yaml
    async with (
        AzureCliCredential() as credential,
@@ -11,15 +11,12 @@ load_dotenv()

 async def main():
    """Create an agent from a declarative yaml specification and run it."""
-
    # get the path
    current_path = Path(__file__).parent
    yaml_path = current_path.parent.parent.parent.parent / "agent-samples" / "openai" / "OpenAIResponses.yaml"
-
    # load the yaml from the path
    with yaml_path.open("r") as f:
        yaml_str = f.read()
-
    # create the agent from the yaml
    agent = AgentFactory(safe_mode=False).create_agent_from_yaml(yaml_str)
    # use the agent