Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion src/frontend/config/sidebar/integrations.topics.ts
Original file line number Diff line number Diff line change
Expand Up @@ -346,7 +346,7 @@ export const integrationTopics: StarlightSidebarTopicsUserConfig = {
slug: 'integrations/cloud/azure/ai-compatibility-matrix',
},
{
label: 'Azure AI Foundry',
label: 'Microsoft Foundry',
collapsed: true,
items: [
{
Expand Down
2 changes: 1 addition & 1 deletion src/frontend/src/components/IntegrationGrid.astro
Original file line number Diff line number Diff line change
Expand Up @@ -109,7 +109,7 @@ const icons = [
},
{ meta: adminerIcon, alt: 'Adminer', search: 'adminer' },
{ meta: awsIcon, alt: 'AWS', search: 'aws', light: awsLightIcon },
{ meta: azureAiFoundryIcon, alt: 'Azure AI Foundry', search: 'aifoundry' },
{ meta: azureAiFoundryIcon, alt: 'Microsoft Foundry', search: 'foundry' },
{
meta: azureAppconfigIcon,
alt: 'Azure App Configuration',
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ The following table shows the compatibility between Aspire AI hosting and client

| **Hosting Integration** | **Aspire.OpenAI** | **Aspire.Azure.AI.OpenAI** | **Aspire.Azure.AI.Inference** |
|--|--|--|--|
| `Aspire.Hosting.Azure.AIFoundry` | ❌ No | ⚠️ Partial | ✅ Yes (preferred) |
| `Aspire.Hosting.Foundry` | ❌ No | ⚠️ Partial | ✅ Yes (preferred) |
| `Aspire.Hosting.Azure.CognitiveServices` | ❌ No | ✅ Yes (preferred) | ❌ No |
| `Aspire.Hosting.OpenAI` | ✅ Yes (preferred) | ✅ Yes | ❌ No |
| `Aspire.Hosting.GitHub.Models` | ⚠️ Partial | ❌ No | ✅ Yes (preferred) |
Expand All @@ -31,18 +31,18 @@ The following table shows the compatibility between Aspire AI hosting and client

In general, use **Aspire.Azure.AI.Inference** to connect to Azure hosted models, or **Aspire.OpenAI** to connect directly to OpenAI.

### Azure AI Foundry
### Microsoft Foundry

For Azure AI Foundry resources, use the **Aspire.Azure.AI.Inference** client integration. This provides the best compatibility with the diverse range of models available through Azure AI Foundry. For more information, see [Azure AI Foundry integration](/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-get-started/).
For Microsoft Foundry resources, use the **Aspire.Azure.AI.Inference** client integration. This provides the best compatibility with the diverse range of models available through Microsoft Foundry. For more information, see [Microsoft Foundry integration](/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-get-started/).

#### Hosting integration

The [Aspire.Hosting.Azure.AIFoundry](https://www.nuget.org/packages/Aspire.Hosting.Azure.AIFoundry) package provides the hosting integration. In your app host project:
The [Aspire.Hosting.Foundry](https://www.nuget.org/packages/Aspire.Hosting.Foundry) package provides the hosting integration. In your app host project:

```csharp title="C# — AppHost.cs"
var builder = DistributedApplication.CreateBuilder(args);

var foundry = builder.AddAzureAIFoundry("foundry");
var foundry = builder.AddFoundry("foundry");

builder.AddProject<Projects.ExampleProject>()
.WithReference(foundry);
Expand Down Expand Up @@ -139,15 +139,15 @@ Each hosting integration generates connection strings in different formats that

### Hosting integration connection strings

#### Aspire.Hosting.Azure.AIFoundry
#### Aspire.Hosting.Foundry

**Azure:**

```
Endpoint={Endpoint};EndpointAIInference={AIFoundryApiEndpoint}models
Endpoint={Endpoint};EndpointAIInference={EndpointAIInference}models
```

**Foundry local:**
**Foundry Local:**

```
Endpoint={EmulatorServiceUri};Key={ApiKey}
Expand Down Expand Up @@ -219,6 +219,6 @@ Uses `EndpointAIInference` if available, otherwise `Endpoint`.

- [Azure OpenAI integration](/integrations/cloud/azure/azure-openai/azure-openai-get-started/)
- [Azure AI Inference integration](/integrations/cloud/azure/azure-ai-inference/azure-ai-inference-get-started/)
- [Azure AI Foundry integration](/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-get-started/)
- [Microsoft Foundry integration](/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-get-started/)
- [Azure AI Search integration](/integrations/cloud/azure/azure-ai-search/azure-ai-search-get-started/)
- [Microsoft.Extensions.AI documentation](https://learn.microsoft.com/dotnet/ai/ai-extensions)
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Azure AI Foundry client integration
description: Learn how to use the Aspire Azure AI Foundry client integration to connect to Azure AI Foundry services.
title: Microsoft Foundry client integration
description: Learn how to use the Aspire Microsoft Foundry client integration to connect to Microsoft Foundry services.
next: false
---

Expand All @@ -10,7 +10,7 @@ import aiFoundryIcon from '@assets/icons/azure-ai-foundry-icon.png';

<Image
src={aiFoundryIcon}
alt="Azure AI Foundry logo"
alt="Microsoft Foundry logo"
height={80}
width={80}
class:list={'float-inline-left icon'}
Expand All @@ -19,13 +19,13 @@ import aiFoundryIcon from '@assets/icons/azure-ai-foundry-icon.png';

<Badge text="🧪 Preview" variant="note" size="large" />

The client integration for Azure AI Foundry is provided through the [Azure AI Inference](/integrations/cloud/azure/azure-ai-inference/azure-ai-inference-get-started/) integration.
The client integration for Microsoft Foundry is provided through the [Azure AI Inference](/integrations/cloud/azure/azure-ai-inference/azure-ai-inference-get-started/) integration.

For an introduction to working with the Azure AI Foundry client integration, see [Get started with the Azure AI Foundry integrations](/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-get-started/).
For an introduction to working with the Microsoft Foundry client integration, see [Get started with the Microsoft Foundry integrations](/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-get-started/).

## Using Azure AI Foundry from client applications
## Using Microsoft Foundry from client applications

To use Azure AI Foundry services from your client applications, you'll use the Azure AI Inference client integration. This integration provides a consistent way to interact with various AI models deployed in Azure AI Foundry, including chat completions, embeddings, and other AI capabilities.
To use Microsoft Foundry services from your client applications, you'll use the Azure AI Inference client integration. This integration provides a consistent way to interact with various AI models deployed in Microsoft Foundry, including chat completions, embeddings, and other AI capabilities.

For detailed information on how to:

Expand All @@ -45,7 +45,7 @@ See the complete [Azure AI Inference integration documentation](/integrations/cl
href="/integrations/cloud/azure/azure-ai-inference/azure-ai-inference-get-started/"
/>
<LinkCard
title="Azure AI Foundry Hosting integration"
title="Microsoft Foundry Hosting integration"
description="Learn more about the hosting integration features and capabilities"
href="/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-host/"
/>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Get started with the Azure AI Foundry integrations
description: Learn how to set up the Aspire Azure AI Foundry hosting and client integrations simply.
title: Get started with the Microsoft Foundry integrations
description: Learn how to set up the Aspire Microsoft Foundry hosting and client integrations simply.
prev: false
---

Expand All @@ -11,7 +11,7 @@ import aiFoundryIcon from '@assets/icons/azure-ai-foundry-icon.png';

<Image
src={aiFoundryIcon}
alt="Azure AI Foundry logo"
alt="Microsoft Foundry logo"
height={80}
width={80}
class:list={'float-inline-left icon'}
Expand All @@ -20,28 +20,28 @@ import aiFoundryIcon from '@assets/icons/azure-ai-foundry-icon.png';

<Badge text="🧪 Preview" variant="note" size="large" />

[Azure AI Foundry](https://learn.microsoft.com/ai-studio) provides a unified platform for developing, testing, and deploying AI applications. The Aspire Azure AI Foundry integration enables you to connect to Azure AI Foundry services from your applications, providing access to various AI capabilities including model deployments, prompt flow, and more.
[Microsoft Foundry](https://learn.microsoft.com/ai-studio) provides a unified platform for developing, testing, and deploying AI applications. The Aspire Microsoft Foundry integration enables you to connect to Microsoft Foundry services from your applications, providing access to various AI capabilities including model deployments, prompt flow, and more.

In this introduction, you'll see how to install and use the Aspire Azure AI Foundry integrations in a simple configuration. If you already have this knowledge, see [Azure AI Foundry Hosting integration](/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-host/) for full reference details.
In this introduction, you'll see how to install and use the Aspire Microsoft Foundry integrations in a simple configuration. If you already have this knowledge, see [Microsoft Foundry Hosting integration](/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-host/) for full reference details.

<Aside type="note">
To follow this guide, you must have created an Aspire solution to work with. To learn how to do that, see [Build your first Aspire app](/get-started/first-app/).
</Aside>

## Set up hosting integration

To begin, install the Aspire Azure AI Foundry Hosting integration in your Aspire AppHost project. This integration allows you to create and manage Azure AI Foundry resources from your Aspire hosting projects:
To begin, install the Aspire Microsoft Foundry Hosting integration in your Aspire AppHost project. This integration allows you to create and manage Microsoft Foundry resources from your Aspire hosting projects:

<InstallPackage packageName="Aspire.Hosting.Azure.AIFoundry" />
<InstallPackage packageName="Aspire.Hosting.Foundry" />

Next, in the AppHost project, create an Azure AI Foundry resource and pass it to the consuming client projects:
Next, in the AppHost project, create a Microsoft Foundry resource and pass it to the consuming client projects:

```csharp title="C# — AppHost.cs"
var builder = DistributedApplication.CreateBuilder(args);

var foundry = builder.AddAzureAIFoundry("foundry");
var foundry = builder.AddFoundry("foundry");
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

and? AddProject?


var chat = foundry.AddDeployment("chat", "Phi-4", "1", "Microsoft");
var chat = foundry.AddDeployment("chat", FoundryModel.OpenAI.Gpt5Mini);

builder.AddProject<Projects.ExampleProject>()
.WithReference(chat)
Expand All @@ -52,14 +52,14 @@ builder.AddProject<Projects.ExampleProject>()
builder.Build().Run();
```

The preceding code adds an Azure AI Foundry resource named `foundry` with a deployment named `chat` using the Phi-4 model to the AppHost project. The `WithReference` method passes the connection information to the `ExampleProject` project.
The preceding code adds a Microsoft Foundry resource named `foundry` with a deployment named `chat` using the generated `FoundryModel.OpenAI.Gpt5Mini` descriptor. The `WithReference` method passes the connection information to the `ExampleProject` project.

<Aside type="caution">
When you call `AddAzureAIFoundry`, it implicitly calls `AddAzureProvisioning`—which adds support for generating Azure resources dynamically during app startup. The app must configure the appropriate subscription and location. For more information, see [Local provisioning: Configuration](/integrations/cloud/azure/local-provisioning/#configuration).
When you call `AddFoundry`, it implicitly calls `AddAzureProvisioning`—which adds support for generating Azure resources dynamically during app startup. The app must configure the appropriate subscription and location. For more information, see [Local provisioning: Configuration](/integrations/cloud/azure/local-provisioning/#configuration).
</Aside>

<Aside type="tip">
This is the simplest implementation of Azure AI Foundry resources in the AppHost. There are many more options you can choose from to address your requirements. For full details, see [Azure AI Foundry Hosting integration](/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-host/).
This is the simplest implementation of Microsoft Foundry resources in the AppHost. There are many more options you can choose from to address your requirements. For full details, see [Microsoft Foundry Hosting integration](/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-host/).
</Aside>

## Set up client integration
Expand All @@ -72,7 +72,7 @@ For more information on using the client integration, see the [Azure AI Inferenc

<CardGrid>
<LinkCard
title="Azure AI Foundry Hosting integration"
title="Microsoft Foundry Hosting integration"
description="Learn more about the hosting integration features and capabilities"
href="/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-host/"
/>
Expand Down
Loading