Repository navigation
docs: add an agent quickstart built on a greeter example - #550
Merged
Merged
Conversation
muscariello
force-pushed
the
docs/agent-quickstart
branch
from
November 13, 2026 14:57
d2560ce to
7227bfb
Compare
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
force-pushed
the
docs/agent-quickstart
branch
from
November 13, 2026 16:43
7227bfb to
4936bb2
Compare
markpmarton
requested changes
Nov 13, 2026
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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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 toldhello. 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
mainwith this change applied: thecargo runcommands and everycurlcall, with the outputs shown on the pages. Thecargo buildstep, 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