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
Original file line number Diff line number Diff line change
Expand Up @@ -54,10 +54,14 @@ Or, choose a manual installation approach:

<Aside type="note">
This integration was previously shipped as `Aspire.Hosting.Azure.AIFoundry`.
When upgrading from earlier previews, replace that package with
`Aspire.Hosting.Foundry`. If your code referenced package-specific Foundry
types such as the old `AIFoundryModel`, update those references to
`FoundryModel` and add `using Aspire.Hosting.Foundry;` where needed.
When upgrading from Aspire 13.1 or earlier, replace that package with
`Aspire.Hosting.Foundry` and rename `AddAzureAIFoundry(...)` to
`AddFoundry(...)`. Resource and model types moved from
`Aspire.Hosting.Azure` to `Aspire.Hosting.Foundry`; add
`using Aspire.Hosting.Foundry;` for direct type references and remove
`using Aspire.Hosting.Azure;` only if your code no longer uses other types
from that namespace. Extension methods remain in `Aspire.Hosting`. Update
renamed types such as `AIFoundryModel` to `FoundryModel`.
</Aside>

</TabItem>
Expand Down
29 changes: 18 additions & 11 deletions src/frontend/src/content/docs/ja/whats-new/aspire-13-2.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -892,9 +892,9 @@ await builder.build().run();
この領域の新しい API には、`AddProject`、`AddModelDeployment`、`WithAppInsights`、`WithKeyVault`、`WithContainerRegistry`、`PublishAsHostedAgent`、`AddAndPublishPromptAgent` があります。 `RunAsFoundryLocal` は引き続きローカル モデル開発に使用できますが、親リソースが Foundry Local として構成されている場合、Foundry プロジェクトはサポートされません。

<Aside type="caution">
これは破壊的な変更です。 `Aspire.Hosting.Azure.AIFoundry` が `Aspire.Hosting.Foundry`
に置き換えられました。移行手順における破壊的な変更については [AIFoundry から Foundry への
移行](#aifoundry-から-foundry-への移行) を
これは破壊的な変更です。`Aspire.Hosting.Azure.AIFoundry` が `Aspire.Hosting.Foundry`
に置き換えられました。移行手順における破壊的な変更については [Foundry パッケージと名前空間の
移行](#foundry-パッケージと名前空間の移行) を
参照してください。
</Aside>

Expand Down Expand Up @@ -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"
<ItemGroup>
<PackageReference Include="Aspire.Hosting.Foundry" Version="13.2.0" />
<PackageReference Include="Aspire.Hosting.Foundry" Version="13.2.0-preview.1.26170.3" />
</ItemGroup>
```

```csharp title="移行例"
```csharp title="C# — 移行例"
// 移行前
var ai = builder.AddAzureAIFoundry("ai");

Expand Down
29 changes: 18 additions & 11 deletions src/frontend/src/content/docs/whats-new/aspire-13-2.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -875,9 +875,9 @@ New APIs in this area include `AddProject`, `AddModelDeployment`, `WithAppInsigh

<Aside type="caution">
This is a breaking change. `Aspire.Hosting.Azure.AIFoundry` has been replaced
by `Aspire.Hosting.Foundry`. See the [AIFoundry to Foundry
transition](#aifoundry-to-foundry-transition) in breaking changes for
migration steps.
by `Aspire.Hosting.Foundry`. See the [Foundry package and namespace
transition](#foundry-package-and-namespace-transition) in breaking changes
for migration steps.
</Aside>

<LearnMore>
Expand Down Expand Up @@ -1280,22 +1280,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"
<ItemGroup>
<PackageReference Include="Aspire.Hosting.Foundry" Version="13.2.0" />
<PackageReference Include="Aspire.Hosting.Foundry" Version="13.2.0-preview.1.26170.3" />
</ItemGroup>
```

```csharp title="Migration example"
```csharp title="C# — Migration example"
// Before
var ai = builder.AddAzureAIFoundry("ai");

Expand Down
7 changes: 7 additions & 0 deletions src/frontend/src/content/docs/whats-new/aspire-9-4.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -1081,6 +1081,13 @@ var webService = builder.AddProject<Projects.WebService>("webservice")
builder.Build().Run();
```

<Aside type="note">
These Aspire 9.4 examples intentionally use `AddAzureAIFoundry`, the hosting
API available in that release. Aspire 13.2 renamed it to `AddFoundry`; see the
[Foundry package and namespace
transition](/whats-new/aspire-13-2/#foundry-package-and-namespace-transition).
</Aside>

#### 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:
Expand Down
Loading