Skip to content

docs(integrations): document Go support for Agent Registry - #2123

Draft
wolo-lab wants to merge 1 commit into
google:mainfrom
wolo-lab:wolo/agent-registry-go
Draft

docs(integrations): document Go support for Agent Registry#2123
wolo-lab wants to merge 1 commit into
google:mainfrom
wolo-lab:wolo/agent-registry-go

Conversation

@wolo-lab

@wolo-lab wolo-lab commented Aug 12, 2026

Copy link
Copy Markdown

Summary

docs/integrations/agent-registry.md documented Python only. The Agent Registry
client landed in adk-go v2.1.0 as google.golang.org/adk/v2/agentregistry,
covering the same surface the page already describes for Python (discovery of
registered A2A agents, MCP servers and model endpoints, plus factory helpers that
turn a registry record into an agent or a toolset). This adds Go tabs throughout
and advertises Go support in the page badge.

What's in it

  • lst-go badge at Go v2.1.0. The page had no prior Go content, so that is the
    version support was introduced.
  • Python/Go tabs on Installation, Use with Agent, Remote A2A Agents, Google MCP
    Servers, API Reference and Configuration Options, following the pattern used by
    cloud-trace.md, mcp-toolbox-for-databases.md and reflect-and-retry.md.
  • The Go content covers agentregistry.New and its Config, the
    List*/Get*/All* discovery triple, RemoteAgent, MCPToolset, and the
    egress options WithA2AHTTPClient, WithA2AHeaders, WithMCPHTTPClient and
    WithMCPHeaders.
  • The Prerequisites bullet that named google-adk is now language-neutral and
    points at Installation.
  • Additional resources gains the Go sample directory and the pkg.go.dev
    reference; the two existing Python entries are labelled as such.

Staged: https://deploy-preview-2123--adk-docs-preview.netlify.app/integrations/agent-registry/

Notes for reviewers

  • One drive-by fix outside the Go content. In Configuration Options, the
    Python RemoteA2aAgent link pointed at /a2a/quickstart-consuming-go/. It now
    points at /a2a/quickstart-consuming/. Both pages carry the same anchor, which
    is why this never showed up as a broken link, but it was sending Python readers
    to the Go quickstart. Happy to split it out if you would rather keep this PR to
    Go content only.
  • Egress auth genuinely differs between the two languages, and the page now
    says so.
    In Go, only *.googleapis.com MCP endpoints reuse the registry
    client's Application Default Credentials, and A2A egress is never authenticated
    for you. That is why the Go tabs document WithA2AHTTPClient and
    WithMCPHTTPClient where the Python tabs document httpx_client and
    header_provider.
  • ### Required dependencies now sits inside the Python tab, since the
    a2a and agent-identity extras have no Go equivalent. It still appears in the
    page ToC, matching how mcp-toolbox-for-databases.md nests headings in tabs.

Verification

  • The Go sample compiles and vets against google.golang.org/adk/v2@v2.1.0.
  • mkdocs build --strict is clean. Tabs and both language badges render, and the
    internal link anchors resolve in the built site.
  • Checked against the integration-review rules: single-line language-support
    div, tabbed multi-language code, site-relative internal links, *-latest model
    string, no new nav entry needed.

The Agent Registry page was Python-only, even though the Go client shipped
in ADK Go v2.1.0 as google.golang.org/adk/v2/agentregistry, so Go users had
no documented way to discover registered agents and MCP servers.

Add the Go language-support tag and a Go tab alongside Python in
Installation, Use with Agent, both authentication sections, API Reference,
and Configuration Options, following the tabbed pattern used by the other
multi-language integration pages. Also repoint the Python RemoteA2aAgent
link at the Python A2A quickstart, which the Go quickstart had replaced.
@netlify

netlify Bot commented Aug 12, 2026

Copy link
Copy Markdown

Deploy Preview for adk-docs-preview ready!

Name Link
🔨 Latest commit ef356ab
🔍 Latest deploy log https://app.netlify.com/projects/adk-docs-preview/deploys/6a7ca51bd11b3700087d057c
😎 Deploy Preview https://deploy-preview-2123--adk-docs-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

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.

1 participant