다음을 통해 공유

A2A 에이전트

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 에이전트는 모든 표준 에이전트 작업을 지원합니다.

에이전트를 실행하고 상호 작용하는 방법에 대한 자세한 내용은 에이전트 시작 자습서 를 참조하세요.

다음 단계

사용자 지정 에이전트

  • Last updated on