Skip to content

Reframe AI function calling article around MEAI tool calling abstractions#51999

Open
Copilot wants to merge 6 commits intomainfrom
copilot/update-ai-docs-scope-and-terminology
Open

Reframe AI function calling article around MEAI tool calling abstractions#51999
Copilot wants to merge 6 commits intomainfrom
copilot/update-ai-docs-scope-and-terminology

Conversation

Copy link
Contributor

Copilot AI commented Mar 3, 2026

  • Analyze existing article and related documentation
  • Create new understanding-ai-tools.md article focused on MEAI and provider-agnostic tool calling
  • Add redirect from old understanding-openai-functions.md URL to new article
  • Update the TOC entry from "OpenAI function calling" to "AI tool calling"
  • Rename file to ai-tools.md
  • Update title frontmatter to "AI tool calling"
  • Update H1 heading to # AI tool calling
  • Remove standalone MEAI intro paragraph
  • Rename "Call functions" TOC section and child items to use "tools" language
  • Add redirect_document_id: true to redirect entry
Original prompt

This section details on the original issue you should resolve

<issue_title>Address feedback from Jeremy in AI docs</issue_title>
<issue_description>- Should this article be less scoped to Open AI and more focused on MEAI and the ways we can manage functions across all providers, not specifically just OpenAI?

  • Should we consider adoptiong the phrase "tools" moving forward and deprecate the functions language to avoid confusion? I'm confident anytime we discuss "functions" we're talking about tools that the agent or model uses.

Originally posted by @JeremyLikness in #51536 (comment)
</issue_description>

Comments on the Issue (you are @copilot in this section)


🔒 GitHub Advanced Security automatically protects Copilot coding agent pull requests. You can protect all pull requests by enabling Advanced Security for your repositories. Learn more about Advanced Security.


Internal previews

📄 File 🔗 Preview link
docs/ai/conceptual/ai-tools.md AI tool calling
docs/ai/toc.yml docs/ai/toc

…cle with MEAI-focused tools article

Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Copilot AI changed the title [WIP] Address feedback from Jeremy in AI docs Reframe AI function calling article around MEAI tool calling abstractions Mar 3, 2026
@gewarren gewarren marked this pull request as ready for review March 4, 2026 01:53
@gewarren gewarren requested a review from a team as a code owner March 4, 2026 01:53
…d remove MEAI intro paragraph

Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR replaces an OpenAI-specific “function calling” conceptual article with a provider-agnostic “tool calling” overview centered on Microsoft.Extensions.AI abstractions, and updates navigation and redirects to preserve the old URL.

Changes:

  • Add a new conceptual article, understanding-ai-tools.md, explaining tool calling in MEAI (including key types, parallel calling, and token considerations).
  • Remove the old OpenAI-scoped article and add a redirection from the old path to the new conceptual URL.
  • Update the AI docs TOC to point to the new conceptual article and rename the TOC entry.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File Description
docs/ai/toc.yml Updates the Concepts TOC entry to “AI tool calling” and points it to the new conceptual article.
docs/ai/conceptual/understanding-openai-functions.md Removes the prior OpenAI-specific conceptual content (replaced by a provider-agnostic article).
docs/ai/conceptual/understanding-ai-tools.md Introduces a MEAI-centric, provider-agnostic conceptual overview of tool calling.
.openpublishing.redirection.ai.json Adds a redirect from the removed conceptual file path to the new published URL.

You can also share your feedback on Copilot code review. Take the survey.

gewarren and others added 2 commits March 3, 2026 17:58
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
…ect entry

Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Added explanation of tool calling and its benefits.
@gewarren gewarren enabled auto-merge (squash) March 4, 2026 02:03
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.

Address feedback from Jeremy in AI docs

3 participants