Skip to content

docs: add an agent quickstart built on a greeter example - #550

Merged
muscariello merged 2 commits into
mainfrom
docs/agent-quickstart
Nov 13, 2026
Merged

muscariello merged 2 commits into
mainfrom
docs/agent-quickstart

Conversation

@muscariello

@muscariello muscariello commented Nov 12, 2026 •

Copy link
Copy Markdown
Member

The site has no path from nothing to a running agent.

This adds a seven-page agent quickstart in the shape of the A2A Python tutorial: card, executor, server, calling it with curl, streaming and multi-turn, next steps. The code on the pages is included from a new example, examples/src/quickstart/: a greeter that streams its answer and asks for input when it is only told hello. The hello world example exercises every method for its tests and is not a tutorial, so I left it.

Run on a clean clone of main with this change applied: the cargo run commands and every curl call, with the outputs shown on the pages. The cargo build step, the strict docs build, typos, links, clippy and fmt pass.

Unproven: Windows, and Rust 1.89 itself (I used the current stable). The page asks for 1.89 because the locked dependencies need it.

Closes #527

@codecov

codecov Bot commented Nov 13, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

The site had no way from nothing to a running A2A agent. Add a seven-page
quickstart under docs/quickstart/agent/, in the shape of the A2A Python
tutorial: the agent card, the executor, the server, calling it with curl,
streaming and a conversation over two messages, and next steps.

The code on the pages is included from a new example in the examples
crate, examples/src/quickstart/{agent,server}.rs: a greeter that streams
its answer and asks for input when it is only told "hello". The hello
world example exercises every method for the tests and is not a tutorial,
so it is left as it is.

Closes #527

Signed-off-by: Luca Muscariello <muscariello@ieee.org>
@muscariello
muscariello force-pushed the docs/agent-quickstart branch from 7227bfb to 4936bb2 Compare November 13, 2026 16:43
Comment thread docs/quickstart/agent/executor.md Resolved
Comment thread docs/quickstart/agent/index.md Resolved
The locked dependencies need Rust 1.89 (uuid 1.29.0 is the highest
requirement), more than the 1.85 the workspace declares, so the
quickstart now asks for 1.89.

For a blocking SendMessage the server passes the task it just created in
stored_task, in Submitted state, so the executor page now says to check
the task's state rather than whether stored_task is set.

Signed-off-by: Luca Muscariello <muscariello@ieee.org>

@markpmarton markpmarton left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

LGTM

@muscariello
muscariello added this pull request to the merge queue Nov 13, 2026

@msardara msardara left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

LGTM ✅

Merged via the queue into main with commit 5bf176d Nov 13, 2026
24 checks passed
@muscariello
muscariello deleted the docs/agent-quickstart branch November 13, 2026 17:33
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.

task: write the agent quickstart from examples/helloworld

3 participants