docs(agent): Update agent docs flwr version to 1.35 - #8001
Conversation
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 5c049382ff
ℹ️ About Codex in GitHub
Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".
|
|
||
| ```{note} | ||
| This tutorial targets Flower 1.34.0. Flower Agent and `flwr chat` are | ||
| This tutorial targets Flower 1.35.0. Flower Agent and `flwr chat` are |
There was a problem hiding this comment.
After retargeting this tutorial to 1.35, its command list still omits /history and lines 129–130 incorrectly state that older run series cannot be restored interactively. The 1.35 CLI registers /history as “Show or continue conversation history” in framework/py/flwr/cli/constant.py:58-64 and handles it in chat_app.py:474-477, so users following the pinned tutorial are unnecessarily directed to the browser instead of the supported CLI workflow.
Useful? React with 👍 / 👎.
| The following `uv run` examples use the Flower version installed in your local | ||
| project environment. To stay consistent with the rest of this guide, ensure | ||
| that environment has `flwr==1.34.0` installed. | ||
| that environment has `flwr==1.35.0` installed. |
There was a problem hiding this comment.
For the newly specified 1.35 environment, lines 89–100 present config editing plus a restart as the only way to change the flwr chat federation and recommend flwr run for frequent switching. Version 1.35 handles /federation directly in framework/py/flwr/cli/chat/chat_app.py:478-509, so this guide now sends users through an obsolete and substantially more disruptive workflow.
Useful? React with 👍 / 👎.
There was a problem hiding this comment.
Pull request overview
Updates Flower Agent documentation from version 1.34.0 to 1.35.0.
Changes:
- Updates CLI pins, dependencies, and runtime references.
- Refreshes
flwr-version-targetsettings and examples. - Notes a documentation nit for the new
/federationworkflow.
Reviewed changes
Copilot reviewed 8 out of 8 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Summary |
|---|---|
agent/docs/source/tutorials/write-your-first-agentapp.md |
Updates dependency and target versions. |
agent/docs/source/tutorials/get-started-with-flower-agent.md |
Updates CLI pins and version output. |
agent/docs/source/tutorials/build-a-collaborative-agent.md |
Updates dependency and target versions. |
agent/docs/source/how-to-guides/use-agents-and-federations.md |
Updates CLI and runtime references; should document the /federation workflow. |
agent/docs/source/how-to-guides/troubleshoot-agent-runs.md |
Updates troubleshooting CLI pins. |
agent/docs/source/how-to-guides/create-automations.md |
Updates runtime version references. |
agent/docs/source/how-to-guides/connect-accounts.md |
Updates connector support version. |
agent/docs/source/explanations/agentapp-runtime.md |
Updates runtime version references. |
Suppressed comments (6)
agent/docs/source/explanations/agentapp-runtime.md:49
- This version update makes the run-series description below inconsistent with the 1.35 CLI: changing federations with
/federationclears the currentseries_id, but the text says the series is reused until only/newor an agent change. Add/federationas another reset condition.
object. The Flower 1.35.0 runtime recognizes:
agent/docs/source/how-to-guides/use-agents-and-federations.md:150
- The 1.35.0 update also makes the statement at lines 143-144 incorrect:
flwr chatnow has/history, which interactively lists saved conversations and lets the user continue one. Replace the old limitation with the/historyworkflow.
run. Flower 1.35.0 rejects account-connector references for a collaborative
agent/docs/source/tutorials/get-started-with-flower-agent.md:10
- Retargeting this tutorial to 1.35.0 leaves its later chat-command and history guidance stale: Flower 1.35 adds
/federationand/history, and/historycan resume a selected run series, so the/command list and the statement that chat cannot restore an older series are now incorrect. Please update those sections to match the pinned CLI.
This tutorial targets Flower 1.35.0. Flower Agent and `flwr chat` are
agent/docs/source/tutorials/get-started-with-flower-agent.md:60
- The command list below is incomplete for the 1.35.0 CLI:
flwr chatnow exposes/federationand/history, but lines 119-121 list only/help,/new, and/quit. Since this section says it lists the available commands, add the two new commands so users can discover federation switching and history continuation.
$ uvx --from flwr==1.35.0 flwr chat
agent/docs/source/tutorials/get-started-with-flower-agent.md:60
- Updating this command to 1.35.0 leaves the limitation at lines 129-130 stale.
flwr chatnow supports/historywith an interactive selector that loads and continues a selected run series, so this tutorial tells users the opposite of the current behavior; replace that paragraph with the/historyworkflow.
$ uvx --from flwr==1.35.0 flwr chat
agent/docs/source/tutorials/get-started-with-flower-agent.md:60
- The 1.35.0
flwr chatimplementation starts in the personal federation and uses/federationto switch federations; it does not select agents from the federation configured in~/.flwr/config.toml. The description at lines 99-100 is therefore inaccurate for this version and should be rewritten to describe the personal default and current federation.
$ uvx --from flwr==1.35.0 flwr chat
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
|
|
||
| ```console | ||
| $ uvx --from flwr==1.34.0 flwr run @publisher/agent supergrid \ | ||
| $ uvx --from flwr==1.35.0 flwr run @publisher/agent supergrid \ |
Summary
This is documentation-only and introduces no behavioral changes. Updates the Flower Agent documentation to reference Flower 1.35.0 instead of 1.34.0, covering CLI commands, dependencies, runtime references, and
flwr-version-targetsettings. This keeps all examples aligned with the latest Flower release.Why
Flower 1.35.0 is now the current release, but the Flower Agent documentation still referenced 1.34.0.
What