Python: [BREAKING] Remove deprecated Python OpenAI/Azure AI surfaces (#4990)

* [BREAKING] Remove deprecated Python OpenAI/Azure AI surfaces Also clean up follow-on docs, environment guidance, package metadata, and lab test stability. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Fix deleted semantic-kernel sample links Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Address PR review feedback Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * improve foundry language * Fix A2A Foundry sample regression Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-06-16 21:04:09 +08:00 · 2026-03-31 22:36:21 +02:00
parent a5eacbbe65
commit 3a49b1d6dd
144 changed files with 669 additions and 18739 deletions
@@ -22,16 +22,16 @@ The remaining files are supporting modules used by the server:
 Make sure to set the following environment variables before running the examples:

 ### Required (Server)
- `AZURE_AI_PROJECT_ENDPOINT` — Your Azure AI Foundry project endpoint
- `AZURE_OPENAI_RESPONSES_DEPLOYMENT_NAME` — Model deployment name (e.g. `gpt-4o`)
+- `FOUNDRY_PROJECT_ENDPOINT` — Your Azure AI Foundry project endpoint
+- `FOUNDRY_MODEL` — Model deployment name (e.g. `gpt-4o`)

 ### Required (Client)
 - `A2A_AGENT_HOST` — URL of the A2A server (e.g. `http://localhost:5001/`)

 ### Required (Function Tools Sample)
 - `A2A_AGENT_HOST` — URL of the A2A server (e.g. `http://localhost:5000/`)
- `AZURE_AI_PROJECT_ENDPOINT` — Your Azure AI Foundry project endpoint
- `AZURE_OPENAI_RESPONSES_DEPLOYMENT_NAME` — Model deployment name (e.g. `gpt-4o`)
+- `FOUNDRY_PROJECT_ENDPOINT` — Your Azure AI Foundry project endpoint
+- `FOUNDRY_MODEL` — Model deployment name (e.g. `gpt-4o`)

 ## Quick Start

@@ -65,7 +65,7 @@ uv run python agent_with_a2a.py
 ### 3. Run the Function Tools Sample

 This sample resolves the remote agent's skills and registers each one as a function tool
-on a host OpenAI-powered agent. The host agent then autonomously selects the right skill
+on a host Foundry-backed agent. The host agent then autonomously selects the right skill
 to handle the user's request.

 ```powershell
@@ -7,7 +7,7 @@ import re
 import httpx
 from a2a.client import A2ACardResolver
 from agent_framework.a2a import A2AAgent
-from agent_framework.azure import AzureOpenAIResponsesClient
+from agent_framework.foundry import FoundryChatClient
 from azure.identity import AzureCliCredential
 from dotenv import load_dotenv

@@ -29,8 +29,8 @@ Key concepts demonstrated:

 Prerequisites:
 - Set A2A_AGENT_HOST to the URL of a running A2A server
- Set AZURE_AI_PROJECT_ENDPOINT to your Azure AI Foundry project endpoint
- Set AZURE_OPENAI_RESPONSES_DEPLOYMENT_NAME to the model deployment name (e.g. gpt-4o)
+- Set FOUNDRY_PROJECT_ENDPOINT to your Azure AI Foundry project endpoint
+- Set FOUNDRY_MODEL to the model deployment name (e.g. gpt-4o)

 To run this sample:
    cd python/samples/04-hosting/a2a
@@ -45,11 +45,11 @@ async def main() -> None:
    if not a2a_agent_host:
        raise ValueError("A2A_AGENT_HOST environment variable is not set")

-    project_endpoint = os.getenv("AZURE_AI_PROJECT_ENDPOINT")
-    deployment_name = os.getenv("AZURE_OPENAI_RESPONSES_DEPLOYMENT_NAME")
-    if not project_endpoint or not deployment_name:
+    project_endpoint = os.getenv("FOUNDRY_PROJECT_ENDPOINT")
+    model = os.getenv("FOUNDRY_MODEL")
+    if not project_endpoint or not model:
        raise ValueError(
-            "AZURE_AI_PROJECT_ENDPOINT and AZURE_OPENAI_RESPONSES_DEPLOYMENT_NAME must be set"
+            "FOUNDRY_PROJECT_ENDPOINT and FOUNDRY_MODEL must be set"
        )

    print(f"Connecting to A2A agent at: {a2a_agent_host}")
@@ -83,9 +83,9 @@ async def main() -> None:

        # 5. Create the host agent with the skill tools.
        credential = AzureCliCredential()
-        client = AzureOpenAIResponsesClient(
+        client = FoundryChatClient(
            project_endpoint=project_endpoint,
-            deployment_name=deployment_name,
+            model=model,
            credential=credential,
        )
        host_agent = client.as_agent(
@@ -138,23 +138,35 @@ Expected response:
 The sample shows how to enable MCP tool triggers with flexible agent configuration:

 ```python
-from agent_framework.azure import AgentFunctionApp, AzureOpenAIChatClient
+import os

-# Create Azure OpenAI Chat Client
-client = AzureOpenAIChatClient()
+from agent_framework import Agent
+from agent_framework.azure import AgentFunctionApp
+from agent_framework.foundry import FoundryChatClient
+from azure.identity.aio import AzureCliCredential
+
+# Create Foundry chat client
+client = FoundryChatClient(
+    project_endpoint=os.environ["FOUNDRY_PROJECT_ENDPOINT"],
+    model=os.environ["FOUNDRY_MODEL"],
+    credential=AzureCliCredential(),
+)

 # Define agents with different roles
-joker_agent = client.as_agent(
+joker_agent = Agent(
+    client=client,
    name="Joker",
    instructions="You are good at telling jokes.",
 )

-stock_agent = client.as_agent(
+stock_agent = Agent(
+    client=client,
    name="StockAdvisor",
    instructions="Check stock prices.",
 )

-plant_agent = client.as_agent(
+plant_agent = Agent(
+    client=client,
    name="PlantAdvisor",
    instructions="Recommend plants.",
    description="Get plant recommendations.",