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이 알려진 경우 에이전트 URL을 직접 가리킬 수도 있습니다. 이는 클라이언트가 에이전트 카드 정보 및 에이전트 URL로 직접 구성된 긴밀하게 결합된 시스템, 프라이빗 에이전트 또는 개발 목적에 유용할 수 있습니다."
이 경우 에이전트의 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카드를 찾습니다.
먼저 원격 A2A 에이전트 호스트의 URL을 사용하여 A2ACardResolver 만듭니다.
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이 알려진 경우 에이전트 URL을 직접 가리킬 수도 있습니다. 이는 클라이언트가 에이전트 카드 정보 및 에이전트 URL로 직접 구성된 긴밀하게 결합된 시스템, 개인 에이전트 또는 개발 목적에 유용할 수 있습니다.
이 경우 에이전트의 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 에이전트는 모든 표준 에이전트 작업을 지원합니다.
에이전트를 실행하고 상호 작용하는 방법에 대한 자세한 내용은 에이전트 시작 자습서 를 참조하세요.