Skip to content

2026-08-24

Latest
Latest

Choose a tag to compare

View all tags
@elbruno elbruno released this 24 Aug 19:35
· 13 commits to main since this release
2026-08-24
3e27090
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Release 2026-08-24

Generative AI for Beginners – .NET | 514 commits across 163 merged pull requests (2025-07-21 to 2026-08-24)

Highlights

This release fixes a real .NET 10 file-based-app break in the Ollama samples, adds an Azure Function chat sample and five new building-block samples, and rolls up routine dependency and CI maintenance.

  • ✅ Fixed: file-based Ollama samples (dotnet run app.cs) no longer throw System.InvalidOperationException on the first model call (#528)
  • ✅ New: Azure Function sample for chat integration with Azure Foundry (#526)
  • ✅ New: five building-block samples — DataIngestion, MCP-03, A2A-01, MAF-MCP-01, MAF-ImageGen (#521)
  • ✅ Validated: 5 tracked solutions built in Release configuration; 6 tests passed; 3 file-based Ollama samples smoke-tested with phi4-mini

Fixes & Compatibility

Critical: file-based Ollama samples threw InvalidOperationException on .NET 10

#528 – Enable reflection-based JSON serialization in file-based Ollama samples, contributed by community member @matheuscardosolazzarini.

  • What was broken: BasicChat-03Ollama, BasicChat-07Ollama-gpt-oss, and BasicChat-10ConversationHistory — all run with dotnet run app.cs — threw a clear System.InvalidOperationException ("Reflection-based serialization has been disabled for this application") on the first model call. The app started normally; the failure only surfaced once OllamaSharp tried to serialize the request.
  • Why it happened: .NET 10 file-based apps disable reflection-based JSON serialization by default. Regular project-based samples (with a .csproj) are not affected — MSBuild-built apps keep reflection-based serialization enabled by default, so no equivalent change was needed there.
  • The fix: add a top-of-file directive to each affected sample: 
    #:property JsonSerializerIsReflectionEnabledByDefault=true
  • Try it: on .NET 10, run dotnet run app.cs in any of the three samples above with no manual edits — it now completes a real Ollama call instead of throwing.

Additional fixes

  • Windows targeting in Core Samples CI (#529) – restores CI restore/build for Windows-targeted projects in the Core Samples solution.
  • Bicep deployment race condition (#525) – resolves a RequestConflict race in main.bicep.
  • Vision-03MEAI-AOAI sample – handles missing sample videos instead of throwing (fixes issue #517).
  • Migrated off deprecated Microsoft.Extensions.AI.Ollama – samples now use OllamaSharp directly (fixes issue #514).
  • Background Responses sample – repaired async response streaming logic.
  • MAF-02 (Agent Factory) sample – initialized static fields with default values in the Movie/MovieFactory classes and clarified comments.

New Samples & Docs

  • Azure Function chat sample (#526) – integrates a chat model with Azure Foundry in a serverless host.
  • 9 Foundry Local samples added to Core Samples for local model execution patterns.
  • Building-block samples (#521): DataIngestion, MCP-03, A2A-01, MAF-MCP-01, MAF-ImageGen.
  • Podcast collateral: a new Foundry + Agent Framework session guide, a fallback appendix for Foundry + MAF, a refreshed image-and-speech appendix, and copy-paste cd paths/snippets added to the podcast guide.
  • docs/ is now the consolidated home for event and session reference material.

Maintenance & Dependencies

  • OpenTelemetry.Exporter.OpenTelemetryProtocol bumped to 1.15.3.
  • Additional routine package updates across samples (Azure.AI.OpenAI, Microsoft.Extensions.AI, OpenTelemetry.*, and others) — see individual dependency-update commits for exact versions; no other version numbers are asserted here.
  • GitHub Actions pinned to full-length commit SHAs for reproducibility (#524).
  • GitHub Actions group dependencies bumped, 5 updates (#527).
  • Dev container updated to the .NET 10.0 Ubuntu Noble base image, with the GitHub CLI feature added.

Validation

Component Status Details
Build ✅ Passed 5 tracked solutions built in Release configuration
Tests ✅ Passed 6 tests passed
Ollama samples ✅ Passed 3 file-based samples smoke-tested with phi4-mini

No Azure/cloud environment validation or NuGet package release is claimed for this cycle.

What's Next for Learners

  1. Update your local clone: git pull to get the latest samples.
  2. Try the Ollama fix: on .NET 10, run dotnet run app.cs in BasicChat-03Ollama (or BasicChat-07Ollama-gpt-oss / BasicChat-10ConversationHistory) with no manual edits — it should complete the model call without error.
  3. Explore Foundry: check out the new Azure Function sample if you're moving from local Ollama to a cloud-hosted model.
  4. Follow the building blocks: start with DataIngestion or MCP-03 to deepen your AI pattern knowledge.

Contributors

Thanks to all contributors in this release window, including the maintainer team, automated dependency updates, and community fixes — especially @matheuscardosolazzarini, who found and fixed the file-based Ollama serialization break in #528.

Questions or issues? Open an issue on GitHub or check the lesson READMEs for sample-specific help.

Assets 2
Loading