A2A Agents

Microsoft Agent Framework prend en charge l’utilisation d’un agent distant exposé via le protocole A2A dans votre application à l’aide de la même AIAgent abstraction que tout autre agent.

Getting Started

Ajoutez les packages NuGet requis à votre projet.

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

Création d’un agent A2A à l’aide de l’emplacement bien connu de la carte d’agent

Tout d’abord, examinons un scénario où nous utilisons l’emplacement bien connu de la carte de l’agent. Nous transmettons l’URI racine de l’hôte de l’agent A2A au A2ACardResolver constructeur et le programme de résolution recherchera la carte de l’agent à l’adresse https://your-a2a-agent-host/.well-known/agent-card.json.

Tout d’abord, créez un A2ACardResolver avec l’URI de l’hôte distant de l’agent A2A.

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

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

Créez une instance de AIAgent pour l’agent A2A distant en utilisant GetAIAgentAsync méthode d’assistance.

AIAgent agent = await agentCardResolver.GetAIAgentAsync();

Création d’un agent A2A à l’aide du mécanisme de configuration directe /découverte privée

Il est également possible de pointer directement vers l’URL de l’agent si nous la connaissons. Cela peut être utile pour les systèmes étroitement couplés, les agents privés ou les fins de développement, où les clients sont directement configurés avec les informations de carte d’agent et l’URL de l’agent.

Dans ce cas, nous construisons directement une A2AClient avec l'URL de l'agent.

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

Ensuite, nous pouvons créer une instance de AIAgent en utilisant la méthode GetAIAgent.

AIAgent agent = a2aClient.GetAIAgent();

Utilisation de l’agent

L’agent est standard AIAgent et prend en charge toutes les opérations d’agent standard.

Pour plus d’informations sur l’exécution et l’interaction avec les agents, consultez les didacticiels de prise en main de l’agent .

Getting Started

Ajoutez les packages Python requis à votre projet.

pip install agent-framework-a2a --pre

Création d’un agent A2A

Tout d’abord, examinons un scénario en utilisant l’emplacement bien connu de la carte d’agent. Nous transmettons l’URL de base de l’hôte de l’agent A2A au A2ACardResolver constructeur et le programme de résolution recherchera la carte de l’agent à l’adresse https://your-a2a-agent-host/.well-known/agent.json.

Tout d'abord, créez un A2ACardResolver avec l'URL de l'hôte distant de l'agent 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")

Obtenez la carte de l'agent et créez une instance de l'agent A2A A2AAgent distant.

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

Création d’un agent A2A à l’aide de l’URL

Il est également possible de pointer directement vers l’URL de l’agent si nous la connaissons. Cela peut être utile pour les systèmes étroitement couplés, les agents privés ou les fins de développement, où les clients sont directement configurés avec les informations de carte d’agent et l’URL de l’agent.

Dans ce cas, nous construisons directement une A2AAgent avec l'URL de l'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"
)

Utilisation de l’agent

L’agent A2A prend en charge toutes les opérations d’agent standard.

Pour plus d’informations sur l’exécution et l’interaction avec les agents, consultez les didacticiels de prise en main de l’agent .

Étapes suivantes

Agent personnalisé