Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Feb 4, 2026

Renames FunctionCallContent.InvocationRequired to InformationalOnly and inverts the polarity. The property now defaults to false (was true), meaning function calls require processing unless explicitly marked as informational.

Changes

  • FunctionCallContent.cs: Renamed property, inverted default value, updated documentation
  • FunctionInvokingChatClient.cs: Updated all 4 usages with proper polarity inversion
  • Tests: Updated test names and assertions in FunctionCallContentTests, FunctionInvokingChatClientTests, and FunctionInvokingChatClientApprovalsTests
  • API manifest & CHANGELOG: Updated accordingly

Migration

// Before
fcc.InvocationRequired           // check if invocation needed
fcc.InvocationRequired = false   // mark as already processed

// After  
!fcc.InformationalOnly           // check if invocation needed
fcc.InformationalOnly = true     // mark as already processed
Original prompt

FunctionCallContent.InvocationRequired should have its polarity inverted and it should be renamed to InformationalOnly. That means for example that code like fcc.InvocationRequired should become !fcc.InformationalOnly and code like fcc.InvocationRequired = false should become fcc.InformationalOnly = true.


💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Microsoft Reviewers: Open in CodeFlow

Co-authored-by: stephentoub <2642209+stephentoub@users.noreply.github.com>
Copilot AI changed the title [WIP] Invert polarity of InvocationRequired and rename to InformationalOnly Rename FunctionCallContent.InvocationRequired to InformationalOnly with inverted polarity Feb 4, 2026
Copilot AI requested a review from stephentoub February 4, 2026 13:47
@stephentoub stephentoub marked this pull request as ready for review February 4, 2026 14:27
@stephentoub stephentoub requested a review from a team as a code owner February 4, 2026 14:27
Copilot AI review requested due to automatic review settings February 4, 2026 14:27
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 renames the FunctionCallContent.InvocationRequired property to InformationalOnly and inverts its polarity. The property now defaults to false (was true), meaning function calls require processing unless explicitly marked as informational-only. This is a breaking API change that improves clarity by using positive semantics (what something is) rather than negative semantics (what something requires).

Changes:

  • Renamed InvocationRequired to InformationalOnly with inverted default value (false instead of true)
  • Updated all 6 usages in FunctionInvokingChatClient.cs with proper polarity inversion
  • Updated test names, assertions, and comments across 3 test files to reflect the new property name and semantics

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated no comments.

Show a summary per file
File Description
src/Libraries/Microsoft.Extensions.AI.Abstractions/Contents/FunctionCallContent.cs Renamed property from InvocationRequired to InformationalOnly, changed default from true to false, and updated XML documentation
src/Libraries/Microsoft.Extensions.AI/ChatCompletion/FunctionInvokingChatClient.cs Updated 4 boolean checks to use !InformationalOnly instead of InvocationRequired, and 2 assignments to set InformationalOnly = true instead of InvocationRequired = false
test/Libraries/Microsoft.Extensions.AI.Abstractions.Tests/Contents/FunctionCallContentTests.cs Updated 5 test method names and all assertions to use InformationalOnly with correct polarity
test/Libraries/Microsoft.Extensions.AI.Tests/ChatCompletion/FunctionInvokingChatClientTests.cs Updated 4 test method names, all assertions, comments, and test data creation to use InformationalOnly with inverted polarity
test/Libraries/Microsoft.Extensions.AI.Tests/ChatCompletion/FunctionInvokingChatClientApprovalsTests.cs Updated 1 test method name and assertions to use InformationalOnly with correct polarity
src/Libraries/Microsoft.Extensions.AI.Abstractions/Microsoft.Extensions.AI.Abstractions.json Updated API manifest to reflect the property rename
src/Libraries/Microsoft.Extensions.AI.Abstractions/CHANGELOG.md Updated changelog entry to describe the new property

This was referenced Feb 11, 2026
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.

3 participants