What is the A2A (Agent2Agent) protocol?

A2A is the open protocol that lets agents built on different frameworks call each other. Agents publish an Agent Card describing their skills, and other agents read that card to decide whether and how to invoke them.

How do I make my existing agent A2A compliant?

Run super a2a adapt --entrypoint : --framework . SuperOptiX reads your agent's structure, derives its skills, and writes an A2A Agent Card plus a conformant server. Your agent code is not modified.

Which agent frameworks does SuperOptiX support for A2A?

Eight: DSPy, CrewAI, the OpenAI Agents SDK, Pydantic AI, Google ADK, the Claude Agent SDK, DeepAgents and the Microsoft Agent Framework. Adaptation works on agents written directly against those libraries, whether or not SuperOptiX built them.

How conformant is the SuperOptiX A2A implementation?

It records zero failures against the official A2A Technology Compatibility Kit. Every requirement the TCK exercises against the conformance harness passes: 73 of 73 at MUST, 7 of 7 at SHOULD, 4 of 4 at MAY. The TCK also prints a headline percentage of 77.7% at MUST, which counts 25 requirements it cannot exercise here, covering authentication, TLS, Agent Card signing and gRPC.

How do I make my agent more discoverable to other agents?

Optimize the Agent Card text. SuperOptiX scores discovery rate, invocation rate and confusion rate over a query set, then uses GEPA to rewrite skill names, descriptions and tags against that score. Agent behaviour is unchanged.

Is SuperOptiX free and open source?

Yes, under the MIT License. The A2A implementation, the adapt command, the conformance suite, the routing optimizer, the SuperSpec compiler and all eight framework integrations are in the open source package. Install with uv tool install superoptix.

Is there a live A2A agent I can call?

Yes. A SuperOptiX agent runs at https://a2a.superoptix.ai on Google Cloud Run, with its Agent Card published at https://superoptix.ai/.well-known/agent-card.json.

Who builds SuperOptiX?

Superagentic AI, which builds agentic AI infrastructure and offers support and custom engineering engagements.

A2A 1.0, zero TCK failures

A2A Support In SuperOptiX

SuperOptiX implements the A2A 1.0 protocol directly, with zero failures against the official Technology Compatibility Kit: every requirement the TCK exercises against the conformance harness passes, 73 of 73 at MUST. It gives an agent you have already built an A2A interface without asking you to rewrite it, and a live agent runs at a2a.superoptix.ai.

A2A v1 protocol shapeServe with CLIDSPy and Pydantic AI demos

Expose SuperOptiX Agents Over A2A

Serve compiled SuperOptiX agents as A2A-compatible agents with a clean CLI flow instead of custom glue code.

Call External A2A Agents

Connect to remote A2A agents, resolve their Agent Cards, send work, and follow task state through the SuperOptiX protocol layer.

Keep Frameworks Behind One Runtime Layer

DSPy, Pydantic AI, and the rest stay behind a shared runtime bridge so A2A support does not leak framework-specific internals.

A Live Agent You Can Call

SuperOptiX runs a public A2A agent. Its Agent Card is published on this domain and the agent itself is hosted on Google Cloud Run. Both copies of the card are the same JSON document, so discovery and execution cannot disagree.

Published Agent Card

A static file on this domain, so discovery answers immediately whether or not the agent is warm.

superoptix.ai/.well-known/agent-card.json

Same document, served by the running agent:

a2a.superoptix.ai/.well-known/agent-card.json

The Agent

Serves both the 1.0 and 0.3 spec lines from one endpoint, over JSON-RPC and HTTP+JSON.

a2a.superoptix.ai

# HTTP+JSON

curl -X POST https://a2a.superoptix.ai/message:send \

-H 'content-type: application/json' \

-d '{"message":{"role":"ROLE_USER","parts":[{"text":"Does CrewAI support A2A?"}]}}'

# JSON-RPC 0.3 / 1.0 (preferred transport)

curl -X POST https://a2a.superoptix.ai/a2a/jsonrpc \

-H 'content-type: application/json' \

-d '{"jsonrpc":"2.0","id":"1","method":"message/send","params":{"message":{"role":"user","parts":[{"kind":"text","text":"Does CrewAI support A2A?"}]}}}'

The agent exposes two skills, both deterministic. It answers from a static table of runtime capabilities, so it needs no model and no credentials.

OFFICIAL A2A CLI

Call it with a2a

Use the A2A Project's official CLI as a third-party or CI client against the public agent.

The binary is a2a from a2aproject/a2a-cli (v0.2.0). SuperOptiX does not vendor that Go CLI. super agent serve <name> --protocol a2a (and related product adapt/serve flows) stay the product surfaces for running and connecting inside SuperOptiX.

INSTALL

Homebrew (macOS / Linux)
brew tap a2aproject/a2a-cli https://github.com/a2aproject/a2a-clibrew install a2a
WinGet: winget install a2aproject.a2acli
Prebuilt: download from the latest release, extract, put a2a on your PATH.

Docs and source: github.com/a2aproject/a2a-cli

against a2a.superoptix.ai

# fetch the Agent Card

a2a card get -a https://a2a.superoptix.ai

# ask the framework-a2a-readiness skill

a2a send -a https://a2a.superoptix.ai "Does CrewAI support A2A?"

# scripts / CI

a2a card get -a https://a2a.superoptix.ai -o json

a2a send -a https://a2a.superoptix.ai "Does CrewAI support A2A?" -o json

A2A v1 Changes In SuperOptiX

In plain terms, SuperOptiX now speaks the newer A2A v1 language. The card format is updated, the task operations follow the newer method names, and the CLI plus runtime bridge are aligned to that core v1 flow.

A2A v1 Agent Cards

SuperOptiX now uses the v1 Agent Card model, including the newer supported interface layout instead of the older protocol card shape.

A2A v1 Task Methods

The integration follows the v1 method surface such as SendMessage, GetTask, CancelTask, ListTasks, and SubscribeToTask.

A2A v1 CLI Serving

You can expose a compiled agent with a direct command: super agent serve <name> --protocol a2a.

A2A v1 Core Interoperability

SuperOptiX focuses on the core v1 interoperability path first, while richer enterprise features remain a later phase.

Core capabilities

A2A 1.0 Agent Cards, task methods, and JSON-RPC plus HTTP+JSON bindings

Expose a compiled SuperOptiX agent as an A2A server

Call remote A2A agents and follow task state

Serve from the CLI with super agent serve <name> --protocol a2a

Runtime adapters for compiled pipelines, DSPy, and Pydantic AI

Packaged demos you can pull and run

# Serve a compiled agent over A2A

super agent serve developer --protocol a2a

# Install optional A2A support

curl -fsSL https://superoptix.ai/install.sh | SUPEROPTIX_EXTRAS=a2a sh

Beyond the core path

SuperOptiX ships the core A2A interoperability path. The following remain later work, including enterprise-only protocol features.

Signed Agent Cards and richer enterprise security declarations

Push notifications and authenticated extended cards

Multi-tenant routing and additional transports, including gRPC

A complete showcase across every supported agent framework

Start With The Docs, Then Serve An Agent

The cleanest path is to read the A2A introduction, follow the demo guide, then expose a real compiled SuperOptiX agent with the A2A serve command.