Agenti A2A

Microsoft Agent Framework podporuje použití vzdáleného agenta, který je vystaven prostřednictvím protokolu A2A ve vaší aplikaci pomocí stejné AIAgent abstrakce jako jakýkoli jiný agent.

Začínáme

Přidejte do projektu požadované balíčky NuGet.

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

Vytvořte agenta A2A pomocí známého umístění karty agenta

Následující scénář používá známé umístění karty agenta. Předává kořenový identifikátor URI hostitele A2ACardResolver agenta A2A konstruktoru a překladač vyhledá kartu agenta na adrese https://your-a2a-agent-host/.well-known/agent-card.json.

Nejprve vytvořte A2ACardResolver s URI hostitele 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"));

Vytvořte instanci AIAgent pro vzdáleného A2A agenta s použitím pomocné metody GetAIAgentAsync.

AIAgent agent = await agentCardResolver.GetAIAgentAsync();

Vytvoření agenta A2A pomocí mechanismu přímé konfigurace nebo privátního zjišťování

Je také možné odkazovat přímo na adresu URL agenta, pokud je známo. To může být užitečné pro úzce propojené systémy, privátní agenty nebo účely vývoje, kde jsou klienti přímo nakonfigurováni s informacemi o kartě agenta a adresou URL agenta.

V tomto případě vytvoříte A2AClient přímo s adresou URL agenta.

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

A pak můžete vytvořit instanci AIAgent pomocí AsAIAgent metody.

AIAgent agent = a2aClient.AsAIAgent();

Použití agenta

Agent je standardní AIAgent a podporuje všechny standardní operace agentů.

Další informace o tom, jak spouštět agenty a pracovat s nimi, najdete v úvodních kurzech agenta.

Začínáme

Přidejte do projektu požadované balíčky Pythonu.

pip install agent-framework-a2a --pre

Vytvoření agenta A2A

Následující scénář používá známé umístění karty agenta. Předá základní adresu URL hostitele A2ACardResolver agenta A2A konstruktoru a resolver vyhledá kartu agenta na adrese https://your-a2a-agent-host/.well-known/agent.json.

Nejprve vytvořte A2ACardResolver s adresou URL vzdáleného hostitele 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")

Získejte identifikační kartu agenta a vytvořte instanci A2AAgent pro vzdáleného 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"
)

Vytvoření agenta A2A pomocí adresy URL

Je také možné odkazovat přímo na adresu URL agenta, pokud je známo. To může být užitečné pro úzce propojené systémy, privátní agenty nebo účely vývoje, kde jsou klienti přímo nakonfigurováni s informacemi o kartě agenta a adresou URL agenta.

V tomto případě vytvoříte A2AAgent přímo s adresou 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"
)

Použití agenta

Agent A2A podporuje všechny standardní operace agenta.

Další informace o tom, jak spouštět agenty a pracovat s nimi, najdete v úvodních kurzech agenta.

Další kroky

Vlastní agent