This PR adds comprehensive documentation that addresses confusion about which AI client integrations are compatible with which AI hosting integrations in .NET Aspire.

The new article (docs/azureai/ai-integrations-compatibility-matrix.md) provides:

Compatibility Matrix

A comprehensive table showing compatibility between hosting integrations and client integrations:

Key Features

• Clear visual indicators using emojis to show Yes/No/Partial compatibility
• Recommended pairings with practical guidance and code examples for each scenario
• Clear separation between hosting and client integration code with dedicated sections
• NuGet package links for all integrations to help developers find the right packages
• Connection string format documentation explaining how each hosting integration generates connection strings and what each client integration expects
• General guidance: Use Aspire.Azure.AI.Inference for Azure hosted models, or Aspire.OpenAI for direct OpenAI connections

Structure

Each integration pairing section includes:

• Hosting integration subsection with NuGet package link and app host code
• Client integration subsection with NuGet package link and service project code

This clear separation helps developers understand which code belongs in which project and which packages to install where.

Technical Details

The article includes detailed connection string formats for both hosting and client integrations, helping developers understand the underlying mechanics of how these integrations communicate with each other.

This documentation directly addresses the issue where developers were confused about which clients to use when deploying models on the variety of hosting platforms that Aspire supports.

Fixes #4273.

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Internal previews