Merge main into live

xml/FrameworksIndex/net-6.0-pp.xml

@@ -14,7 +14,7 @@
     <Assembly Name="System.CommandLine" Version="2.0.0.0" />
     <Assembly Name="System.Data.SqlClient" Version="4.6.1.6" />
     <Assembly Name="System.Json" Version="4.8.0.0" />
-    <Assembly Name="System.Net.WebSockets.WebSocketProtocol" Version="5.1.1.0" />
+    <Assembly Name="System.Net.WebSockets.WebSocketProtocol" Version="5.1.3.0" />
     <Assembly Name="System.Runtime.CompilerServices.Unsafe" Version="6.0.0.0" />
     <Assembly Name="System.Security.AccessControl" Version="6.0.0.0" />
     <Assembly Name="System.ServiceModel.Duplex" Version="6.0.0.0" />

xml/FrameworksIndex/net-7.0-pp.xml

@@ -14,7 +14,7 @@
     <Assembly Name="System.CommandLine" Version="2.0.0.0" />
     <Assembly Name="System.Data.SqlClient" Version="4.6.1.6" />
     <Assembly Name="System.Json" Version="4.8.0.0" />
-    <Assembly Name="System.Net.WebSockets.WebSocketProtocol" Version="5.1.1.0" />
+    <Assembly Name="System.Net.WebSockets.WebSocketProtocol" Version="5.1.3.0" />
     <Assembly Name="System.Security.AccessControl" Version="6.0.0.0" />
     <Assembly Name="System.ServiceModel.Duplex" Version="6.0.0.0" />
     <Assembly Name="System.ServiceModel.Security" Version="6.0.0.0" />

xml/FrameworksIndex/netframework-4.7-pp.xml

@@ -2,6 +2,6 @@
 <Framework Name="netframework-4.7-pp">
   <Assemblies>
     <Assembly Name="System.Security.Cryptography.Cng" Version="5.0.0.0" />
-    <Assembly Name="System.ValueTuple" Version="4.0.4.0" />
+    <Assembly Name="System.ValueTuple" Version="4.0.5.0" />
   </Assemblies>
 </Framework>

xml/FrameworksIndex/netframework-4.7.2-pp.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Framework Name="netframework-4.7.2-pp">
   <Assemblies>
-    <Assembly Name="Microsoft.IO.Redist" Version="6.1.1.0" />
+    <Assembly Name="Microsoft.IO.Redist" Version="6.1.3.0" />
     <Assembly Name="System.Reflection.TypeExtensions" Version="4.1.5.0" />
   </Assemblies>
   <Namespace Name="Microsoft.IO">

xml/FrameworksIndex/netstandard-2.1-pp.xml

@@ -5,7 +5,7 @@
     <Assembly Name="Microsoft.Bcl.HashCode" Version="6.0.0.0" />
     <Assembly Name="Microsoft.Bcl.Memory" Version="10.0.0.0" />
     <Assembly Name="Microsoft.Bcl.Numerics" Version="10.0.0.0" />
-    <Assembly Name="Microsoft.Extensions.Caching.Hybrid" Version="9.3.0.0" />
+    <Assembly Name="Microsoft.Extensions.Caching.Hybrid" Version="9.4.0.0" />
     <Assembly Name="Microsoft.Extensions.Configuration.Json" Version="10.0.0.0" />
     <Assembly Name="Microsoft.Extensions.DependencyInjection.Abstractions" Version="10.0.0.0" />
     <Assembly Name="Microsoft.Extensions.DependencyInjection" Version="10.0.0.0" />
@@ -20,7 +20,6 @@
     <Assembly Name="System.ComponentModel.Annotations" Version="5.0.0.0" />
     <Assembly Name="System.ComponentModel.Composition.Registration" Version="10.0.0.0" />
     <Assembly Name="System.Reflection.Context" Version="10.0.0.0" />
-    <Assembly Name="System.Reflection.DispatchProxy" Version="4.0.6.0" />
     <Assembly Name="System.Security.Cryptography.Cng" Version="5.0.0.0" />
     <Assembly Name="System.Security.Cryptography.Pkcs" Version="10.0.0.0" />
     <Assembly Name="System.Threading.Channels" Version="10.0.0.0" />
@@ -1537,13 +1536,6 @@
       <Member Id="M:System.Reflection.Context.CustomReflectionContext.MapType(System.Reflection.TypeInfo)" />
     </Type>
   </Namespace>
-  <Namespace Name="System.Reflection">
-    <Type Name="System.Reflection.DispatchProxy" Id="T:System.Reflection.DispatchProxy">
-      <Member Id="M:System.Reflection.DispatchProxy.#ctor" />
-      <Member Id="M:System.Reflection.DispatchProxy.Create``2" />
-      <Member Id="M:System.Reflection.DispatchProxy.Invoke(System.Reflection.MethodInfo,System.Object[])" />
-    </Type>
-  </Namespace>
   <Namespace Name="System.Security.Cryptography">
     <Type Name="System.Security.Cryptography.AesCng" Id="T:System.Security.Cryptography.AesCng">
       <Member Id="M:System.Security.Cryptography.AesCng.#ctor" />

xml/FrameworksIndex/windowsdesktop-10.0.xml

@@ -34579,7 +34579,6 @@
       <Member Id="M:System.Windows.Forms.DataObject.SetData(System.Type,System.Object)" />
       <Member Id="M:System.Windows.Forms.DataObject.SetDataAsJson``1(``0)" />
       <Member Id="M:System.Windows.Forms.DataObject.SetDataAsJson``1(System.String,``0)" />
-      <Member Id="M:System.Windows.Forms.DataObject.SetDataAsJson``1(System.String,System.Boolean,``0)" />
       <Member Id="M:System.Windows.Forms.DataObject.SetFileDropList(System.Collections.Specialized.StringCollection)" />
       <Member Id="M:System.Windows.Forms.DataObject.SetImage(System.Drawing.Image)" />
       <Member Id="M:System.Windows.Forms.DataObject.SetText(System.String)" />

xml/Microsoft.Extensions.AI.Evaluation.Quality/ChatConversationEvaluator.xml

@@ -9,6 +9,7 @@
     <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
     <AssemblyVersion>1.0.0.0</AssemblyVersion>
     <AssemblyVersion>9.3.0.0</AssemblyVersion>
+    <AssemblyVersion>9.4.0.0</AssemblyVersion>
   </AssemblyInfo>
   <Base>
     <BaseTypeName>System.Object</BaseTypeName>
@@ -40,7 +41,7 @@
       <MemberType>Constructor</MemberType>
       <AssemblyInfo>
         <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
-        <AssemblyVersion>9.3.0.0</AssemblyVersion>
+        <AssemblyVersion>9.4.0.0</AssemblyVersion>
       </AssemblyInfo>
       <Parameters />
       <Docs>
@@ -58,7 +59,7 @@
       <MemberType>Method</MemberType>
       <AssemblyInfo>
         <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
-        <AssemblyVersion>9.3.0.0</AssemblyVersion>
+        <AssemblyVersion>9.4.0.0</AssemblyVersion>
       </AssemblyInfo>
       <ReturnValue>
         <ReturnType>System.Threading.Tasks.ValueTask&lt;System.ValueTuple&lt;System.Boolean,System.Int32&gt;&gt;</ReturnType>
@@ -117,7 +118,7 @@
       </Implements>
       <AssemblyInfo>
         <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
-        <AssemblyVersion>9.3.0.0</AssemblyVersion>
+        <AssemblyVersion>9.4.0.0</AssemblyVersion>
       </AssemblyInfo>
       <ReturnValue>
         <ReturnType>System.Threading.Tasks.ValueTask&lt;Microsoft.Extensions.AI.Evaluation.EvaluationResult&gt;</ReturnType>
@@ -174,7 +175,7 @@
       </Implements>
       <AssemblyInfo>
         <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
-        <AssemblyVersion>9.3.0.0</AssemblyVersion>
+        <AssemblyVersion>9.4.0.0</AssemblyVersion>
       </AssemblyInfo>
       <ReturnValue>
         <ReturnType>System.Collections.Generic.IReadOnlyCollection&lt;System.String&gt;</ReturnType>
@@ -196,7 +197,7 @@
       <MemberType>Property</MemberType>
       <AssemblyInfo>
         <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
-        <AssemblyVersion>9.3.0.0</AssemblyVersion>
+        <AssemblyVersion>9.4.0.0</AssemblyVersion>
       </AssemblyInfo>
       <ReturnValue>
         <ReturnType>System.Boolean</ReturnType>
@@ -223,7 +224,7 @@
       <MemberType>Method</MemberType>
       <AssemblyInfo>
         <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
-        <AssemblyVersion>9.3.0.0</AssemblyVersion>
+        <AssemblyVersion>9.4.0.0</AssemblyVersion>
       </AssemblyInfo>
       <ReturnValue>
         <ReturnType>Microsoft.Extensions.AI.Evaluation.EvaluationResult</ReturnType>
@@ -254,7 +255,7 @@
       <MemberType>Method</MemberType>
       <AssemblyInfo>
         <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
-        <AssemblyVersion>9.3.0.0</AssemblyVersion>
+        <AssemblyVersion>9.4.0.0</AssemblyVersion>
       </AssemblyInfo>
       <ReturnValue>
         <ReturnType>System.Threading.Tasks.ValueTask</ReturnType>
@@ -298,7 +299,7 @@
       <MemberType>Method</MemberType>
       <AssemblyInfo>
         <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
-        <AssemblyVersion>9.3.0.0</AssemblyVersion>
+        <AssemblyVersion>9.4.0.0</AssemblyVersion>
       </AssemblyInfo>
       <ReturnValue>
         <ReturnType>System.Threading.Tasks.ValueTask&lt;System.String&gt;</ReturnType>
@@ -340,7 +341,7 @@
       <MemberType>Method</MemberType>
       <AssemblyInfo>
         <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
-        <AssemblyVersion>9.3.0.0</AssemblyVersion>
+        <AssemblyVersion>9.4.0.0</AssemblyVersion>
       </AssemblyInfo>
       <ReturnValue>
         <ReturnType>System.Threading.Tasks.ValueTask&lt;System.String&gt;</ReturnType>
@@ -384,7 +385,7 @@
       <MemberType>Method</MemberType>
       <AssemblyInfo>
         <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
-        <AssemblyVersion>9.3.0.0</AssemblyVersion>
+        <AssemblyVersion>9.4.0.0</AssemblyVersion>
       </AssemblyInfo>
       <ReturnValue>
         <ReturnType>System.Threading.Tasks.ValueTask&lt;System.String&gt;</ReturnType>
@@ -456,7 +457,7 @@
       <MemberType>Property</MemberType>
       <AssemblyInfo>
         <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
-        <AssemblyVersion>9.3.0.0</AssemblyVersion>
+        <AssemblyVersion>9.4.0.0</AssemblyVersion>
       </AssemblyInfo>
       <Attributes>
         <Attribute FrameworkAlternate="net-10.0-pp;net-8.0-pp;net-9.0-pp">

xml/Microsoft.Extensions.AI.Evaluation.Quality/CoherenceEvaluator.xml

@@ -9,6 +9,7 @@
     <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
     <AssemblyVersion>1.0.0.0</AssemblyVersion>
     <AssemblyVersion>9.3.0.0</AssemblyVersion>
+    <AssemblyVersion>9.4.0.0</AssemblyVersion>
   </AssemblyInfo>
   <Base>
     <BaseTypeName>Microsoft.Extensions.AI.Evaluation.Quality.SingleNumericMetricEvaluator</BaseTypeName>
@@ -25,9 +26,27 @@
             An <see cref="T:Microsoft.Extensions.AI.Evaluation.IEvaluator" /> that evaluates the 'Coherence' of a response produced by an AI model.
             </summary>
     <remarks>
-      <see cref="T:Microsoft.Extensions.AI.Evaluation.Quality.CoherenceEvaluator" /> returns a <see cref="T:Microsoft.Extensions.AI.Evaluation.NumericMetric" /> that contains a score for 'Coherence'. The
+      <para>
+        <see cref="T:Microsoft.Extensions.AI.Evaluation.Quality.CoherenceEvaluator" /> returns a <see cref="T:Microsoft.Extensions.AI.Evaluation.NumericMetric" /> that contains a score for 'Coherence'. The
             score is a number between 1 and 5, with 1 indicating a poor score, and 5 indicating an excellent score.
-            </remarks>
+            </para>
+      <para>
+        <b>Note:</b>
+        <see cref="T:Microsoft.Extensions.AI.Evaluation.Quality.CoherenceEvaluator" /> is an AI-based evaluator that uses an AI model to perform its
+            evaluation. While the prompt that this evaluator uses to perform its evaluation is designed to be model-agnostic,
+            the performance of this prompt (and the resulting evaluation) can vary depending on the model used, and can be
+            especially poor when a smaller / local model is used.
+            </para>
+      <para>
+            The prompt that <see cref="T:Microsoft.Extensions.AI.Evaluation.Quality.CoherenceEvaluator" /> uses has been tested against (and tuned to work well with) the
+            following models. So, using this evaluator with a model from the following list is likely to produce the best
+            results. (The model to be used can be configured via <see cref="P:Microsoft.Extensions.AI.Evaluation.ChatConfiguration.ChatClient" />.)
+            </para>
+      <para>
+        <b>GPT-4o</b>
+      </para>
+    </remarks>
+    <related type="Article" href="https://learn.microsoft.com/dotnet/ai/quickstarts/evaluate-ai-response">Evaluate a model's response.</related>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
@@ -39,7 +58,7 @@
       <MemberType>Constructor</MemberType>
       <AssemblyInfo>
         <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
-        <AssemblyVersion>9.3.0.0</AssemblyVersion>
+        <AssemblyVersion>9.4.0.0</AssemblyVersion>
       </AssemblyInfo>
       <Parameters />
       <Docs>
@@ -57,7 +76,7 @@
       <MemberType>Property</MemberType>
       <AssemblyInfo>
         <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
-        <AssemblyVersion>9.3.0.0</AssemblyVersion>
+        <AssemblyVersion>9.4.0.0</AssemblyVersion>
       </AssemblyInfo>
       <ReturnValue>
         <ReturnType>System.String</ReturnType>
@@ -81,7 +100,7 @@
       <MemberType>Property</MemberType>
       <AssemblyInfo>
         <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
-        <AssemblyVersion>9.3.0.0</AssemblyVersion>
+        <AssemblyVersion>9.4.0.0</AssemblyVersion>
       </AssemblyInfo>
       <ReturnValue>
         <ReturnType>System.Boolean</ReturnType>
@@ -103,7 +122,7 @@
       <MemberType>Property</MemberType>
       <AssemblyInfo>
         <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
-        <AssemblyVersion>9.3.0.0</AssemblyVersion>
+        <AssemblyVersion>9.4.0.0</AssemblyVersion>
       </AssemblyInfo>
       <ReturnValue>
         <ReturnType>System.String</ReturnType>
@@ -125,7 +144,7 @@
       <MemberType>Method</MemberType>
       <AssemblyInfo>
         <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
-        <AssemblyVersion>9.3.0.0</AssemblyVersion>
+        <AssemblyVersion>9.4.0.0</AssemblyVersion>
       </AssemblyInfo>
       <ReturnValue>
         <ReturnType>System.Threading.Tasks.ValueTask&lt;System.String&gt;</ReturnType>

xml/Microsoft.Extensions.AI.Evaluation.Quality/EquivalenceEvaluator.xml

@@ -9,6 +9,7 @@
     <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
     <AssemblyVersion>1.0.0.0</AssemblyVersion>
     <AssemblyVersion>9.3.0.0</AssemblyVersion>
+    <AssemblyVersion>9.4.0.0</AssemblyVersion>
   </AssemblyInfo>
   <Base>
     <BaseTypeName>Microsoft.Extensions.AI.Evaluation.Quality.SingleNumericMetricEvaluator</BaseTypeName>
@@ -25,11 +26,28 @@
             An <see cref="T:Microsoft.Extensions.AI.Evaluation.IEvaluator" /> that evaluates the 'Equivalence' of a response produced by an AI model.
             </summary>
     <remarks>
+      <para>
             The <see cref="T:Microsoft.Extensions.AI.Evaluation.Quality.EquivalenceEvaluator" /> measures the degree to which the response being evaluated is similar to the
             response supplied via <see cref="P:Microsoft.Extensions.AI.Evaluation.Quality.EquivalenceEvaluatorContext.GroundTruth" />. It returns a
             <see cref="T:Microsoft.Extensions.AI.Evaluation.NumericMetric" /> that contains a score for the 'Equivalence'. The score is a number between 1 and 5,
             with 1 indicating a poor score, and 5 indicating an excellent score.
-            </remarks>
+            </para>
+      <para>
+        <b>Note:</b>
+        <see cref="T:Microsoft.Extensions.AI.Evaluation.Quality.EquivalenceEvaluator" /> is an AI-based evaluator that uses an AI model to perform its
+            evaluation. While the prompt that this evaluator uses to perform its evaluation is designed to be model-agnostic,
+            the performance of this prompt (and the resulting evaluation) can vary depending on the model used, and can be
+            especially poor when a smaller / local model is used.
+            </para>
+      <para>
+            The prompt that <see cref="T:Microsoft.Extensions.AI.Evaluation.Quality.EquivalenceEvaluator" /> uses has been tested against (and tuned to work well with) the
+            following models. So, using this evaluator with a model from the following list is likely to produce the best
+            results. (The model to be used can be configured via <see cref="P:Microsoft.Extensions.AI.Evaluation.ChatConfiguration.ChatClient" />.)
+            </para>
+      <para>
+        <b>GPT-4o</b>
+      </para>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
@@ -41,7 +59,7 @@
       <MemberType>Constructor</MemberType>
       <AssemblyInfo>
         <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
-        <AssemblyVersion>9.3.0.0</AssemblyVersion>
+        <AssemblyVersion>9.4.0.0</AssemblyVersion>
       </AssemblyInfo>
       <Parameters />
       <Docs>
@@ -59,7 +77,7 @@
       <MemberType>Property</MemberType>
       <AssemblyInfo>
         <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
-        <AssemblyVersion>9.3.0.0</AssemblyVersion>
+        <AssemblyVersion>9.4.0.0</AssemblyVersion>
       </AssemblyInfo>
       <ReturnValue>
         <ReturnType>System.String</ReturnType>
@@ -83,7 +101,7 @@
       <MemberType>Property</MemberType>
       <AssemblyInfo>
         <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
-        <AssemblyVersion>9.3.0.0</AssemblyVersion>
+        <AssemblyVersion>9.4.0.0</AssemblyVersion>
       </AssemblyInfo>
       <ReturnValue>
         <ReturnType>System.Boolean</ReturnType>
@@ -105,7 +123,7 @@
       <MemberType>Property</MemberType>
       <AssemblyInfo>
         <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
-        <AssemblyVersion>9.3.0.0</AssemblyVersion>
+        <AssemblyVersion>9.4.0.0</AssemblyVersion>
       </AssemblyInfo>
       <ReturnValue>
         <ReturnType>System.String</ReturnType>
@@ -127,7 +145,7 @@
       <MemberType>Method</MemberType>
       <AssemblyInfo>
         <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
-        <AssemblyVersion>9.3.0.0</AssemblyVersion>
+        <AssemblyVersion>9.4.0.0</AssemblyVersion>
       </AssemblyInfo>
       <ReturnValue>
         <ReturnType>System.Threading.Tasks.ValueTask&lt;System.String&gt;</ReturnType>

xml/Microsoft.Extensions.AI.Evaluation.Quality/EquivalenceEvaluatorContext.xml

@@ -8,6 +8,7 @@
   <AssemblyInfo>
     <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
     <AssemblyVersion>9.3.0.0</AssemblyVersion>
+    <AssemblyVersion>9.4.0.0</AssemblyVersion>
   </AssemblyInfo>
   <Base>
     <BaseTypeName>Microsoft.Extensions.AI.Evaluation.EvaluationContext</BaseTypeName>
@@ -24,7 +25,8 @@
             The ground truth response against which the response that is being evaluated is compared.
             </param>
     <summary>
-            Contextual information required to evaluate the 'Equivalence' of a response.
+            Contextual information that the <see cref="T:Microsoft.Extensions.AI.Evaluation.Quality.EquivalenceEvaluator" /> uses to evaluate the 'Equivalence' of a
+            response.
             </summary>
     <remarks>
             The <see cref="T:Microsoft.Extensions.AI.Evaluation.Quality.EquivalenceEvaluator" /> measures the degree to which the response being evaluated is similar to the
@@ -42,7 +44,7 @@
       <MemberType>Constructor</MemberType>
       <AssemblyInfo>
         <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
-        <AssemblyVersion>9.3.0.0</AssemblyVersion>
+        <AssemblyVersion>9.4.0.0</AssemblyVersion>
       </AssemblyInfo>
       <Parameters>
         <Parameter Name="groundTruth" Type="System.String" />
@@ -52,7 +54,8 @@
             The ground truth response against which the response that is being evaluated is compared.
             </param>
         <summary>
-            Contextual information required to evaluate the 'Equivalence' of a response.
+            Contextual information that the <see cref="T:Microsoft.Extensions.AI.Evaluation.Quality.EquivalenceEvaluator" /> uses to evaluate the 'Equivalence' of a
+            response.
             </summary>
         <remarks>
             The <see cref="T:Microsoft.Extensions.AI.Evaluation.Quality.EquivalenceEvaluator" /> measures the degree to which the response being evaluated is similar to the
@@ -70,7 +73,7 @@
       <MemberType>Property</MemberType>
       <AssemblyInfo>
         <AssemblyName>Microsoft.Extensions.AI.Evaluation.Quality</AssemblyName>
-        <AssemblyVersion>9.3.0.0</AssemblyVersion>
+        <AssemblyVersion>9.4.0.0</AssemblyVersion>
       </AssemblyInfo>
       <ReturnValue>
         <ReturnType>System.String</ReturnType>