Repository navigation
Python: Fix sample README run commands that reference missing files - #9580
Draft
Naveen Chatlapalli (1aifanatic) wants to merge 1 commit into
Draft
Naveen Chatlapalli (1aifanatic) wants to merge 1 commit into
Naveen Chatlapalli (1aifanatic) wants to merge 1 commit into
Conversation
The Azure AI Search context provider README told readers to run
azure_ai_with_search_context_{semantic,agentic}.py, and the agentic
sample's docstring pointed to the old semantic filename; the files are
search_context_{semantic,agentic}.py. The declarative agents README
listed openai_responses_agent.py, but the sample is openai_agent.py.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Naveen Chatlapalli (1aifanatic)
deployed
to
github-app-auth
October 21, 2026 14:27 — with
GitHub Actions
Active
Naveen Chatlapalli (1aifanatic)
deployed
to
github-app-auth
October 21, 2026 14:27 — with
GitHub Actions
Active
Contributor
There was a problem hiding this comment.
🟢 Approval recommended
All corrected references match existing files, and the documentation-only changes have no unresolved issues.
No open issues 🎉
What changed in this PR
Corrects broken filename references in Python sample documentation without changing executable behavior.
Changes:
- Fixes three run commands across two READMEs.
- Updates the agentic search sample’s docstring to reference the semantic sample’s current filename.
| File | Description |
|---|---|
python/samples/02-agents/declarative/README.md |
Corrects the OpenAI sample run command. |
python/samples/02-agents/context_providers/azure_ai_search/search_context_agentic.py |
Corrects a filename in the docstring. |
python/samples/02-agents/context_providers/azure_ai_search/README.md |
Corrects semantic and agentic sample run commands. |
Review effort: Balanced
Eduard van Valkenburg (eavanvalkenburg)
approved these changes
Oct 22, 2026
Eduard van Valkenburg (eavanvalkenburg)
left a comment
Member
There was a problem hiding this comment.
The corrected commands and docstring references all match the files present in the sample directories. This is a focused documentation fix with no behavioral concerns.
This branch was successfully 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.
Motivation & Context
Two sample READMEs tell readers to run files that do not exist, so copying the documented command fails with
No such file or directory:python/samples/02-agents/context_providers/azure_ai_search/README.mdrunsazure_ai_with_search_context_semantic.pyandazure_ai_with_search_context_agentic.py. The files in that folder aresearch_context_semantic.pyandsearch_context_agentic.py, which is how the same README's table already links them. The agentic sample's docstring also points to the old semantic filename.python/samples/02-agents/declarative/README.mdlistspython openai_responses_agent.pyunder "Running", but the sample isopenai_agent.py, which is how section 5 of the same README already links it.Description & Review Guide
search_context_agentic.pydocstring.I found these by checking every
python/uv runcommand in sample READMEs against the files on disk. After this change, no references toazure_ai_with_search_context*oropenai_responses_agent.pyremain underpython/samples.Related Issue
N/A - trivial change: these are broken file references in documentation, and each correct name is already used elsewhere in the same README, so the desired result is not in dispute.
AI Assistance
AI assistance details: Claude Code helped write the script that found the broken run commands, make the edits, and draft this description.
Contribution Checklist
breaking changelabel (or add "[BREAKING]" to the title prefix, before or after any language prefix) — a workflow keeps the label and title prefix in sync automatically.🤖 Generated with Claude Code