Skip to content

Conversation

@IsaacEldridge
Copy link
Contributor

No description provided.

…to A2A protocol details for agents, improving clarity and providing additional context for users.
@IsaacEldridge IsaacEldridge requested a review from a team as a code owner December 18, 2025 19:11

== A2A Protocol

Agent networks use the A2A specification 0.3.0. Brokers use the A2A protocol to accept requests to reach other agents.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would rephrase this entire statement. It's not the agent network that uses A2A, as the network also contain other components such as MCP servers and LLMs.

It's also not just the brokers that use A2A, all the agents (broker or not) must be A2A enabled not only to be orchestrated but also to be observed and governed


=== Context and Task ID Scoping in Agent Networks

In the A2A protocol, the server (the agent receiving the request) always generates the `contextId` and `taskId`. These IDs define the state and scope of a specific conversation between two agents.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the A2A protocol, the server (the agent receiving the request) always generates the contextId and taskId.

Not true. Those IDs are always generated by the server, but the server is not required to always generate them. Our brokers DO always generate them, but that's a property of the broker, not the A2A protocol


In the A2A protocol, the server (the agent receiving the request) always generates the `contextId` and `taskId`. These IDs define the state and scope of a specific conversation between two agents.

When an agent acts as a broker, IDs do not pass through from the upstream client. Each "hop" in a multi-agent network establishes its own unique session.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

When an agent acts as a broker, IDs do not pass through from the upstream client.

Several things here:

  1. I get what you're trying to say here, but I don't think this will be clear to customers. Maybe an example between 3 agents with a picture would be helpful.
  2. This is not true just for brokers but any three-party A2A communication.
  3. We should unifiy the language. The terms conversation, context and session are being used interchengeably and they not necessarilly represent the same thing (e.g: session could be understood as authenticated session). I would stick to the proper A2A term (contextId) or at most conversation

=== Non-Supported Features

Agent network doesn't support the following features in the A2A protocol.
* Task History

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

not true, this is supported


Agent network doesn't support the following features in the A2A protocol.
* Task History
* Push Notifications Config

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

not true, supported


Consider a network with a client and two agents (A and B).

* The IDs used between the client and Agent A are independent of the IDs used between Agent A and Agent B.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

in this example, we should use the term broker instead of agent

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants