Agenci A2A

Program Microsoft Agent Framework obsługuje używanie agenta zdalnego uwidocznionego za pośrednictwem protokołu A2A w aplikacji przy użyciu tej samej AIAgent abstrakcji co każdy inny agent.

Wprowadzenie

Dodaj wymagane pakiety NuGet do projektu.

dotnet add package Microsoft.Agents.AI.A2A --prerelease

Tworzenie agenta A2A przy użyciu dobrze znanej lokalizacji karty agenta

Najpierw przyjrzyjmy się scenariuszom, w których używamy dobrze znanej lokalizacji karty agenta. Przekazujemy główny identyfikator URI hosta agenta A2A do A2ACardResolver konstruktora, a program rozpoznawania wyszuka kartę agenta pod adresem https://your-a2a-agent-host/.well-known/agent-card.json.

Najpierw utwórz A2ACardResolver z identyfikatorem URI zdalnego hosta agenta A2A.

using System;
using A2A;
using Microsoft.Agents.AI;
using Microsoft.Agents.AI.A2A;

A2ACardResolver agentCardResolver = new(new Uri("https://your-a2a-agent-host"));

Utwórz wystąpienie zdalnego agenta A2A AIAgent przy użyciu pomocniczej metody GetAIAgentAsync.

AIAgent agent = await agentCardResolver.GetAIAgentAsync();

Tworzenie agenta A2A przy użyciu mechanizmu bezpośredniej konfiguracji / prywatnego odkrywania

Istnieje również możliwość wskazania bezpośrednio na adres URL agenta, jeśli jest nam znany. Może to być przydatne w przypadku ściśle powiązanych systemów, agentów prywatnych lub celów programistycznych, gdzie klienci są bezpośrednio skonfigurowani przy użyciu informacji o karcie agenta i adresu URL agenta.

W tym przypadku tworzymy A2AClient bezpośrednio z adresem URL agenta.

A2AClient a2aClient = new(new Uri("https://your-a2a-agent-host/echo"));

Następnie możemy utworzyć wystąpienie AIAgent przy użyciu metody GetAIAgent.

AIAgent agent = a2aClient.GetAIAgent();

Korzystanie z agenta

Agent jest standardowy AIAgent i obsługuje wszystkie standardowe operacje agenta.

Aby uzyskać więcej informacji na temat uruchamiania agentów i interakcji z nimi, zobacz samouczki wprowadzające Agenta.

Wprowadzenie

Dodaj wymagane pakiety języka Python do projektu.

pip install agent-framework-a2a --pre

Tworzenie agenta A2A

Najpierw przyjrzyjmy się scenariuszowi, w którym używamy dobrze znanej lokalizacji karty agenta. Przekazujemy podstawowy adres URL hosta agenta A2A do A2ACardResolver konstruktora, a program rozpoznawania wyszuka kartę agenta pod adresem https://your-a2a-agent-host/.well-known/agent.json.

Najpierw utwórz obiekt A2ACardResolver przy użyciu adresu URL zdalnego hosta agenta 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")

Pobierz kartę agenta i utwórz wystąpienie A2AAgent dla zdalnego agenta A2A.

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"
)

Tworzenie agenta A2A przy użyciu adresu URL

Istnieje również możliwość wskazania bezpośrednio na adres URL agenta, jeśli jest nam znany. Może to być przydatne w przypadku ściśle powiązanych systemów, agentów prywatnych lub celów programistycznych, gdzie klienci są bezpośrednio skonfigurowani przy użyciu informacji o karcie agenta i adresu URL agenta.

W tym przypadku tworzymy A2AAgent bezpośrednio z adresem URL agenta.

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"
)

Korzystanie z agenta

Agent A2A obsługuje wszystkie standardowe operacje agenta.

Aby uzyskać więcej informacji na temat uruchamiania agentów i interakcji z nimi, zobacz samouczki wprowadzające Agenta.

Dalsze kroki

Agent niestandardowy