Migrate to V1 of the A2A Specification

This is a small guide to migrate your external agents to the v1 release of the a2a specification.

NOTE

This change only applies to agents built outside of the Po platform and added as an external a2a connection. For external agents built within the Po platform, we will update the changes automatically and no further action is necessary.

Agent Card Changes

The following properties have been removed from the agent card:

• url
• preferredTransport
• capabilities.stateTransitionHistory

The following properties have changed:

• additionalInterfaces -> supportedInterfaces
• securitySchemes - Schema has changed. Click here to see an example agent card with the latest schema..

WARNING

Only the changes applicable to the Po platform have been listed. There are potentially other changes of the v1 a2a specification that has been implemented but which do not apply to Po. These changes have not been listed.

Additional Notes

The url property used to contain the url to your preferred transport's endpoint. The preferred transport is no longer explicitly provided, instead all of your transports must be added to the new supportedInterfaces array in order of preference. Thus, your most preferred transport is the first interface in the supportedInterfaces array. This is also the reason preferredTransport is no longer a property of the agent card.