A2A-agents

Microsoft Agent Framework biedt ondersteuning voor het gebruik van een externe agent die beschikbaar wordt gemaakt via het A2A-protocol in uw toepassing met behulp van dezelfde AIAgent abstractie als elke andere agent.

Aan de slag komen

Voeg de vereiste NuGet-pakketten toe aan uw project.

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

Een A2A-agent maken met behulp van de bekende locatie van de agentkaart

In het volgende scenario wordt de bekende locatie van de agentkaart gebruikt. De hoofd-URI van de A2A-agenthost wordt doorgegeven aan de A2ACardResolver constructor, waarbij de resolver zoekt naar de agent card bij https://your-a2a-agent-host/.well-known/agent-card.json.

Maak eerst een A2ACardResolver met de URI van de externe A2A-agenthost.

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

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

Maak een exemplaar van de AIAgent voor de externe A2A-agent met behulp van de GetAIAgentAsync-helpermethode.

AIAgent agent = await agentCardResolver.GetAIAgentAsync();

Een A2A-agent maken met behulp van het directe configuratie-/privédetectiemechanisme

Het is ook mogelijk om rechtstreeks naar de agent-URL te verwijzen als deze bekend is. Dit kan handig zijn voor nauw gekoppelde systemen, privéagenten of ontwikkelingsdoeleinden, waarbij clients rechtstreeks worden geconfigureerd met agentkaartgegevens en agent-URL.

In dit geval maakt u een A2AClient rechtstreeks met de URL van de agent.

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

Vervolgens kunt u een instantie van de AIAgent maken met behulp van de GetAIAgent methode.

AIAgent agent = a2aClient.GetAIAgent();

De agent gebruiken

De agent is een standaard AIAgent en ondersteunt alle standaardagentbewerkingen.

Voor meer informatie over hoe je agents uitvoert en ermee werkt, raadpleeg de Aan de slag met agent-tutorials.

Aan de slag komen

Voeg de vereiste Python-pakketten toe aan uw project.

pip install agent-framework-a2a --pre

Een A2A-agent maken

In het volgende scenario wordt de bekende locatie van de agentkaart gebruikt. De basis-URL van de A2A-agenthost wordt doorgegeven aan de A2ACardResolver constructor en de resolver zoekt naar de agentkaart op https://your-a2a-agent-host/.well-known/agent.json.

Maak eerst een A2ACardResolver met de URL van de externe A2A-agenthost.

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

Haal de agentkaart op en maak een exemplaar van de A2AAgent externe A2A-agent.

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

Een A2A-agent maken met behulp van URL

Het is ook mogelijk om rechtstreeks naar de agent-URL te verwijzen als deze bekend is. Dit kan handig zijn voor nauw gekoppelde systemen, privéagenten of ontwikkelingsdoeleinden, waarbij clients rechtstreeks worden geconfigureerd met agentkaartgegevens en agent-URL.

In dit geval maakt u een A2AAgent rechtstreeks met de URL van de agent.

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

De agent gebruiken

De A2A-agent ondersteunt alle standaardagentbewerkingen.

Voor meer informatie over hoe je agents uitvoert en ermee werkt, raadpleeg de Aan de slag met agent-tutorials.

Volgende stappen

Aangepaste agent