Skip to content

Python: docs(python): fix broken sample links in agents READMEs - #14703

Open
Pratik Gandhi (pratikgx) wants to merge 1 commit into
microsoft:mainfrom
pratikgx:python-agents-readme-links
Open

Pratik Gandhi (pratikgx) wants to merge 1 commit into
microsoft:mainfrom
pratikgx:python-agents-readme-links

Conversation

@pratikgx

Copy link
Copy Markdown

Motivation and Context

Four links in the Python agent sample READMEs point to files or folders that were renamed, so they 404 on GitHub.

Description

  • python/samples/getting_started_with_agents/README.md
    • step1a_concurrent_structure_output.py -> step1a_concurrent_structured_outputs.py
    • step4a_handoff_structure_input.py -> step4a_handoff_structured_inputs.py
    • The link text is updated to match the file names.
  • python/samples/getting_started_with_agents/azure_ai_agent/README.md: step7_azure_ai_agent_retrieval.py -> step07_azure_ai_agent_retrieval.py
  • python/samples/getting_started_with_agents/multi_agent_orchestration/README.md: concepts/structured_output/ -> concepts/structured_outputs/

Every relative link in the getting_started_with_agents READMEs now resolves against main.

Contribution Checklist

Markdown only, so no code or tests are affected.

Copilot AI balanced review requested due to automatic review settings November 1, 2026 01:47
@pratikgx
Pratik Gandhi (pratikgx) requested a review from a team as a code owner November 1, 2026 01:47
@semantic-kernel-automation semantic-kernel-automation Bot added python Pull requests for the Python Semantic Kernel documentation labels Nov 1, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

There are no active review issues for the documentation-only sample-link updates.

No open issues 🎉

What changed in this PR

This documentation-only PR fixes four broken links in the Python agent sample READMEs, helping readers find the renamed samples and concepts directory. No runtime code or tests are changed.

Changes:

  • Corrects two orchestration sample links and their display text.
  • Updates the Azure AI agent retrieval sample link to use the zero-padded filename.
  • Fixes the structured outputs concepts directory link.
File Description
python/​samples/​getting_started_with_agents/​README.md Corrects the structured-output and structured-input sample links.
python/​samples/​getting_started_with_agents/​multi_agent_orchestration/​README.md Points to the structured_outputs concepts directory.
python/​samples/​getting_started_with_agents/​azure_ai_agent/​README.md Corrects the retrieval sample filename to step07_azure_ai_agent_retrieval.py.

Review effort: Balanced

This branch was successfully deployed

1 active deployment
github-app-auth — 0fc35e0c Deployed Nov 1, 2026 by pratikgx via add_label #29525
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation python Pull requests for the Python Semantic Kernel

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants