Skip to content

Python: Docs: Broken external links in Python samples and docs (11 dead URLs) #8089

Description

@Shxiao101

A link check across the repo found 11 dead external URLs (12 occurrences) in 3 files. Each was verified with HTTP requests (404) and each suggested replacement was verified live (200):

# File Dead URL Working replacement
1 python/samples/04-hosting/foundry-hosted-agents/responses/foundry_toolbox/README.md L7, L226 Azure/azure-sdk-for-python/blob/main/sdk/ai/azure-ai-projects/samples/hosted_agents/sample_toolboxes_crud.py same repo, samples/toolboxes/sample_toolboxes_crud.py (samples were reorganized)
2 same file L24 microsoft-foundry/foundry-samples/.../SUPPORTED_TOOLBOX_SCENARIOS.md#5-mcp-no-auth .../SUPPORTED_TOOLBOX_SCENARIOS/tools/mcp-unauthenticated.md
3 same file L25 ...#4-mcp-key-auth-github .../tools/mcp-key-auth.md
4 same file L26 ...#6-mcp-oauth-managed-connector .../tools/mcp-oauth-managed.md
5 same file L27 ...#8-mcp-agent-identity .../tools/mcp-microsoft-entra.md
6 same file L28 ...#13-mcp-oauth-entra-passthrough .../tools/mcp-user-entra-token.md
7 same file L30 .../SUPPORTED_TOOLBOX_SCENARIOS.md (plain) .../SUPPORTED_TOOLBOX_SCENARIOS/README.md
8 same file L134 microsoft/GitHub-Copilot-for-Azure/blob/main/plugin/skills/.../toolbox-reference.md .../plugins/azure-skills/skills/microsoft-foundry/foundry-agent/toolbox/toolbox.md (skill tree reorganized; covers endpoint format & MCP protocol)
9 same file L135 .../plugin/skills/.../use-toolbox-in-hosted-agent.md .../plugins/azure-skills/skills/.../create/references/use-toolbox-in-hosted-agent.md
10 python/packages/chatkit/README.md L5 openai/chatkit-python/blob/main/docs/server.md#agents-sdk-integration .../docs/quickstart.md#generate-model-responses (docs restructured; same Agents SDK helpers incl. stream_agent_response)
11 docs/decisions/0033-feature-usage-bitmask-user-agent.md L535 googleapis/python-api-core/blob/main/google/api_core/client_info.py googleapis/google-cloud-python/blob/main/packages/google-api-core/google/api_core/client_info.py (package moved into the monorepo)

Notes:

  • SUPPORTED_TOOLBOX_SCENARIOS.md became a directory of per-scenario guides; the five anchors above map 1:1 to the new guide files (MCP no-auth / key-auth / managed OAuth / agent identity / Entra user-token pass-through).
  • python/CHANGELOG.md also references PR Python: fix(workflows): preserve all trace contexts in FanInEdgeRunner aggregation #7557, which does not exist in this repo (likely a wrong number); I could not identify the correct PR, so it is left out of scope.

Happy to send a PR fixing all of these.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    pythonUsage: [Issues, PRs], Target: PythontriageUsage: [Issues], Target: All issues that still need to be triaged

    Type

    No type

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions