docs(ai): standardize connection, project, routine, skill, and toolbox help - #10104
Open
FanH (Siglud) wants to merge 7 commits into
Open
FanH (Siglud) wants to merge 7 commits into
FanH (Siglud) wants to merge 7 commits into
Conversation
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Restore core and shared documentation to main. Keep the agent formatter canonical and generate self-contained sibling copies, including builder, with extension-owned drift coverage. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
|
Azure Pipelines: Successfully started running 15 pipeline(s). 10 pipeline(s) were filtered out due to trigger conditions. There may be pipelines that require an authorized user to comment /azp run to run. |
FanH (Siglud)
added
ext-agents
Build the projects recording binary and switch both extensions after production Tier 0 tests. Agent init delegates to project add, which otherwise bypasses the playback proxy. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
FanH (Siglud)
removed
ext-finetune
|
Azure Pipelines: Successfully started running 1 pipeline(s). |
Contributor
Author
|
CI follow-up: the projects Windows ARM64 cross-build now passes on the targeted rerun without source changes (Azure Pipelines build 6866213, same head 64ad13b). Other jobs in that pipeline are still finishing. The agent playback failure is a separate baseline workflow defect. To preserve this PR's five-extension scope, the one-workflow fix is prepared in Siglud#11; its fresh hosted test run passes both production Tier 0 and playback Tier 1: https://github.com/Siglud/azure-dev/actions/runs/35691981986 . That workflow fix must be submitted and merged upstream separately before this PR can pick it up. No tests or checks were bypassed. |
FanH (Siglud)
marked this pull request as ready for review
September 22, 2026 06:42
|
Azure Pipelines: Successfully started running 6 pipeline(s). 19 pipeline(s) were filtered out due to trigger conditions. There may be pipelines that require an authorized user to comment /azp run to run. |
Contributor
There was a problem hiding this comment.
Copilot review overview
🟡 Changes recommended
All five root help sections document endpoint precedence that differs from the current GetValue shell-fallback behavior.
Get a fresh assessment by requesting another Copilot review.
Review effort: Balanced
Findings: 5
Open (5)
What changed in this PR
Standardizes help rendering across five Foundry extensions, following the established agent-help conventions.
Changes:
- Adds shared generated help formatting, examples, and environment guidance.
- Adds snapshots and regression tests for 60 public help pages.
- Documents formatter ownership and regeneration.
| File | Description |
|---|---|
cli/azd/extensions/azure.ai.connections/README.md |
Links help-authoring guidance. |
cli/azd/extensions/azure.ai.connections/docs/help-authoring.md |
Documents formatter maintenance. |
cli/azd/extensions/azure.ai.connections/go.mod |
Updates direct test/formatter dependencies. |
cli/azd/extensions/azure.ai.connections/internal/cmd/connection.go |
Adds command examples. |
cli/azd/extensions/azure.ai.connections/internal/cmd/context.go |
Adds context example. |
cli/azd/extensions/azure.ai.connections/internal/cmd/help.go |
Adds root help guidance. |
cli/azd/extensions/azure.ai.connections/internal/cmd/help_test.go |
Tests command-tree help. |
cli/azd/extensions/azure.ai.connections/internal/cmd/root.go |
Installs the formatter. |
cli/azd/extensions/azure.ai.connections/internal/cmd/testdata/TestAIHelp-context.snap |
Records context help. |
cli/azd/extensions/azure.ai.connections/internal/cmd/testdata/TestAIHelp-create.snap |
Records create help. |
cli/azd/extensions/azure.ai.connections/internal/cmd/testdata/TestAIHelp-delete.snap |
Records delete help. |
cli/azd/extensions/azure.ai.connections/internal/cmd/testdata/TestAIHelp-list.snap |
Records list help. |
cli/azd/extensions/azure.ai.connections/internal/cmd/testdata/TestAIHelp-root.snap |
Records root help. |
cli/azd/extensions/azure.ai.connections/internal/cmd/testdata/TestAIHelp-show.snap |
Records show help. |
cli/azd/extensions/azure.ai.connections/internal/cmd/testdata/TestAIHelp-update.snap |
Records update help. |
cli/azd/extensions/azure.ai.connections/internal/cmd/testdata/TestAIHelp-version.snap |
Records version help. |
cli/azd/extensions/azure.ai.connections/internal/cmd/version.go |
Adds version example. |
cli/azd/extensions/azure.ai.connections/internal/helpformat/generate_test.go |
Checks generated-copy drift. |
cli/azd/extensions/azure.ai.connections/internal/helpformat/helpformat.go |
Implements canonical formatter. |
cli/azd/extensions/azure.ai.connections/internal/helpformat/helpformat_test.go |
Tests formatter behavior. |
cli/azd/extensions/azure.ai.connections/internal/helpformat/internal/generate/main.go |
Generates sibling copies. |
cli/azd/extensions/azure.ai.connections/internal/helpformat/internal/generate/main_test.go |
Tests generator scope. |
cli/azd/extensions/azure.ai.projects/go.mod |
Updates formatter dependencies. |
cli/azd/extensions/azure.ai.projects/internal/cmd/context.go |
Adds context example. |
cli/azd/extensions/azure.ai.projects/internal/cmd/help.go |
Adds root help guidance. |
cli/azd/extensions/azure.ai.projects/internal/cmd/help_test.go |
Tests command-tree help. |
cli/azd/extensions/azure.ai.projects/internal/cmd/project_add.go |
Adds project examples. |
cli/azd/extensions/azure.ai.projects/internal/cmd/project_deployment_add.go |
Adds deployment examples. |
cli/azd/extensions/azure.ai.projects/internal/cmd/project_unset.go |
Adds unset example. |
cli/azd/extensions/azure.ai.projects/internal/cmd/root.go |
Installs the formatter. |
cli/azd/extensions/azure.ai.projects/internal/cmd/testdata/TestAIHelp-add.snap |
Records add help. |
cli/azd/extensions/azure.ai.projects/internal/cmd/testdata/TestAIHelp-context.snap |
Records context help. |
cli/azd/extensions/azure.ai.projects/internal/cmd/testdata/TestAIHelp-deployment.snap |
Records deployment help. |
cli/azd/extensions/azure.ai.projects/internal/cmd/testdata/TestAIHelp-deployment_add.snap |
Records deployment-add help. |
cli/azd/extensions/azure.ai.projects/internal/cmd/testdata/TestAIHelp-root.snap |
Records root help. |
cli/azd/extensions/azure.ai.projects/internal/cmd/testdata/TestAIHelp-set.snap |
Records set help. |
cli/azd/extensions/azure.ai.projects/internal/cmd/testdata/TestAIHelp-show.snap |
Records show help. |
cli/azd/extensions/azure.ai.projects/internal/cmd/testdata/TestAIHelp-unset.snap |
Records unset help. |
cli/azd/extensions/azure.ai.projects/internal/cmd/testdata/TestAIHelp-version.snap |
Records version help. |
cli/azd/extensions/azure.ai.projects/internal/cmd/version.go |
Adds version example. |
cli/azd/extensions/azure.ai.projects/internal/helpformat/helpformat.go |
Adds generated formatter copy. |
cli/azd/extensions/azure.ai.routines/go.mod |
Updates formatter dependencies. |
cli/azd/extensions/azure.ai.routines/internal/cmd/context.go |
Adds context example. |
cli/azd/extensions/azure.ai.routines/internal/cmd/help.go |
Adds root help guidance. |
cli/azd/extensions/azure.ai.routines/internal/cmd/help_test.go |
Tests command-tree help. |
cli/azd/extensions/azure.ai.routines/internal/cmd/root.go |
Installs the formatter. |
cli/azd/extensions/azure.ai.routines/internal/cmd/routine_add.go |
Improves add example. |
cli/azd/extensions/azure.ai.routines/internal/cmd/routine_create.go |
Adds create examples. |
cli/azd/extensions/azure.ai.routines/internal/cmd/routine_delete.go |
Adds delete example. |
cli/azd/extensions/azure.ai.routines/internal/cmd/routine_disable.go |
Adds disable example. |
cli/azd/extensions/azure.ai.routines/internal/cmd/routine_dispatch.go |
Adds dispatch example. |
cli/azd/extensions/azure.ai.routines/internal/cmd/routine_enable.go |
Adds enable example. |
cli/azd/extensions/azure.ai.routines/internal/cmd/routine_list.go |
Adds list examples. |
cli/azd/extensions/azure.ai.routines/internal/cmd/routine_run.go |
Adds run examples. |
cli/azd/extensions/azure.ai.routines/internal/cmd/routine_show.go |
Adds show example. |
cli/azd/extensions/azure.ai.routines/internal/cmd/routine_update.go |
Adds update example. |
cli/azd/extensions/azure.ai.routines/internal/cmd/testdata/TestAIHelp-add.snap |
Records add help. |
cli/azd/extensions/azure.ai.routines/internal/cmd/testdata/TestAIHelp-context.snap |
Records context help. |
cli/azd/extensions/azure.ai.routines/internal/cmd/testdata/TestAIHelp-create.snap |
Records create help. |
cli/azd/extensions/azure.ai.routines/internal/cmd/testdata/TestAIHelp-delete.snap |
Records delete help. |
cli/azd/extensions/azure.ai.routines/internal/cmd/testdata/TestAIHelp-disable.snap |
Records disable help. |
cli/azd/extensions/azure.ai.routines/internal/cmd/testdata/TestAIHelp-dispatch.snap |
Records dispatch help. |
cli/azd/extensions/azure.ai.routines/internal/cmd/testdata/TestAIHelp-enable.snap |
Records enable help. |
cli/azd/extensions/azure.ai.routines/internal/cmd/testdata/TestAIHelp-list.snap |
Records list help. |
cli/azd/extensions/azure.ai.routines/internal/cmd/testdata/TestAIHelp-root.snap |
Records root help. |
cli/azd/extensions/azure.ai.routines/internal/cmd/testdata/TestAIHelp-run.snap |
Records run-group help. |
cli/azd/extensions/azure.ai.routines/internal/cmd/testdata/TestAIHelp-run_list.snap |
Records run-list help. |
cli/azd/extensions/azure.ai.routines/internal/cmd/testdata/TestAIHelp-show.snap |
Records show help. |
cli/azd/extensions/azure.ai.routines/internal/cmd/testdata/TestAIHelp-update.snap |
Records update help. |
cli/azd/extensions/azure.ai.routines/internal/cmd/testdata/TestAIHelp-version.snap |
Records version help. |
cli/azd/extensions/azure.ai.routines/internal/cmd/version.go |
Adds version example. |
cli/azd/extensions/azure.ai.routines/internal/helpformat/helpformat.go |
Adds generated formatter copy. |
cli/azd/extensions/azure.ai.skills/go.mod |
Adds snapshot dependency. |
cli/azd/extensions/azure.ai.skills/internal/cmd/context.go |
Adds context example. |
cli/azd/extensions/azure.ai.skills/internal/cmd/help.go |
Adds root help guidance. |
cli/azd/extensions/azure.ai.skills/internal/cmd/help_test.go |
Tests command-tree help. |
cli/azd/extensions/azure.ai.skills/internal/cmd/root.go |
Installs the formatter. |
cli/azd/extensions/azure.ai.skills/internal/cmd/skill_create.go |
Expands create examples. |
cli/azd/extensions/azure.ai.skills/internal/cmd/skill_delete.go |
Adds delete examples. |
cli/azd/extensions/azure.ai.skills/internal/cmd/skill_download.go |
Adds download examples. |
cli/azd/extensions/azure.ai.skills/internal/cmd/skill_list.go |
Adds list examples. |
cli/azd/extensions/azure.ai.skills/internal/cmd/skill_show.go |
Adds show example. |
cli/azd/extensions/azure.ai.skills/internal/cmd/skill_update.go |
Expands update examples. |
cli/azd/extensions/azure.ai.skills/internal/cmd/testdata/TestAIHelp-context.snap |
Records context help. |
cli/azd/extensions/azure.ai.skills/internal/cmd/testdata/TestAIHelp-create.snap |
Records create help. |
cli/azd/extensions/azure.ai.skills/internal/cmd/testdata/TestAIHelp-delete.snap |
Records delete help. |
cli/azd/extensions/azure.ai.skills/internal/cmd/testdata/TestAIHelp-download.snap |
Records download help. |
cli/azd/extensions/azure.ai.skills/internal/cmd/testdata/TestAIHelp-list.snap |
Records list help. |
cli/azd/extensions/azure.ai.skills/internal/cmd/testdata/TestAIHelp-root.snap |
Records root help. |
cli/azd/extensions/azure.ai.skills/internal/cmd/testdata/TestAIHelp-show.snap |
Records show help. |
cli/azd/extensions/azure.ai.skills/internal/cmd/testdata/TestAIHelp-update.snap |
Records update help. |
cli/azd/extensions/azure.ai.skills/internal/cmd/testdata/TestAIHelp-version.snap |
Records version help. |
cli/azd/extensions/azure.ai.skills/internal/cmd/version.go |
Adds version example. |
cli/azd/extensions/azure.ai.skills/internal/helpformat/helpformat.go |
Adds generated formatter copy. |
cli/azd/extensions/azure.ai.toolboxes/go.mod |
Updates formatter dependencies. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/help.go |
Adds root help guidance. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/help_test.go |
Tests command-tree help. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/root.go |
Installs the formatter. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/testdata/TestAIHelp-add.snap |
Records add help. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/testdata/TestAIHelp-add_connection.snap |
Records local connection help. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/testdata/TestAIHelp-add_skill.snap |
Records local skill help. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/testdata/TestAIHelp-connection.snap |
Records connection-group help. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/testdata/TestAIHelp-connection_add.snap |
Records connection-add help. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/testdata/TestAIHelp-connection_list.snap |
Records connection-list help. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/testdata/TestAIHelp-connection_remove.snap |
Records connection-remove help. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/testdata/TestAIHelp-create.snap |
Records create help. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/testdata/TestAIHelp-delete.snap |
Records delete help. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/testdata/TestAIHelp-list.snap |
Records list help. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/testdata/TestAIHelp-publish.snap |
Records publish help. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/testdata/TestAIHelp-root.snap |
Records root help. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/testdata/TestAIHelp-show.snap |
Records show help. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/testdata/TestAIHelp-skill.snap |
Records skill-group help. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/testdata/TestAIHelp-skill_add.snap |
Records skill-add help. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/testdata/TestAIHelp-skill_list.snap |
Records skill-list help. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/testdata/TestAIHelp-skill_remove.snap |
Records skill-remove help. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/testdata/TestAIHelp-version.snap |
Records version help. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/testdata/TestAIHelp-versions.snap |
Records versions-group help. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/testdata/TestAIHelp-versions_list.snap |
Records versions-list help. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_add.go |
Adds local-edit examples. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_connection.go |
Adds connection-group examples. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_connection_add.go |
Restructures connection-add help. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_connection_list.go |
Adds list example. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_connection_remove.go |
Restructures removal examples. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_create.go |
Restructures create help. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_delete.go |
Adds delete examples. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_help.go |
Standardizes section headings. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_list.go |
Adds list example. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_publish.go |
Adds publish example. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_show.go |
Adds show examples. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_skill_add.go |
Restructures skill-add help. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_skill_group.go |
Adds skill-group examples. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_skill_list.go |
Adds list example. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_skill_remove.go |
Restructures removal examples. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_version.go |
Adds versions-group example. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_version_list.go |
Adds version-list example. |
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/version.go |
Adds extension-version example. |
cli/azd/extensions/azure.ai.toolboxes/internal/helpformat/helpformat.go |
Adds generated formatter copy. |
Files not reviewed (2)
- cli/azd/extensions/azure.ai.connections/internal/helpformat/generate_test.go: Generated file
- cli/azd/extensions/azure.ai.connections/internal/helpformat/internal/generate/main.go: Generated file
💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Comment on lines
+12
to
+15
| --project-endpoint overrides endpoint discovery. Otherwise, commands | ||
| resolve FOUNDRY_PROJECT_ENDPOINT (or legacy AZURE_AI_PROJECT_ENDPOINT) | ||
| from the active azd environment, then the global default saved by | ||
| 'azd ai project set <endpoint>', then the same shell variables. |
Comment on lines
+12
to
+16
| 'azd ai project show' resolves FOUNDRY_PROJECT_ENDPOINT in the active | ||
| azd environment, then the default saved by 'azd ai project set <endpoint>' | ||
| in azd global config, then the | ||
| FOUNDRY_PROJECT_ENDPOINT shell variable. The global default is separate | ||
| from environment values; 'azd ai project unset' only clears that default. |
Comment on lines
+12
to
+16
| --project-endpoint overrides endpoint discovery. Otherwise, routine | ||
| commands resolve AZURE_AI_PROJECT_ENDPOINT from the active azd | ||
| environment, then the global default saved by | ||
| 'azd ai project set <endpoint>', then the FOUNDRY_PROJECT_ENDPOINT | ||
| shell variable. Legacy agent global context remains a fallback. |
Comment on lines
+12
to
+16
| --project-endpoint overrides endpoint discovery. Otherwise, commands | ||
| resolve FOUNDRY_PROJECT_ENDPOINT (or legacy AZURE_AI_PROJECT_ENDPOINT) | ||
| from the active azd environment, then the global default saved by | ||
| 'azd ai project set <endpoint>', then the same shell variables. | ||
| Legacy skills and agents global context keys remain fallback sources. |
Comment on lines
+12
to
+15
| --project-endpoint overrides endpoint discovery. Otherwise, commands | ||
| resolve FOUNDRY_PROJECT_ENDPOINT (or legacy AZURE_AI_PROJECT_ENDPOINT) | ||
| from the active azd environment, then the global default saved by | ||
| 'azd ai project set <endpoint>', then the same shell variables. |
Glenn Harper (glharper)
left a comment
Glenn Harper (glharper)
left a comment
Member
There was a problem hiding this comment.
Two additional help issues need correction in #10104.
Use --infra=bicep and exercise the real optional-value parser. Describe persisted environment endpoint lookup per namespace, preserving the supported environment overrides for connection delete and project authoring. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Resolve the toolboxes dependency conflict by retaining upstream logr v1.4.4 and the help formatter's direct fatih/color dependency. Preserve the five-extension help scope and review fixes. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Copilot review overview
🔵 Needs a closer look
The broad multi-extension change has inconsistent scope and validation metadata requiring human confirmation.
Review effort: Balanced
Findings: 5
Open (5)
Files not reviewed (2)
- cli/azd/extensions/azure.ai.connections/internal/helpformat/generate_test.go: Generated file
- cli/azd/extensions/azure.ai.connections/internal/helpformat/internal/generate/main.go: Generated file
Contributor
There was a problem hiding this comment.
Copilot review overview
🔵 Needs a closer look
The broad multi-extension formatter, generator, and snapshot changes warrant final human validation.
Review effort: Balanced
Findings: 5
Open (5)
Files not reviewed (2)
- cli/azd/extensions/azure.ai.connections/internal/helpformat/generate_test.go: Generated file
- cli/azd/extensions/azure.ai.connections/internal/helpformat/internal/generate/main.go: Generated file
Contributor
azure.ai.routines PR buildNote This is an unsigned development build. Install it only if you trust this PR. Install the extension: azd ext install "https://azuresdkartifacts.z5.web.core.windows.net/azd/extensions/pr/10104/azure-ai-routines.zip"
|
Contributor
azure.ai.projects PR buildNote This is an unsigned development build. Install it only if you trust this PR. Install the extension: azd ext install "https://azuresdkartifacts.z5.web.core.windows.net/azd/extensions/pr/10104/azure-ai-projects.zip"
|
Contributor
azure.ai.connections PR buildNote This is an unsigned development build. Install it only if you trust this PR. Install the extension: azd ext install "https://azuresdkartifacts.z5.web.core.windows.net/azd/extensions/pr/10104/azure-ai-connections.zip"
|
Contributor
azure.ai.skills PR buildNote This is an unsigned development build. Install it only if you trust this PR. Install the extension: azd ext install "https://azuresdkartifacts.z5.web.core.windows.net/azd/extensions/pr/10104/azure-ai-skills.zip"
|
Contributor
azure.ai.toolboxes PR buildNote This is an unsigned development build. Install it only if you trust this PR. Install the extension: azd ext install "https://azuresdkartifacts.z5.web.core.windows.net/azd/extensions/pr/10104/azure-ai-toolboxes.zip"
|
This branch has not been deployed
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.
Fixes #8506 .
Summary
Follow the agent-help conventions already delivered in #10057 for the five remaining requested extension command trees:
azd ai connection,project,routine,skill, andtoolbox.No changes to the agents extension. Its help was already delivered; the earlier formatter/generator restructuring in that folder has been removed from this PR.
Strict scope
All 137 changed paths are confined to these folders:
cli/azd/extensions/azure.ai.connections/cli/azd/extensions/azure.ai.projects/cli/azd/extensions/azure.ai.routines/cli/azd/extensions/azure.ai.skills/cli/azd/extensions/azure.ai.toolboxes/There are no changes to agents, other extensions, shared files outside those folders, workflows, core help, or the public SDK. The previously merged agent implementation and its 51 snapshots remain unchanged.
Implementation
UsageFuncflag overrides, injected writers, offline help rendering, and specialized examples.go.sumchanges, local replacements, or committed workspaces.From
cli/azd/extensions/azure.ai.connections:go generate ./internal/helpformat go test ./internal/helpformat/...Shared SDK reuse remains a deferred refactor, not a prerequisite for this PR.
Validation
On commit
64ad13bf33868625583ffdaf21ac853e2cc81ab4, with Go 1.26.4 andGOWORK=off, all five standalone builds, full command/help test suites, formatter/generator regressions, targeted lint, retained production Go/docs spelling, and diff checks pass. Coverage includes all 60 retained public help pages. The published file list has been checked against the exact five-folder allowlist; agent and workflow trees match basec8f657e.Known baseline CI limitation
The prior playback workflow fix (
e13f1c5) is removed to respect the explicit folder scope. The unchanged main workflow can still failTest_AIAgent_Init_NoPrompt_WithProjectbecause it uses a production projects binary during playback. This baseline failure was reproduced on main in run 35559011106; projects changes trigger that workflow even though this PR no longer modifies agents. The fix is preserved in commit history for separate delivery. No test is disabled or weakened.Related to #8506; follows #10057.
UI Preview
Before:
After:
