Enhance knowledge base retrieval instructions

[farzad528]

Added optimized agent instructions for knowledge base retrieval, including a Python template for effective usage and citation formatting.

[prmerger-automator]

@farzad528 : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change. @farzad528

[learn-build-service-prod]

Learn Build status updates of commit aff4987:

✅ Validation status: passed

File	Status	Preview URL	Details
articles/ai-foundry/default/agents/how-to/tools/knowledge-retrieval.md	✅Succeeded

For more details, please refer to the build report.

[Copilot]

Pull Request Overview

This PR enhances the knowledge base retrieval documentation by adding a new section on optimizing agent instructions for knowledge base retrieval. The changes provide developers with a recommended instruction template designed to improve MCP tool invocation rates and ensure proper citation formatting, along with explanatory guidance on why the template is effective.

Key changes:

• Added a new "Optimize agent instructions for knowledge base retrieval" section with a Python template showing recommended instruction patterns
• Updated existing code examples in both Python and REST sections to use the optimized instruction template
• Included guidance on customizing instructions for specific use cases

[v-dirichards]

@haileytap

Can you review the proposed changes?

Important: When the changes are ready for publication, adding a #sign-off comment is the best way to signal that the PR is ready for the review team to merge.

#label:"aq-pr-triaged"
@MicrosoftDocs/public-repo-pr-review-team

[haileytap]

Should we convert this code snippet to plain text? Configuring agent instructions isn't specific to Python.

In other words, changing python to plaintext and removing the instructions = """ portion.

[farzad528]

updated

[farzad528]

#sign-off

[prmerger-automator]

Invalid command: '#sign-off'. Only the assigned author of one or more file in this PR can sign off. @haileytap

[v-dirichards]

Hi @farzad528 - Thanks for your review. In the public repo, pull requests should be signed off by the author, another member of the content team, or a PM.

---

@haileytap Could you take a look? Thanks!

[learn-build-service-prod]

Learn Build status updates of commit f946f2c:

✅ Validation status: passed

File	Status	Preview URL	Details
articles/ai-foundry/default/agents/how-to/tools/knowledge-retrieval.md	✅Succeeded

For more details, please refer to the build report.

[learn-build-service-prod]

Learn Build status updates of commit 6cb280f:

✅ Validation status: passed

File	Status	Preview URL	Details
articles/ai-foundry/default/agents/how-to/tools/knowledge-retrieval.md	✅Succeeded

For more details, please refer to the build report.

[haileytap]

#sign-off

[haileytap]

@v-dirichards: By the way, @farzad528 is both a PM and the ms.reviewer for this article. He might want to submit future PRs to the public repo, so I think he should be cleared to sign off. Thanks!