A2A Agents

Getting Started

Add the required NuGet packages to your project.

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

Creating an A2A Agent using the well known agent card location

First, let's look at a scenarios where we use the well known agent card location. We pass the root URI of the A2A agent host to the A2ACardResolver constructor and the resolver will look for the agent card at https://your-a2a-agent-host/.well-known/agent-card.json.

First, create an A2ACardResolver with the URI of the remote A2A agent host.

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

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

Create an instance of the AIAgent for the remote A2A agent using the GetAIAgentAsync helper method.

AIAgent agent = await agentCardResolver.GetAIAgentAsync();

Creating an A2A Agent using the Direct Configuration / Private Discovery mechanism

It is also possible to point directly at the agent URL if it's known to us. This can be useful for tightly coupled systems, private agents, or development purposes, where clients are directly configured with Agent Card information and agent URL."

In this case we construct an A2AClient directly with the URL of the agent.

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

And then we can create an instance of the AIAgent using the GetAIAgent method.

AIAgent agent = a2aClient.GetAIAgent();

Using the Agent

The agent is a standard AIAgent and supports all standard agent operations.

See the Agent getting started tutorials for more information on how to run and interact with agents.

Getting Started

Add the required Python packages to your project.

pip install agent-framework-a2a

Creating an A2A Agent

First, let's look at a scenario where we use the well known agent card location. We pass the base URL of the A2A agent host to the A2ACardResolver constructor and the resolver will look for the agent card at https://your-a2a-agent-host/.well-known/agent.json.

First, create an A2ACardResolver with the URL of the remote A2A agent host.

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

Get the agent card and create an instance of the A2AAgent for the remote 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"
)

Creating an A2A Agent using URL

It is also possible to point directly at the agent URL if it's known to us. This can be useful for tightly coupled systems, private agents, or development purposes, where clients are directly configured with Agent Card information and agent URL.

In this case we construct an A2AAgent directly with the URL of the 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"
)

Using the Agent

The A2A agent supports all standard agent operations.

See the Agent getting started tutorials for more information on how to run and interact with agents.