Add "see also" links to conceptual docs (#6177)

Author: gewarren

src/Libraries/Microsoft.Extensions.AI.Abstractions/ChatCompletion/ChatMessage.cs

@@ -10,6 +10,7 @@
 namespace Microsoft.Extensions.AI;
 
 /// <summary>Represents a chat message used by an <see cref="IChatClient" />.</summary>
+/// <related type="Article" href="https://learn.microsoft.com/dotnet/ai/quickstarts/build-chat-app">Build an AI chat app with .NET.</related>
 [DebuggerDisplay("[{Role}] {ContentForDebuggerDisplay}{EllipsesForDebuggerDisplay,nq}")]
 public class ChatMessage
 {

src/Libraries/Microsoft.Extensions.AI.Abstractions/ChatCompletion/IChatClient.cs

@@ -23,6 +23,7 @@ namespace Microsoft.Extensions.AI;
 /// provided with a callback that could mutate the supplied options argument, and that should be avoided if using a singleton options instance.
 /// </para>
 /// </remarks>
+/// <related type="Article" href="https://learn.microsoft.com/dotnet/ai/quickstarts/build-chat-app">Build an AI chat app with .NET.</related>
 public interface IChatClient : IDisposable
 {
     /// <summary>Sends chat messages and returns the response.</summary>

src/Libraries/Microsoft.Extensions.AI.Evaluation.Quality/CoherenceEvaluator.cs

@@ -31,6 +31,7 @@ namespace Microsoft.Extensions.AI.Evaluation.Quality;
 /// <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>
 public sealed class CoherenceEvaluator : SingleNumericMetricEvaluator
 {
     /// <summary>

src/Libraries/Microsoft.Extensions.AI.Evaluation.Quality/RelevanceTruthAndCompletenessEvaluator.cs

@@ -42,6 +42,7 @@ namespace Microsoft.Extensions.AI.Evaluation.Quality;
 /// <b>GPT-4o</b>
 /// </para>
 /// </remarks>
+/// <related type="Article" href="https://learn.microsoft.com/dotnet/ai/tutorials/evaluate-with-reporting">Tutorial: Evaluate a model's response with response caching and reporting.</related>
 public sealed partial class RelevanceTruthAndCompletenessEvaluator : ChatConversationEvaluator
 {
     /// <summary>

src/Libraries/Microsoft.Extensions.AI.Evaluation.Reporting/CSharp/ReportingConfiguration.cs

@@ -16,6 +16,7 @@ namespace Microsoft.Extensions.AI.Evaluation.Reporting;
 /// used by these <see cref="IEvaluator"/>s, how the resulting <see cref="ScenarioRunResult"/>s should be persisted,
 /// and how AI responses should be cached.
 /// </summary>
+/// <related type="Article" href="https://learn.microsoft.com/dotnet/ai/tutorials/evaluate-with-reporting">Tutorial: Evaluate a model's response with response caching and reporting.</related>
 public sealed class ReportingConfiguration
 {
     /// <summary>
@@ -162,6 +163,7 @@ public ReportingConfiguration(
     /// A new <see cref="ScenarioRun"/> with the specified <paramref name="scenarioName"/> and
     /// <paramref name="iterationName"/>.
     /// </returns>
+    /// <related type="Article" href="https://learn.microsoft.com/dotnet/ai/tutorials/evaluate-with-reporting">Tutorial: Evaluate a model's response with response caching and reporting.</related>
     public async ValueTask<ScenarioRun> CreateScenarioRunAsync(
         string scenarioName,
         string iterationName = Defaults.DefaultIterationName,

src/Libraries/Microsoft.Extensions.AI.Evaluation.Reporting/CSharp/ScenarioRun.cs

@@ -16,6 +16,7 @@ namespace Microsoft.Extensions.AI.Evaluation.Reporting;
 /// can contain evaluations for multiple scenarios each with a unique <see cref="ScenarioName"/>. The execution of each
 /// such scenario in turn can include multiple iterations each with a unique <see cref="IterationName"/>.
 /// </remarks>
+/// <related type="Article" href="https://learn.microsoft.com/dotnet/ai/tutorials/evaluate-with-reporting">Tutorial: Evaluate a model's response with response caching and reporting.</related>
 public sealed class ScenarioRun : IAsyncDisposable
 {
     /// <summary>
@@ -31,6 +32,7 @@ public sealed class ScenarioRun : IAsyncDisposable
     /// suite can be set to the fully qualified name of the corresponding unit test.
     /// </para>
     /// </remarks>
+    /// <related type="Article" href="https://learn.microsoft.com/dotnet/ai/tutorials/evaluate-with-reporting">Tutorial: Evaluate a model's response with response caching and reporting.</related>
     public string ScenarioName { get; }
 
     /// <summary>
@@ -73,6 +75,7 @@ public sealed class ScenarioRun : IAsyncDisposable
     /// the new execution.
     /// </para>
     /// </remarks>
+    /// <related type="Article" href="https://learn.microsoft.com/dotnet/ai/tutorials/evaluate-with-reporting">Tutorial: Evaluate a model's response with response caching and reporting.</related>
     public string ExecutionName { get; }
 
     /// <summary>

src/Libraries/Microsoft.Extensions.AI.Evaluation/EvaluationResult.cs

@@ -11,6 +11,7 @@ namespace Microsoft.Extensions.AI.Evaluation;
 /// <summary>
 /// A collection of one or more <see cref="EvaluationMetric"/>s that represent the result of an evaluation.
 /// </summary>
+/// <related type="Article" href="https://learn.microsoft.com/dotnet/ai/quickstarts/evaluate-ai-response">Evaluate a model's response.</related>
 public sealed class EvaluationResult
 {
     /// <summary>
@@ -88,7 +89,7 @@ public EvaluationResult(params EvaluationMetric[] metrics)
     /// <summary>
     /// Returns an <see cref="EvaluationMetric"/> with type <typeparamref name="T"/> and with the
     /// <see cref="EvaluationMetric.Name"/> specified via <paramref name="metricName"/> if it exists in
-    /// <see cref="Metrics"/>. 
+    /// <see cref="Metrics"/>.
     /// </summary>
     /// <typeparam name="T">The type of the <see cref="EvaluationMetric"/> to be returned.</typeparam>
     /// <param name="metricName">
@@ -119,7 +120,7 @@ public bool TryGet<T>(string metricName, [NotNullWhen(true)] out T? value)
     /// <summary>
     /// Returns an <see cref="EvaluationMetric"/> with type <typeparamref name="T"/> and with the
     /// <see cref="EvaluationMetric.Name"/> specified via <paramref name="metricName"/> if it exists in
-    /// <see cref="Metrics"/>. 
+    /// <see cref="Metrics"/>.
     /// </summary>
     /// <typeparam name="T">The type of the <see cref="EvaluationMetric"/> to be returned.</typeparam>
     /// <param name="metricName">

src/Libraries/Microsoft.Extensions.AI.Evaluation/IEvaluator.cs

@@ -10,6 +10,7 @@ namespace Microsoft.Extensions.AI.Evaluation;
 /// <summary>
 /// Evaluates responses produced by an AI model.
 /// </summary>
+/// <related type="Article" href="https://learn.microsoft.com/dotnet/ai/quickstarts/evaluate-ai-response">Evaluate a model's response.</related>
 public interface IEvaluator
 {
     /// <summary>
@@ -48,6 +49,7 @@ public interface IEvaluator
     /// A <see cref="CancellationToken"/> that can cancel the evaluation operation.
     /// </param>
     /// <returns>An <see cref="EvaluationResult"/> containing one or more <see cref="EvaluationMetric"/>s.</returns>
+    /// <related type="Article" href="https://learn.microsoft.com/dotnet/ai/quickstarts/evaluate-ai-response">Evaluate a model's response.</related>
     ValueTask<EvaluationResult> EvaluateAsync(
         IEnumerable<ChatMessage> messages,
         ChatResponse modelResponse,

src/Libraries/Microsoft.Extensions.AI.Evaluation/NumericMetric.cs

@@ -24,5 +24,6 @@ namespace Microsoft.Extensions.AI.Evaluation;
 /// An optional string that can be used to provide some commentary around the result represented by this
 /// <see cref="NumericMetric"/>.
 /// </param>
+/// <related type="Article" href="https://learn.microsoft.com/dotnet/ai/quickstarts/evaluate-ai-response">Evaluate a model's response.</related>
 public sealed class NumericMetric(string name, double? value = null, string? reason = null)
     : EvaluationMetric<double?>(name, value, reason);

src/Libraries/Microsoft.Extensions.AI/Functions/AIFunctionFactory.cs

@@ -27,6 +27,7 @@
 namespace Microsoft.Extensions.AI;
 
 /// <summary>Provides factory methods for creating commonly used implementations of <see cref="AIFunction"/>.</summary>
+/// <related type="Article" href="https://learn.microsoft.com/dotnet/ai/quickstarts/use-function-calling">Invoke .NET functions using an AI model.</related>
 public static partial class AIFunctionFactory
 {
     /// <summary>Holds the default options instance used when creating function.</summary>