RESOURCES · DOCS · AGENT STUDIO · COOKBOOK

A2A cookbook

Five worked examples for agent cards, capability negotiation, task lifecycle, structured payloads, and failure paths.

Talk to AI Labs All docs

SECTION

Cookbook

Where this entry sits in the docs index.

READ TIME

8 min

Pace it for a coffee or a coffee break.

SECTIONS

Each one stands alone and is copy-paste safe.

INSTRUMENT READOUT · COOKBOOK

THE WALKTHROUGH

What you will actually do.

STEP 01

↳ COOKBOOK

Five contract recipes

A2A support starts with card inspection and offline contract tests. Paste a card JSON, load a card URL, or point the CLI at a fixture.

Validate required card fields and endpoint reachability.

↳ CHECK

Simulate capability negotiation for a coding task.

↳ CHECK

Check task lifecycle transitions from created to completed.

↳ CHECK

Validate structured payload schemas and error bodies.

↳ CHECK

Export a contract-test report to CI.

↳ CHECK

↳ COMMANDS

agentstudio a2a validate ./agent-card.json --transcript ./fixtures/task.json
agentstudio a2a run ./agent-card.json --format junit --out reports/a2a.xml

← PREVIOUS

MCP cookbook

OTEL ingest cookbook

COOKBOOK

Next time, it's already a replay.

The path you just read becomes the path you can repeat. One trace, one artifact, one gate the next release has to clear.

Talk to AI Labs All docs