AI evaluation docs freshness pass: update dates, ai-usage metadata, package flags, and NuGet versions

[Copilot]

Five articles in docs/ai/evaluation/ were stale—outdated ms.date values and missing AI-usage disclosure, plus Microsoft.Extensions.AI.OpenAI was still marked as --prerelease despite reaching stable release. NuGet package versions in the snippet projects were also updated to their latest releases.

Changes

• ms.date: Updated to 03/03/2026 across all five articles

• ai-usage: ai-assisted: Added to the four articles missing this frontmatter key (evaluate-ai-response.md, evaluate-safety.md, evaluate-with-reporting.md, libraries.md)

• --prerelease flag removed from dotnet add package Microsoft.Extensions.AI.OpenAI in three articles — the package is now stable at 10.3.0:

  - dotnet add package Microsoft.Extensions.AI.OpenAI --prerelease
  + dotnet add package Microsoft.Extensions.AI.OpenAI

  Microsoft.Extensions.AI.Evaluation.Safety retains --prerelease as it remains in prerelease.

• NuGet package versions updated in snippet csproj files (verified via NuGet API):

  • Azure.Identity: 1.17.1 → 1.18.0 (all 3 projects)
  • Microsoft.Extensions.AI.Evaluation.Safety: 9.5.0-preview.1.25265.7 → 10.3.0-preview.1.26109.11 (EvaluateResponseSafety.csproj)
  • Microsoft.NET.Test.Sdk: 18.0.1 → 18.3.0 (TestAI.csproj and TestAIWithReporting.csproj)

---

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

---

Internal previews

📄 File	🔗 Preview link
docs/ai/evaluation/evaluate-ai-response.md	docs/ai/evaluation/evaluate-ai-response
docs/ai/evaluation/evaluate-safety.md	docs/ai/evaluation/evaluate-safety
docs/ai/evaluation/evaluate-with-reporting.md	docs/ai/evaluation/evaluate-with-reporting
docs/ai/evaluation/libraries.md	docs/ai/evaluation/libraries
docs/ai/evaluation/responsible-ai.md	docs/ai/evaluation/responsible-ai

[gewarren]

@copilot Can you try to access www.nuget.org again and make any updates based on data you find there?

[Copilot]

@copilot Can you try to access www.nuget.org again and make any updates based on data you find there?

I was able to access the NuGet API and found the following packages needed updates in the snippet csproj files (commit a67b628):

• Azure.Identity: 1.17.1 → 1.18.0 (all 3 projects)
• Microsoft.Extensions.AI.Evaluation.Safety: 9.5.0-preview.1.25265.7 → 10.3.0-preview.1.26109.11 (EvaluateResponseSafety.csproj)
• Microsoft.NET.Test.Sdk: 18.0.1 → 18.3.0 (TestAI.csproj and TestAIWithReporting.csproj)

All other packages (Azure.AI.OpenAI 2.1.0, Microsoft.Extensions.AI.* 10.3.0, Microsoft.Extensions.Configuration* 10.0.3, MSTest 4.1.0) were already at their latest stable versions.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• www.nuget.org
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node /home/REDACTED/work/_temp/ghcca-node/node/bin/node --enable-source-maps /home/REDACTED/work/_temp/copilot-developer-action-main/dist/index.js (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

[Copilot]

Pull request overview

This PR is a freshness pass over five articles in docs/ai/evaluation/, updating stale metadata and aligning documentation with the current package release state. Microsoft.Extensions.AI.OpenAI has reached stable release, so the --prerelease install flag is removed from three tutorials. NuGet versions in the snippet projects are bumped to their latest releases, and the four articles that were missing the ai-usage disclosure get the required ai-usage: ai-assisted frontmatter key.

Changes:

• Updated ms.date to 03/03/2026 across all five articles and added ai-usage: ai-assisted to four articles that were missing it.
• Removed --prerelease from dotnet add package Microsoft.Extensions.AI.OpenAI in three tutorial articles (evaluate-ai-response.md, evaluate-safety.md, evaluate-with-reporting.md).
• Bumped NuGet package versions in snippet csproj files (Azure.Identity 1.17.1 → 1.18.0, Microsoft.Extensions.AI.Evaluation.Safety 9.5.0-preview → 10.3.0-preview, Microsoft.NET.Test.Sdk 18.0.1 → 18.3.0).

Reviewed changes

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

Show a summary per file

File	Description
docs/ai/evaluation/responsible-ai.md	ms.date updated to 03/03/2026
docs/ai/evaluation/libraries.md	ms.date updated and ai-usage: ai-assisted added
docs/ai/evaluation/evaluate-with-reporting.md	ms.date updated, ai-usage added, --prerelease removed from OpenAI package
docs/ai/evaluation/evaluate-safety.md	ms.date updated, ai-usage added, --prerelease removed from OpenAI package
docs/ai/evaluation/evaluate-ai-response.md	ms.date updated, ai-usage added, --prerelease removed from OpenAI package
docs/ai/evaluation/snippets/evaluate-ai-responses/TestAI.csproj	Azure.Identity → 1.18.0, Microsoft.NET.Test.Sdk → 18.3.0
docs/ai/evaluation/snippets/evaluate-safety/EvaluateResponseSafety.csproj	Azure.Identity → 1.18.0, Microsoft.Extensions.AI.Evaluation.Safety → 10.3.0-preview.1.26109.11
docs/ai/evaluation/snippets/evaluate-with-reporting/TestAIWithReporting.csproj	Azure.Identity → 1.18.0, Microsoft.NET.Test.Sdk → 18.3.0

---

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