Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Get Started with Microsoft Agent Framework A2A

Please install this package via pip:

pip install agent-framework-a2a --pre

A2A Agent Integration

The A2A agent integration enables communication with remote A2A-compliant agents using the standardized A2A protocol. This allows your Agent Framework applications to connect to agents running on different platforms, languages, or services.

A2AAgent (Client)

The A2AAgent class is a client that wraps an A2A Client to connect the Agent Framework with external A2A-compliant agents.

from agent_framework.a2a import A2AAgent

# Connect to a remote A2A agent
a2a_agent = A2AAgent(url="http://remote-agent/a2a")
response = await a2a_agent.run("Hello!")

Breaking change: HTTP clients created by A2AAgent no longer persist response cookies. This prevents one run's cookies from being reused by another run through the same agent. Connection pooling and cleanup of internally created clients are unchanged.

If the remote service requires cookies for authentication, sessions, or load-balancer affinity, explicitly supply an httpx.AsyncClient using http_client=. Its cookie behavior is preserved. Scope that client to the intended authenticated user or security context and manage its lifetime; do not share a user-specific cookie jar across users.

Supplied HTTP clients remain caller-owned even when client= is also provided. Applications that previously relied on the agent closing a supplied HTTP client in that combination must now close it explicitly.

A2AExecutor (Hosting)

The A2AExecutor class bridges local AI agents built with the agent_framework library to the A2A protocol, allowing them to be hosted and accessed by other A2A-compliant clients.

from agent_framework.a2a import A2AExecutor
from a2a.server.apps import A2AStarletteApplication
from a2a.server.request_handlers import DefaultRequestHandler
from a2a.server.tasks import InMemoryTaskStore

# Create an A2A executor for your agent
executor = A2AExecutor(agent=my_agent)

# Set up the request handler and server application
request_handler = DefaultRequestHandler(
    agent_executor=executor,
    task_store=InMemoryTaskStore(),
)

app = A2AStarletteApplication(
    agent_card=my_agent_card,
    http_handler=request_handler,
).build()

Basic Usage Example

See the A2A agent examples which demonstrate:

  • Connecting to remote A2A agents
  • Hosting local agents via A2A protocol
  • Sending messages and receiving responses
  • Handling different content types (text, files, data)
  • Streaming responses and real-time interaction

Security considerations

The hosting example above focuses on protocol wiring and does not add authentication or authorization by itself. Production A2A hosts should protect their HTTP or JSON-RPC entry points with the deployment's normal auth layer and verify that each caller is allowed to access the requested agent, task, or session.

Task, thread, context, and session identifiers used by an A2A host are routing handles, not bearer credentials. Do not rely on client-supplied identifiers alone to select or mutate persisted state; bind them to authenticated user, tenant, or workspace context first.

Metadata

Release files for agent-framework-a2a 1.0.0b261015

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agent-framework-a2a 1.0.0b261015
File Size Uploaded Provenance Actions
agent_framework_a2a-1.0.0b261015.tar.gz 22.5 kB Without provenance Details for agent_framework_a2a-1.0.0b261015.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for agent-framework-a2a 1.0.0b261015
File Interpreter ABI Platform Actions
agent_framework_a2a-1.0.0b261015-py3-none-any.whl Python 3 none any Details for agent_framework_a2a-1.0.0b261015-py3-none-any.whl

Total release size: 45.4 kB

Release files / agent_framework_a2a-1.0.0b261015.tar.gz

Download URL agent_framework_a2a-1.0.0b261015.tar.gz
Size 22.5 kB
Tags Source
SHA-256 checksum
How to use checksums
4a00c101985ce6d7729381e74a93f549e6af5587c547db76e10a8d39d07a9be1
BLAKE2b-256 checksum
How to use checksums
04a0837a12e3b9ce4813351753f410d76b3bc438f5dad9c8789ba3252f1b5ed7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / agent_framework_a2a-1.0.0b261015-py3-none-any.whl

Download URL agent_framework_a2a-1.0.0b261015-py3-none-any.whl
Size 22.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
879b7003a6f1be820a2fbf3905e087e59480e457a301efdd13b336a7cc5a976e
BLAKE2b-256 checksum
How to use checksums
cc1e7f567e4795c73755e92b6bed2c30a9deb412e077364579e7d4e0adf7ba7d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for agent-framework-a2a 1.0.0b261015

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page