Microsoft Agent Framework 支援使用遠端代理程式，透過 A2A 協定在你的應用程式中暴露，且抽象 AIAgent 性與其他代理相同。
使用者入門
將必要的 NuGet 套件新增至您的專案。
dotnet add package Microsoft.Agents.AI.A2A --prerelease
使用著名的代理卡位置建立 A2A 代理程式
以下情境使用了常用的代理卡位置。
它會將 A2A 代理主機的根 URI 傳遞給 A2ACardResolver 建構子，然後解析器將在 https://your-a2a-agent-host/.well-known/agent-card.json 尋找代理卡。
首先，使用遠端 A2A 代理程式主機的 URI 建立一個 A2ACardResolver 。
using System;
using A2A;
using Microsoft.Agents.AI;
using Microsoft.Agents.AI.A2A;
A2ACardResolver agentCardResolver = new(new Uri("https://your-a2a-agent-host"));
使用AIAgent協助程式方法，為遠端 A2A 代理程式的GetAIAgentAsync建立實例。
AIAgent agent = await agentCardResolver.GetAIAgentAsync();
利用直接配置/私有發現機制建立 A2A 代理
如果已知代理網址，也可以直接指向。 這對於緊密耦合的系統、專用代理程式或開發目的非常有用，其中用戶端直接使用代理卡資訊和代理程式 URL 進行配置。
在這種情況下，你直接用代理人的網址建構一個 A2AClient 。
A2AClient a2aClient = new(new Uri("https://your-a2a-agent-host/echo"));
然後你可以用這個AIAgent方法建立一個GetAIAgent實例。
AIAgent agent = a2aClient.GetAIAgent();
使用代理程式
代理程式是標準 AIAgent ，支援所有標準代理程式作業。
想了解更多如何執行及與代理互動的資訊，請參閱代理 入門教學。
使用者入門
將必要的 Python 套件新增至您的專案。
pip install agent-framework-a2a --pre
建立一個 A2A 代理
以下情境採用了廣為人知的代理卡位置。
它將 A2A 代理端主機的基底 URL 傳給 A2ACardResolver 建構子，解析器則會在 https://your-a2a-agent-host/.well-known/agent.json 尋找代理卡片。
首先，建立一個 A2ACardResolver，其 URL 為遠端 A2A 代理主機的網址。
import httpx
from a2a.client import A2ACardResolver
# Create httpx client for HTTP communication
async with httpx.AsyncClient(timeout=60.0) as http_client:
resolver = A2ACardResolver(httpx_client=http_client, base_url="https://your-a2a-agent-host")
獲取代理卡，並為遠端 A2A 代理建立A2AAgent的執行個體。
from agent_framework.a2a import A2AAgent
# Get agent card from the well-known location
agent_card = await resolver.get_agent_card(relative_card_path="/.well-known/agent.json")
# Create A2A agent instance
agent = A2AAgent(
name=agent_card.name,
description=agent_card.description,
agent_card=agent_card,
url="https://your-a2a-agent-host"
)
使用 URL 建立 A2A 代理
如果已知代理網址，也可以直接指向。 這對於緊密耦合的系統、專用代理程式或開發目的非常有用，其中用戶端直接使用代理卡資訊和代理程式 URL 進行配置。
在這種情況下，你直接用代理人的網址建構一個 A2AAgent 。
from agent_framework.a2a import A2AAgent
# Create A2A agent with direct URL configuration
agent = A2AAgent(
name="My A2A Agent",
description="A directly configured A2A agent",
url="https://your-a2a-agent-host/echo"
)
使用代理程式
A2A 代理程式支援所有標準代理程式作業。
想了解更多如何執行及與代理互動的資訊，請參閱代理 入門教學。