From fb757de862e977bee4b03fa7320e6b420c511a4c Mon Sep 17 00:00:00 2001 From: David Pine <7679720+IEvangelist@users.noreply.github.com> Date: Fri, 7 Aug 2026 15:14:44 -0500 Subject: [PATCH 1/2] docs: clarify Foundry migration guidance Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../azure-ai-foundry-host.mdx | 12 ++++++--- .../content/docs/ja/whats-new/aspire-13-2.mdx | 27 ++++++++++++------- .../content/docs/whats-new/aspire-13-2.mdx | 27 ++++++++++++------- .../src/content/docs/whats-new/aspire-9-4.mdx | 7 +++++ 4 files changed, 49 insertions(+), 24 deletions(-) diff --git a/src/frontend/src/content/docs/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-host.mdx b/src/frontend/src/content/docs/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-host.mdx index 606e9fff3..08f364361 100644 --- a/src/frontend/src/content/docs/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-host.mdx +++ b/src/frontend/src/content/docs/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-host.mdx @@ -54,10 +54,14 @@ Or, choose a manual installation approach: diff --git a/src/frontend/src/content/docs/ja/whats-new/aspire-13-2.mdx b/src/frontend/src/content/docs/ja/whats-new/aspire-13-2.mdx index 95cc8eb84..df66bfb1c 100644 --- a/src/frontend/src/content/docs/ja/whats-new/aspire-13-2.mdx +++ b/src/frontend/src/content/docs/ja/whats-new/aspire-13-2.mdx @@ -892,9 +892,9 @@ await builder.build().run(); この領域の新しい API には、`AddProject`、`AddModelDeployment`、`WithAppInsights`、`WithKeyVault`、`WithContainerRegistry`、`PublishAsHostedAgent`、`AddAndPublishPromptAgent` があります。 `RunAsFoundryLocal` は引き続きローカル モデル開発に使用できますが、親リソースが Foundry Local として構成されている場合、Foundry プロジェクトはサポートされません。 @@ -1227,22 +1227,29 @@ AppHost に統合されたダッシュボード シナリオは、As​​pire.H 接続プロパティのサフィックスが追加されました。接続プロパティに直接アクセスするコードの更新が必要になる場合があります。 -### AIFoundry から Foundry への移行 +### Foundry パッケージと名前空間の移行 -`Aspire.Hosting.Azure.AIFoundry` は、より広い `Aspire.Hosting.Foundry` サーフェスに置き換えられました。 +Aspire 13.2 では、Foundry ホスティング サーフェスが `Aspire.Hosting.Foundry` に統一されました。 -アップグレードする場合は、次の両方の変更を加えます: +| 以前の 13.1 名称 | 13.2 の名称 | +| ---------------- | ----------- | +| ホスティング パッケージ: `Aspire.Hosting.Azure.AIFoundry` | ホスティング パッケージ: `Aspire.Hosting.Foundry` | +| リソース型とモデル型の名前空間: `Aspire.Hosting.Azure` | リソース型とモデル型の名前空間: `Aspire.Hosting.Foundry` | +| `AddAzureAIFoundry(...)` | `AddFoundry(...)` | +| `AzureAIFoundryResource` | `FoundryResource` | +| `AzureAIFoundryExtensions` | `FoundryExtensions` | +| `AzureAIFoundryDeploymentResource` | `FoundryDeploymentResource` | +| `AIFoundryModel` | `FoundryModel` | -- `Aspire.Hosting.Azure.AIFoundry` パッケージ参照を `Aspire.Hosting.Foundry` に置き換えます。 -- `AddAzureAIFoundry()` から `AddFoundry()` に移行し、`AddDeployment()` または `AddModelDeployment()` を使用してデプロイメントを明示的に追加します。 +移行のヒント: パッケージ参照を更新し、リソース型またはモデル型を直接参照する場合は `using Aspire.Hosting.Foundry;` を追加し、`AddAzureAIFoundry(...)` を `AddFoundry(...)` に変更してください。`using Aspire.Hosting.Azure;` は、コードでその名前空間の他の型を使用しなくなった場合にのみ削除してください。拡張メソッドの名前空間は引き続き `Aspire.Hosting` です。 -```xml title="AppHost project file" +```xml title="XML — AppHost project file" ``` -```csharp title="移行例" +```csharp title="C# — 移行例" // 移行前 var ai = builder.AddAzureAIFoundry("ai"); diff --git a/src/frontend/src/content/docs/whats-new/aspire-13-2.mdx b/src/frontend/src/content/docs/whats-new/aspire-13-2.mdx index 979e644be..e5b1bac2e 100644 --- a/src/frontend/src/content/docs/whats-new/aspire-13-2.mdx +++ b/src/frontend/src/content/docs/whats-new/aspire-13-2.mdx @@ -893,9 +893,9 @@ New APIs in this area include `AddProject`, `AddModelDeployment`, `WithAppInsigh @@ -1300,22 +1300,29 @@ C# apps that consume the Aspire client integrations (for example, `AddNpgsqlData For the full per-resource property catalog, see the **Connection properties** section on each integration's *connect* page — for example, [Connect to Azure Cosmos DB](/integrations/cloud/azure/azure-cosmos-db/azure-cosmos-db-connect/#connection-properties), [Connect to SQL Server](/integrations/databases/sql-server/sql-server-connect/#connection-properties), or [Connect to GitHub Models](/integrations/ai/github-models/github-models-connect/#connection-properties). -### AIFoundry to Foundry transition +### Foundry package and namespace transition -`Aspire.Hosting.Azure.AIFoundry` was replaced by the broader `Aspire.Hosting.Foundry` surface. +Aspire 13.2 standardizes the Foundry hosting surface under `Aspire.Hosting.Foundry`. -When upgrading, make both of these changes: +| Previous 13.1 name | 13.2 name | +| ------------------ | --------- | +| Hosting package: `Aspire.Hosting.Azure.AIFoundry` | Hosting package: `Aspire.Hosting.Foundry` | +| Resource and model namespace: `Aspire.Hosting.Azure` | Resource and model namespace: `Aspire.Hosting.Foundry` | +| `AddAzureAIFoundry(...)` | `AddFoundry(...)` | +| `AzureAIFoundryResource` | `FoundryResource` | +| `AzureAIFoundryExtensions` | `FoundryExtensions` | +| `AzureAIFoundryDeploymentResource` | `FoundryDeploymentResource` | +| `AIFoundryModel` | `FoundryModel` | -- Replace the `Aspire.Hosting.Azure.AIFoundry` package reference with `Aspire.Hosting.Foundry`. -- Migrate from `AddAzureAIFoundry()` to `AddFoundry()`, then add deployments explicitly with `AddDeployment()` or `AddModelDeployment()`. +Migration tip: update your package reference, add `using Aspire.Hosting.Foundry;` for direct resource or model type references, and rename `AddAzureAIFoundry(...)` to `AddFoundry(...)`. Remove `using Aspire.Hosting.Azure;` only if your code no longer uses other types from that namespace. Extension methods remain in the `Aspire.Hosting` namespace. -```xml title="AppHost project file" +```xml title="XML — AppHost project file" ``` -```csharp title="Migration example" +```csharp title="C# — Migration example" // Before var ai = builder.AddAzureAIFoundry("ai"); diff --git a/src/frontend/src/content/docs/whats-new/aspire-9-4.mdx b/src/frontend/src/content/docs/whats-new/aspire-9-4.mdx index 0599f394b..1a639c9e7 100644 --- a/src/frontend/src/content/docs/whats-new/aspire-9-4.mdx +++ b/src/frontend/src/content/docs/whats-new/aspire-9-4.mdx @@ -1080,6 +1080,13 @@ var webService = builder.AddProject("webservice") builder.Build().Run(); ``` + + #### Client integration Once you've configured the [Azure AI Foundry resource](https://aspire.dev/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-get-started/) in your AppHost, consume it in your services using the [Azure AI Inference SDK](https://aspire.dev/integrations/cloud/azure/azure-ai-inference/azure-ai-inference-get-started/) or [OpenAI SDK](https://aspire.dev/integrations/cloud/azure/azure-openai/azure-openai-get-started/) for compatible models: From 460b3e431ac653aa818ce438343ba3d9b74e81cb Mon Sep 17 00:00:00 2001 From: Maddy Montaquila Date: Tue, 15 Sep 2026 10:28:32 +0200 Subject: [PATCH 2/2] docs: update Foundry package versions Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: b8ebe88c-337e-4d4a-aa80-e14c2c76289b --- .../cloud/azure/azure-ai-foundry/azure-ai-foundry-host.mdx | 2 +- src/frontend/src/content/docs/ja/whats-new/aspire-13-2.mdx | 2 +- src/frontend/src/content/docs/whats-new/aspire-13-2.mdx | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/src/frontend/src/content/docs/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-host.mdx b/src/frontend/src/content/docs/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-host.mdx index 08f364361..23a0c9eb8 100644 --- a/src/frontend/src/content/docs/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-host.mdx +++ b/src/frontend/src/content/docs/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-host.mdx @@ -81,7 +81,7 @@ This updates your `aspire.config.json` with the Azure AI Foundry hosting integra ```json title="aspire.config.json" ins={3} { "packages": { - "Aspire.Hosting.Foundry": "13.3.0-preview.1.26256.5" + "Aspire.Hosting.Foundry": "13.5.3-preview.1.26425.3" } } ``` diff --git a/src/frontend/src/content/docs/ja/whats-new/aspire-13-2.mdx b/src/frontend/src/content/docs/ja/whats-new/aspire-13-2.mdx index df66bfb1c..ff9714479 100644 --- a/src/frontend/src/content/docs/ja/whats-new/aspire-13-2.mdx +++ b/src/frontend/src/content/docs/ja/whats-new/aspire-13-2.mdx @@ -1245,7 +1245,7 @@ Aspire 13.2 では、Foundry ホスティング サーフェスが `Aspire.Hosti ```xml title="XML — AppHost project file" - + ``` diff --git a/src/frontend/src/content/docs/whats-new/aspire-13-2.mdx b/src/frontend/src/content/docs/whats-new/aspire-13-2.mdx index e5b1bac2e..74f8648ac 100644 --- a/src/frontend/src/content/docs/whats-new/aspire-13-2.mdx +++ b/src/frontend/src/content/docs/whats-new/aspire-13-2.mdx @@ -1318,7 +1318,7 @@ Migration tip: update your package reference, add `using Aspire.Hosting.Foundry; ```xml title="XML — AppHost project file" - + ```