# Python
pip install agent-framework

# .NET
dotnet add package Microsoft.Agents.AI

# pip install agent-framework
# 使用 `az login` 进行 Azure CLI 认证

import os
import asyncio
from agent_framework import Agent
from agent_framework.foundry import FoundryChatClient
from azure.identity import AzureCliCredential

async def main():
    # 初始化 Azure Foundry Chat Agent
    agent = Agent(
        client=FoundryChatClient(
            credential=AzureCliCredential(),
            # project_endpoint=os.environ["FOUNDRY_PROJECT_ENDPOINT"],
            # model=os.environ["FOUNDRY_MODEL_DEPLOYMENT_NAME"],
        ),
        name="HaikuBot",
        instructions="You are an upbeat assistant that writes beautifully."
    )
    print(await agent.run("Write a haiku about Microsoft Agent Framework."))

if __name__ == "__main__":
    asyncio.run(main())

// dotnet add package Microsoft.Agents.AI.Foundry
// 使用 `az login` 进行 Azure CLI 认证

using Azure.AI.Projects;
using Azure.Identity;

var endpoint = Environment.GetEnvironmentVariable("AZURE_AI_PROJECT_ENDPOINT") 
    ?? throw new InvalidOperationException("AZURE_AI_PROJECT_ENDPOINT is not set.");
var deploymentName = Environment.GetEnvironmentVariable("AZURE_AI_MODEL_DEPLOYMENT_NAME") ?? "gpt-5.4-mini";

var agent = new AIProjectClient(new Uri(endpoint), new DefaultAzureCredential())
    .AsAIAgent(model: deploymentName, name: "HaikuBot", instructions: "You are an upbeat assistant that writes beautifully.");

Console.WriteLine(await agent.RunAsync("Write a haiku about Microsoft Agent Framework."));

// dotnet add package Microsoft.Agents.AI.OpenAI

using OpenAI;

var agent = new OpenAIClient("<your-api-key>")
    .GetResponsesClient()
    .AsAIAgent(model: "gpt-5.4-mini", name: "HaikuBot", instructions: "You are an upbeat assistant that writes beautifully.");

Console.WriteLine(await agent.RunAsync("Write a haiku about Microsoft Agent Framework."));

# 工具使用
from agent_framework import Agent

agent = Agent(instructions="You are a helpful assistant.")
result = await agent.run("What's the weather in Tokyo?")

# 多 Provider 支持
from agent_framework import Agent
from agent_framework.providers import OpenAI, AzureOpenAI, Anthropic

# 使用 OpenAI
agent = Agent(provider=OpenAI(api_key="..."))

# 使用 Azure OpenAI
agent = Agent(provider=AzureOpenAI(endpoint="...", key="..."))

# 使用 Anthropic
agent = Agent(provider=Anthropic(api_key="..."))

// 使用不同的 Provider
var agent = new OpenAIClient("<api-key>")
    .GetResponsesClient()
    .AsAIAgent(model: "gpt-4", name: "Assistant", instructions: "...");

// 使用 Azure OpenAI
var azureAgent = new AIProjectClient(new Uri(endpoint), new DefaultAzureCredential())
    .AsAIAgent(model: "gpt-4", name: "Assistant", instructions: "...");

# Python 工作流
from agent_framework.workflows import Workflow, AgentNode, FunctionNode

workflow = Workflow(name="customer-support")

# 添加 Agent 节点
support_agent = workflow.add_node(
    AgentNode(name="support", instructions="You are a support agent.")
)

# 添加函数节点
classify = workflow.add_node(
    FunctionNode(name="classify", func=classify_ticket)
)

# 定义连接
support_agent.input >> classify.output
classify.output >> support_agent.input

# 执行工作流
result = await workflow.run(ticket)

# 安装 DevUI
pip install agent-framework[devui]

# 启动 DevUI
python -m agent_framework.devui
# 访问 http://localhost:8080

from agent_framework import Agent
from agent_framework.observability import Tracing

# 启用追踪
with Tracing(service_name="my-agent"):
    agent = Agent(instructions="You are a helpful assistant.")
    result = await agent.run("What's the weather?")

// 启用 OpenTelemetry
var agent = new AIProjectClient(new Uri(endpoint), new DefaultAzureCredential())
    .AsAIAgent(model: "gpt-4")
    .WithTracing(serviceName: "my-agent");

var result = await agent.RunAsync("What's the weather?");

from agent_framework import Agent, Middleware

class CustomMiddleware(Middleware):
    async def on_request(self, request):
        # 处理请求
        print(f"Request: {request}")
        return request
    
    async def on_response(self, response):
        # 处理响应
        print(f"Response: {response}")
        return response

agent = Agent(
    instructions="You are a helpful assistant.",
    middleware=[CustomMiddleware()]
)

// Python: agent.add_middleware(CustomMiddleware())
// .NET: Use代理模式或包装器
agent.Use(async (context, next) =>
{
    Console.WriteLine($"Before: {context.Request}");
    await next(context);
    Console.WriteLine($"After: {context.Response}");
});

# Python 多 Provider
from agent_framework import Agent
from agent_framework.providers import OpenAI, AzureOpenAI, Anthropic

# OpenAI
agent1 = Agent(provider=OpenAI(api_key="sk-..."))

# Azure OpenAI
agent2 = Agent(provider=AzureOpenAI(
    endpoint="https://xxx.openai.azure.com",
    api_key="..."
))

# Anthropic
agent3 = Agent(provider=Anthropic(api_key="sk-ant-..."))

# 安装 Labs
pip install agent-framework[lab]

# 使用实验性功能
from agent_framework.lab import Benchmarking, ReinforcementLearning

# Python Azure Functions
import azure.functions as func
from agent_framework import Agent

app = func.AsgiFunctionApp()

@app.http_trigger()
async def run_agent(req: func.HttpRequest):
    agent = Agent(instructions="You are a helpful assistant.")
    body = await req.get_json()
    result = await agent.run(body["message"])
    return func.HttpResponse(result)

// .NET Durable Agents
var agent = new AIProjectClient(new Uri(endpoint), new DefaultAzureCredential())
    .AsDurableAgent(model: "gpt-4");

var instanceId = await agent.StartAsync();
await agent.WaitAsync();

# Semantic Kernel
from semantic_kernel import Kernel

# Microsoft Agent Framework
from agent_framework import Agent