docs: add onboarding page and wire into get-started nav#78
Merged
AaronForinton merged 21 commits intomainfrom Apr 17, 2026
Merged
docs: add onboarding page and wire into get-started nav#78AaronForinton merged 21 commits intomainfrom
AaronForinton merged 21 commits intomainfrom
Conversation
Adds a new get-started/agent-wizard.md page that sits at the top of the Get Started section, before any ADK content. Covers two paths: new users who need to build their first agent via Agent Wizard before using the ADK, and existing Agent Studio users who already have a project to pull down. Explains the concrete wizard→ADK connection: find account_id and project_id in the Agent Studio URL, then run `poly init --account_id ... --project_id ...` and `poly pull` to bring the wizard-generated config down locally. Also updates index.md hero cards and what-is-the-adk.md next steps to surface the new page as an entry point for users without an existing agent. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Fills in missing internal links that were identified in a site-wide audit: - build-an-agent.md: link all 14 resource types in Step 4, link section headings in Step 5 to their reference pages, add anti-patterns tip before Step 5 - anti-patterns.md: add inline links to flows and functions references, add Related pages section - working-locally.md: link all 7 reference syntax table entries to their reference pages; link AI coding tools mention to tooling reference - tutorials/index.md: add card linking to build-an-agent tutorial - what-is-the-adk.md: link AI coding tools to tooling reference; link multi-developer section to multi-user-and-guardrails concept page - agent-wizard.md: add access-and-waitlist link; link poly init and poly pull commands to CLI reference anchors Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
AaronForinton
changed the title
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…eferences Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ent fix Merges the cli.md additions from docs/auto-update-7a1ae59 (PR #83): non-interactive scripted mode, conversation resume, pre-chat push, poly chat flags summary table, and JSON output shape documentation. Fixes one inaccuracy in the flags table: --environment was documented as accepting `draft`, `sandbox`, `live` but the actual CLI choices are `branch`, `sandbox`, `pre-release`, `live`. `draft` is an internal resolved value, not a user-facing argument. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…environment fix" This reverts commit 63c51d6.
`draft` is not a valid user-facing argument — the actual CLI choices are `branch`, `sandbox`, `pre-release`, `live`. `draft` is an internal value resolved from `branch` when the current branch is not main. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…vironment `branch` chats against your current feature branch via the platform's draft environment (/draft/chat API endpoint). On main it falls back to sandbox. Removes misleading "resolves internally" phrasing. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
`branch` uses the deployed branch artifact versions, not local uncommitted changes. Adds a note to use --push to reflect local changes before chatting. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…yai/adk into docs/agent-wizard-onboarding
…only The tip incorrectly stated that quick setup creates flows. It only populates topics (knowledge base entries) and basic agent settings (personality, role, rules). Flows, variants, entities, handoffs, and integrations are not generated — those are built locally with the ADK. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
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
1 participant
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.
Summary
Adds a new
get-started/agent-wizard.mdpage at the top of the Get Started section, before any ADK content. Covers two user paths: new users building their first agent via Agent Wizard, and existing Agent Studio users pulling down an existing project.Motivation
Users arriving at the ADK docs without an existing agent had no clear entry point. Agent Wizard is the fastest way to create one, but there was no documentation connecting the two products.
Closes #
Changes
docs/docs/get-started/agent-wizard.md— new user onboarding via Agent Wizard, including the concretepoly init --account_id ... --project_id ...+poly pullhandoff to local developmentmkdocs.yml— new page added as first item in Get Started navindex.md— hero card updated to surface Agent Wizard as the entry point for users without an agentwhat-is-the-adk.md— next steps now includes a card pointing to the Agent Wizard pageTest strategy
poly <command>)Checklist
ruff check .andruff format --check .passpytestpassespolyCLI interface (or migration path documented)Screenshots / Logs