Skip to content

Add MemberGroup descriptions (Microsoft.Extensions.AI)#12830

Merged
gewarren merged 3 commits into
dotnet:mainfrom
gewarren:membergroup-set1
Jun 30, 2026
Merged

Add MemberGroup descriptions (Microsoft.Extensions.AI)#12830
gewarren merged 3 commits into
dotnet:mainfrom
gewarren:membergroup-set1

Conversation

@gewarren

Copy link
Copy Markdown
Collaborator

Contributes to #12626.

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.

Pull request overview

Adds missing ECMAXML <MemberGroup> summaries for constructor and overload groups across the Microsoft.Extensions.AI surface area (including Evaluation/Reporting/Safety/Quality/NLP), improving how overload sets are presented in generated reference docs.

Changes:

  • Added <MemberGroup> summaries for many .ctor overload sets across Microsoft.Extensions.AI types.
  • Added <MemberGroup> summaries for common overload groups (for example Use, UploadAsync, EditImageAsync, and various AsI* helpers).
  • Added <MemberGroup> summaries for Microsoft.Extensions.AI.*.Evaluation extension methods and model/context types.

Reviewed changes

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

Show a summary per file
File Description
xml/Microsoft.Extensions.AI/UsageContent.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/UriContent.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/TextToSpeechResponseUpdate.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/TextToSpeechResponse.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/TextToSpeechOptions.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/TextToSpeechClientBuilder.xml Add .ctor and Use MemberGroup summaries.
xml/Microsoft.Extensions.AI/SpeechToTextResponseUpdate.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/SpeechToTextResponse.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/SpeechToTextOptions.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/SpeechToTextClientBuilder.xml Add .ctor and Use MemberGroup summaries.
xml/Microsoft.Extensions.AI/ResponseContinuationToken.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/RealtimeClientBuilder.xml Add .ctor and Use MemberGroup summaries.
xml/Microsoft.Extensions.AI/OpenAIRealtimeClient.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/OpenAIClientExtensions.xml Add MemberGroup summaries for AsIChatClient and AsIHostedFileClient overload groups.
xml/Microsoft.Extensions.AI/ImageGeneratorExtensions.xml Add MemberGroup summary for EditImageAsync overload group.
xml/Microsoft.Extensions.AI/ImageGeneratorBuilder.xml Add .ctor and Use MemberGroup summaries.
xml/Microsoft.Extensions.AI/ImageGenerationResponse.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/ImageGenerationRequest.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/ImageGenerationOptions.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/HostedWebSearchTool.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/HostedToolSearchTool.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/HostedMcpServerTool.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/HostedImageGenerationTool.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/HostedFileSearchTool.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/HostedFileClientOptions.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/HostedFileClientExtensions.xml Add MemberGroup summary for UploadAsync overload group.
xml/Microsoft.Extensions.AI/HostedFileClientBuilder.xml Add .ctor and Use MemberGroup summaries.
xml/Microsoft.Extensions.AI/HostedCodeInterpreterTool.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/GeneratedEmbeddings`1.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/EmbeddingGeneratorBuilder`2.xml Add .ctor and Use MemberGroup summaries.
xml/Microsoft.Extensions.AI/EmbeddingGenerationOptions.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/DelegatingTextToSpeechClient.xml Add Dispose MemberGroup summary.
xml/Microsoft.Extensions.AI/DelegatingSpeechToTextClient.xml Add Dispose MemberGroup summary.
xml/Microsoft.Extensions.AI/DelegatingRealtimeClient.xml Add Dispose MemberGroup summary.
xml/Microsoft.Extensions.AI/DelegatingImageGenerator.xml Add Dispose MemberGroup summary.
xml/Microsoft.Extensions.AI/DelegatingHostedFileClient.xml Add Dispose MemberGroup summary.
xml/Microsoft.Extensions.AI/DelegatingEmbeddingGenerator`2.xml Add Dispose MemberGroup summary.
xml/Microsoft.Extensions.AI/DelegatingChatClient.xml Add Dispose MemberGroup summary.
xml/Microsoft.Extensions.AI/DataContent.xml Add .ctor and LoadFromAsync MemberGroup summaries.
xml/Microsoft.Extensions.AI/ChatResponseUpdate.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/ChatResponseFormat.xml Add MemberGroup summary for ForJsonSchema overload group.
xml/Microsoft.Extensions.AI/ChatResponseExtensions.xml Add MemberGroup summary for AddMessages overload group.
xml/Microsoft.Extensions.AI/ChatResponse.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/ChatOptions.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/ChatMessage.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/ChatClientStructuredOutputExtensions.xml Add MemberGroup summary for GetResponseAsync<T> overload group.
xml/Microsoft.Extensions.AI/ChatClientExtensions.xml Add MemberGroup summaries for GetResponseAsync and GetStreamingResponseAsync overload groups.
xml/Microsoft.Extensions.AI/ChatClientBuilder.xml Add .ctor and Use MemberGroup summaries.
xml/Microsoft.Extensions.AI/AzureAIInferenceExtensions.xml Add MemberGroup summary for AsIEmbeddingGenerator overload group.
xml/Microsoft.Extensions.AI/AIJsonSchemaTransformCache.xml Add MemberGroup summary for GetOrCreateTransformedSchema.
xml/Microsoft.Extensions.AI/AIFunctionFactory.xml Add MemberGroup summary for Create overload group.
xml/Microsoft.Extensions.AI/AIFunctionArguments.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/AdditionalPropertiesDictionary`1.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI/AdditionalPropertiesDictionary.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI.Evaluation/EvaluatorExtensions.xml Add MemberGroup summary for EvaluateAsync overload group.
xml/Microsoft.Extensions.AI.Evaluation/EvaluationResultExtensions.xml Add MemberGroup summaries for AddDiagnosticsToAllMetrics, AddOrUpdateContextInAllMetrics, and AddOrUpdateMetadataInAllMetrics.
xml/Microsoft.Extensions.AI.Evaluation/EvaluationResult.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI.Evaluation/EvaluationMetricExtensions.xml Add MemberGroup summaries for AddDiagnostics, AddOrUpdateContext, and AddOrUpdateMetadata.
xml/Microsoft.Extensions.AI.Evaluation/EvaluationContext.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI.Evaluation/CompositeEvaluator.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI.Evaluation/ChatMessageExtensions.xml Add MemberGroup summaries for RenderText and TryGetUserRequest overload groups.
xml/Microsoft.Extensions.AI.Evaluation.Safety/ContentSafetyServiceConfigurationExtensions.xml Add MemberGroup summary for ToChatConfiguration.
xml/Microsoft.Extensions.AI.Evaluation.Safety/ContentSafetyServiceConfiguration.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI.Evaluation.Reporting/ScenarioRunResult.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI.Evaluation.Reporting/ScenarioRunExtensions.xml Add MemberGroup summary for EvaluateAsync.
xml/Microsoft.Extensions.AI.Evaluation.Reporting/ChatTurnDetails.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI.Evaluation.Reporting/ChatDetailsExtensions.xml Add MemberGroup summary for AddTurnDetails.
xml/Microsoft.Extensions.AI.Evaluation.Reporting/ChatDetails.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI.Evaluation.Quality/ToolCallAccuracyEvaluatorContext.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI.Evaluation.Quality/TaskAdherenceEvaluatorContext.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI.Evaluation.Quality/RetrievalEvaluatorContext.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI.Evaluation.Quality/IntentResolutionEvaluatorContext.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI.Evaluation.NLP/GLEUEvaluatorContext.xml Add .ctor MemberGroup summary.
xml/Microsoft.Extensions.AI.Evaluation.NLP/BLEUEvaluatorContext.xml Add .ctor MemberGroup summary.

Comment thread xml/Microsoft.Extensions.AI/ImageGeneratorExtensions.xml Outdated
Comment thread xml/Microsoft.Extensions.AI/HostedFileClientExtensions.xml Outdated
Comment thread xml/Microsoft.Extensions.AI/DataContent.xml Outdated
Comment thread xml/Microsoft.Extensions.AI/OpenAIClientExtensions.xml Outdated
Comment thread xml/Microsoft.Extensions.AI.Evaluation/ChatMessageExtensions.xml
Comment thread xml/Microsoft.Extensions.AI.Evaluation/ChatMessageExtensions.xml Outdated
Comment thread xml/Microsoft.Extensions.AI/DelegatingHostedFileClient.xml Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@gewarren gewarren marked this pull request as ready for review June 30, 2026 16:23
@gewarren gewarren requested a review from a team as a code owner June 30, 2026 16:23
Comment thread xml/Microsoft.Extensions.AI.Evaluation/ChatMessageExtensions.xml

@wadepickett wadepickett 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.

Approved. See very minor typo fix I noted inline.

@gewarren gewarren merged commit 7af950d into dotnet:main Jun 30, 2026
6 checks passed
@gewarren gewarren deleted the membergroup-set1 branch June 30, 2026 17:21
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