Skip to content

Commit f971053

Browse files
committed
acrolinx + step updates
1 parent eb3e83a commit f971053

File tree

1 file changed

+63
-51
lines changed

1 file changed

+63
-51
lines changed

articles/ai-foundry/how-to/migate-project.md

Lines changed: 63 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -10,20 +10,20 @@ ms.reviewer: deeikele
1010

1111
# Migrate from hub-based to Foundry projects
1212

13-
This guide is for existing customers with hub-based projects and explains the steps for switching from a [!INCLUDE [hub-project-name](../includes/hub-project-name.md)]to the new [!INCLUDE [fdp-project-name](../includes/fdp-project-name.md)] to access the latest platform capabilities.
13+
This guide is for existing customers with hub-based projects and explains the steps for switching from a [!INCLUDE [hub-project-name](../includes/hub-project-name.md)] to the new [!INCLUDE [fdp-project-name](../includes/fdp-project-name.md)] to access the latest platform capabilities.
1414

1515
Azure AI Foundry is transitioning to a unified platform-as-a-service, replacing the previous resource model that required management of multiple Azure services. These changes simplify platform setup and governance, enhance workflows that span multiple models and Foundry tools, and reinforce governance capabilities, as we see AI workloads grow more complex. [Learn more](https://techcommunity.microsoft.com/blog/AIPlatformBlog/build-recap-new-azure-ai-foundry-resource-developer-apis-and-tools/4427241ljQ7vS7hdrIhNLjmw?e=PU9gmv).
1616

1717
> [!IMPORTANT]
18-
> New generative AI and model-centric features will be available only through the AI Foundry resource and its Foundry projects. Currently, some capabilities still require a hub next to your Foundry resource.
18+
> New generative AI and model-centric features are available only through the AI Foundry resource and its Foundry projects. Currently, some capabilities still require a hub next to your Foundry resource.
1919
2020
## New Foundry projects overview
2121

2222
Foundry projects are designed to unify and simplify the composition of developer workflows, and the management of core building blocks of AI applications:
2323

2424
- Models
2525
- Agents & their tools
26-
- Observability, security and trust
26+
- Observability, security, and trust
2727

2828
Previously, AI Foundry project's capabilities required the management of multiple Azure resources and SDKs for workflows in the backend to compose these components.
2929

@@ -35,16 +35,16 @@ New capabilities include:
3535

3636
- **Azure AI Foundry SDK** wraps the Foundry API making it easy to integrate capabilities into code whether your application is built in Python, C#, JavaScript/TypeScript or Java.
3737

38-
- **Agents, Models and Tooling connections** are managed together on Foundry for permission management, networking, cost analysis and policy configuration. Previously certain tools and models were accessed via Azure ML's hub, requiring also the provisioning of additional storage and key vault resources.
38+
- **Agents, Models and Tooling connections** are managed together on Foundry for permission management, networking, cost analysis, and policy configuration. Previously certain tools and models were accessed via Azure Machine Learning's hub, requiring also the provisioning of extra storage and key vault resources.
3939

40-
- **Projects are now child resources**; they may be assigned their own admin controls like Azure RBAC, but by default share common settings from their parent resource. This principle aims to take IT admins out of the day-to-day loop. Once security, resource connectivity and governance are established at the resource level, as developer you can create your own project as a folder to organize your work.
40+
- **Projects are now child resources**; they might be assigned their own admin controls like Azure RBAC, but by default share common settings from their parent resource. This principle aims to take IT admins out of the day-to-day loop. Once security, resource connectivity and governance are established at the resource level, as developer you can create your own project as a folder to organize your work.
4141

4242
> [!IMPORTANT]
43-
> Foundry projects feature set are not yet on full parity with hub-based projects. For an up-to-date view on supported features, see [this support matrix](/azure/ai-foundry/what-is-azure-ai-foundry#which-type-of-project-do-i-need).
43+
> Foundry projects feature set aren't yet on full parity with hub-based projects. For an up-to-date view on supported features, see [this support matrix](/azure/ai-foundry/what-is-azure-ai-foundry#which-type-of-project-do-i-need).
4444
4545
## How to switch to Foundry project
4646

47-
In the following sections, we will walk step-by-step by how you can move from hub-based projects to Foundry projects:
47+
In the following sections, we walk step-by-step by how you can move from [!INCLUDE [hub-project-name](../includes/hub-project-name.md)]s to [!INCLUDE [fdp-project-name](../includes/fdp-project-name.md)]s:
4848

4949
1. [Locate your existing AI Foundry resource)(#locate)
5050
1. [Create a project](#create-project)
@@ -61,43 +61,43 @@ What can you take forward to the new project type?
6161

6262
Limitations:
6363

64-
- Preview Agent's state, including messages, thread, and files cannot be moved. However, you can recreate your agent using code in your new project.
65-
- Open-source model deployments are not yet supported in Foundry projects.
64+
- Your Preview Agent's state, including messages, thread, and files can't be moved. However, you can recreate your agent using code in your new project.
65+
- Open-source model deployments aren't currently supported in Foundry projects.
6666

6767
## <a name="locate"></a> 1. Locate your existing AI Foundry resource
6868

69-
Most AI Foundry users will already have an 'AI Foundry' (formerly called 'AI Services') resource, which was previously created alongside your hub-based project to access model deployments.
69+
Most Azure AI Foundry users already have an 'AI Foundry' (formerly called 'AI Services') resource, which was previously created alongside your hub-based project to access model deployments.
7070

7171
> [!NOTE]
72-
> If you don't have an existing AI Foundry resource, most common because your hub was using Azure OpenAI for accessing model deployments, you must [create a new AI Foundry resource first](./create-azure-ai-resource.md). You may [connect](./connections-add.md) your existing Azure OpenAI resource for continued access to existing model deployments. Additional configuration steps apply for use with Agent service, see [below](#link-to-bicep-section) and [Agent standard setup](../agents/concepts/standard-agent-setup).
72+
> If you don't have an existing AI Foundry resource, most common because your hub was using Azure OpenAI for accessing model deployments, you must [create a new AI Foundry resource first](./create-azure-ai-resource.md). You can [connect](./connections-add.md) your existing Azure OpenAI resource for continued access to existing model deployments. Other configuration steps apply for use with Agent service. See details in [Create a project to build with agents (Bicep)](#create-project?tabs=bicep) and [Agent standard setup](../agents/concepts/standard-agent-setup).
7373
7474
# [Azure AI Foundry portal](#tab/azure-ai-foundry)
7575

76-
Starting with your hub-based project, locate your existing AI Foundry resource:
77-
78-
- Navigate to 'management center' > hub 'connected resources'.
79-
80-
- Find the 'AI Foundry' connection, and follow the link to view its details.
76+
- In [Azure AI Foundry portal](https://ai.azure.com), open your [!INCLUDE [hub-project-name](../includes/hub-project-name.md)].
77+
- In the left pane, select **Management center**.
78+
- Select **Connected resources** under the **Hub** section.
79+
- Find the **AI Foundry models** connection, and select the link to view its details.
8180

8281
:::image type="content" source="../media/migrate-project/find-resource.png" alt-text="Screenshot of AI Foundry connection details.":::
8382

84-
- Follow the link in the connection details to switch to your Foundry resource in management center.
83+
- Follow the link in the connection details to open your Foundry resource overview page.
8584

8685
:::image type="content" source="../media/migrate-project/resource-details.png" alt-text="Screenshot of Foundry resource in management center.":::
8786

8887
# [Azure portal](#tab/azure)
8988

90-
- From your Foundry deployment resource group, locate your resource with 'Azure AI Foundry' resource type. Note that previously this was shown as 'AI Services'.
89+
- In [Azure portal](https://portal.azure.com), select the resource group that contains your [!INCLUDE [hub-project-name](../includes/hub-project-name.md)].
90+
- Locate your resource with 'Azure AI Foundry' resource type. (This resource type used to be shown as 'AI Services.')
9191

92-
:::image type="content" source="../media/migrate-project/resource-azure-portal.png" alt-text="Screenshot of Azure AI Foundry resource in Azure Portal.":::
92+
:::image type="content" source="../media/migrate-project/resource-azure-portal.png" alt-text="Screenshot of Azure AI Foundry resource in Azure portal.":::
9393

94-
- Follow its link to open its resource overview page.
94+
- Follow the link to open the Foundry resource overview page.
9595

9696
# [Bicep](#tab/bicep)
9797

98-
- If you use infrastructure-as-code templates such as Bicep (or Azure Resource Manager template, or Terraform), your template will typically contain multiple Azure resources.
98+
- If you use infrastructure-as-code templates such as Bicep (or Azure Resource Manager template, or Terraform), your template typically contains multiple Azure resources.
9999

100-
- Locate the resource of the *type CognitiveServices/account/kind=AIServices*. This is your 'AI Foundry resource', as it's displayed in Foundry Portal or Azure Portal.
100+
- Locate the resource of the *type CognitiveServices/account/kind=AIServices*. This resource is your 'AI Foundry resource,' as it's displayed in Azure AI Foundry portal or Azure portal.
101101

102102
---
103103

@@ -107,63 +107,74 @@ New capabilities, including Agent service, are only accessible via projects, whi
107107

108108
# [Azure AI Foundry portal](#tab/azure-ai-foundry)
109109

110-
- Picking up from management center overview, create a project.
110+
You can create a new project in one of two ways:
111111

112-
:::image type="content" source="../media/migrate-project/create-project.png" alt-text="Screenshot of creating a project in management center.":::
112+
- In the Management center:
113+
114+
- In the left pane, select **Management center** to manage the Foundry resource.
115+
- Select **Overview** under the **Resource** section.
116+
- Select **New project** to create a project in this resource. This will create a [!INCLUDE [fdp-project-name](../includes/fdp-project-name.md)].
117+
118+
:::image type="content" source="../media/migrate-project/create-project.png" alt-text="Screenshot of creating a project in management center.":::
119+
120+
- Once the project is created, in the left pane, select **Go to project**.
113121

114-
- Post-creation, follow its link, and return to resource build view 'go to project'.
122+
- In the **Agents** section of your resource:
115123

116-
- Alternatively, if you started in the regular resource view, under the `Agents` tab, you'll be automatically prompted to create a new Foundry project.
124+
- In the left pane, select **Agents**
125+
- Since the resource doesn't yet have a project, you are prompted to create one.
117126

118-
:::image type="content" source="../media/migrate-project/create-from-agent.png" alt-text="Screenshot of Agents tab prompting to create a new Foundry project.":::
127+
:::image type="content" source="../media/migrate-project/create-from-agent.png" alt-text="Screenshot of Agents tab prompting to create a new Foundry project.":::
119128

120129
# [Azure portal](#tab/azure)
121130

122-
- Navigate to 'projects' in the left side nav and add your first project.
131+
- In the left pane, select **Projects** under the **Resource management** section.
132+
- Select **New** to create a new project.
133+
- Supply a name and select **Create**.
123134

124-
:::image type="content" source="../media/migrate-project/new-project-azure-portal.png" alt-text="Screenshot of projects navigation in Azure Portal.":::
135+
:::image type="content" source="../media/migrate-project/new-project-azure-portal.png" alt-text="Screenshot of projects navigation in Azure portal.":::
125136

126137
# [Bicep](#tab/bicep)
127138

128139
- In your template, a project is declared as a child resource under your Foundry resource as shown in [this example](https://github.com/azure-ai-foundry/foundry-samples/tree/main/samples/microsoft/infrastructure-setup/42-basic-agent-setup-with-customization).
129140

130141
- By default, in the basic configuration, Agent service uses deployments and storage capabilities that come with your AI Foundry resource.
131142

132-
- Optionally, Agent service supports the ability to use existing Azure OpenAI resources for model deployments, and to bring your own storage resources for storing threads, messages and files. This is also referred as 'Standard' setup. See [this example](https://github.com/azure-ai-foundry/foundry-samples/tree/main/samples/microsoft/infrastructure-setup/43-standard-agent-setup-with-customization) for reference Bicep templates.
143+
- Optionally, Agent service supports the ability to use existing Azure OpenAI resources for model deployments, and to bring your own storage resources for storing threads, messages, and files. This is also referred as 'Standard' setup. See [this example](https://github.com/azure-ai-foundry/foundry-samples/tree/main/samples/microsoft/infrastructure-setup/43-standard-agent-setup-with-customization) for reference Bicep templates.
133144

134145
---
135146

136-
You are now ready to start building agents in general availability and with the latest capabilities. [Get started](/azure/ai-foundry/agents/quickstart?pivots=ai-foundry-portal) using SDK or Agent playground.
147+
You're now ready to start building agents in general availability and with the latest capabilities. [Get started](/azure/ai-foundry/agents/quickstart?pivots=ai-foundry-portal) using SDK or Agent playground.
137148

138149
:::image type="content" source="../media/migrate-project/agent-playground.png" alt-text="Screenshot of agent building interface.":::
139150

140151
## <a name="recreate-connections"></a> 3. (Optional) Recreate connections
141152

142-
If your hub based project used connections to access tools, data sources or models, you can recreate those on your upgraded Foundry resource, without the use of a hub.
153+
If your [!INCLUDE [hub-project-name](../includes/hub-project-name.md)] used connections to access tools, data sources, or models, you can recreate those connections on your Foundry resource, without the use of a hub.
143154

144155
# [Azure AI Foundry portal](#tab/azure-ai-foundry)
145156

146-
Navigate to 'management center' to [add any connections](/azure/ai-foundry/how-to/connections-add?pivots=fdp-project) to tools and data you used before in your hub-based project.
157+
In the **Management center**, [add any connections](/azure/ai-foundry/how-to/connections-add?pivots=fdp-project) to tools and data you used before in your initial [!INCLUDE [hub-project-name](../includes/hub-project-name.md)].
147158

148159
# [Azure portal](#tab/azure)
149160

150-
Use either the Azure AI Foundry portal or Bicep template to add your connections.
161+
You can't add connections in the Azure portal. Use either the Azure AI Foundry portal or Bicep template to add your connections.
151162

152163
# [Bicep](#tab/bicep)
153164

154165
If you prefer using Bicep templates, see [this repository with examples](https://github.com/azure-ai-foundry/foundry-samples/tree/main/samples/microsoft/infrastructure-setup/01-connections).
155166

156-
Note that connections are now defined as instances of type *CognitiveServices/account/connections,* and *CognitiveServices/account/project/connections.* Choose account-level connections for shared access across projects.
167+
Connections are now defined as instances of type *CognitiveServices/account/connections,* and *CognitiveServices/account/project/connections.* Choose account-level connections for shared access across projects.
157168

158169
---
159170

160171
## <a name="migrate-agents"></a> 4. (Optional) Migrate code agents
161172

162-
Any code agents build using the preview of Agent service, require the following upgrades as you move to Agent service in general availability on Foundry projects:
173+
Any code agents build using the preview of Agent service require the following upgrades as you move to Agent service in general availability on Foundry projects:
163174

164175
1. Install the [latest version](/azure/ai-foundry/agents/quickstart?pivots=programming-language-python-azure) of your preferred SDK client.
165176

166-
1. Update your project client to use the Foundry API. Instead of a connection string, you'll now use the Azure AI Foundry project endpoint. For example, in Pyton:
177+
1. Update your project client to use the Foundry API. Instead of a connection string, you now use the Azure AI Foundry project endpoint. For example, in Python:
167178

168179
```python
169180
from azure.identity import DefaultAzureCredential
@@ -178,39 +189,40 @@ Any code agents build using the preview of Agent service, require the following
178189

179190
See the [SDK migration guide](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/ai/azure-ai-projects/AGENTS_MIGRATION_GUIDE.md) on how to update your existing code.
180191

181-
## 5. (Optional) Clean up hub-based projects
192+
## 5. (Optional) Clean up hub based projects
182193

183-
If you no longer require access to your hub-based projects, delete them from your Azure subscription.
194+
If you no longer require access to your [!INCLUDE [hub-project-name](../includes/hub-project-name.md)]s, delete them from your Azure subscription.
184195

185-
There are some reasons you might want to keep hubs and hub-based projects around in your subscription:
196+
There are some reasons you might want to keep hubs and [!INCLUDE [hub-project-name](../includes/hub-project-name.md)]s around in your subscription:
186197

187-
- Access to select features that are not supported yet in Foundry projects, see [this support matrix](/azure/ai-foundry/what-is-azure-ai-foundry#which-type-of-project-do-i-need).
198+
- Access to select features that aren't supported yet in [!INCLUDE [fdp-project-name](../includes/fdp-project-name.md)]s. See [this support matrix](/azure/ai-foundry/what-is-azure-ai-foundry#which-type-of-project-do-i-need).
188199

189-
- Use cases that are focused on custom machine learning model training. Hub-based projects as built on Azure ML stack and continue to be accessible via Azure ML Studio/CLI/SDK.
200+
- Use cases that are focused on custom machine learning model training. A [!INCLUDE [hub-project-name](../includes/hub-project-name.md)] is built on the Azure Machine Learning stack and continues to be accessible via Azure Machine Learning Studio/CLI/SDK.
190201

191202
# [Azure AI Foundry portal](#tab/azure-ai-foundry)
192203

193-
- Navigate to management center from a hub-based project.
194-
195-
- Navigate to 'hub' -> overview in left side nav.
204+
- In [Azure AI Foundry portal](https://ai.azure.com), open your [!INCLUDE [hub-project-name](../includes/hub-project-name.md)].
196205

206+
- Select **Management center**.
207+
- Select **Overview** under the **Hub** section.
208+
- Select any projects you no longer want to keep.
209+
- Select **Delete project**.
197210
- Delete any projects you no longer want to keep.
198-
199-
- Delete your hub.
211+
- In the **Hub properties** section on the right, select **Delete hub** if you want to delete the hub and all its projects. This link will open the Azure portal for you to delete the hub.
200212

201213
# [Azure portal](#tab/azure)
202214

203-
- In your resource group, locate your 'AI Hub' resource.
204-
205-
- Azure Portal deletion flow will guide into its deletion and its associated projects.
215+
- In [Azure portal](https://portal.azure.com), select the resource group that contains your [!INCLUDE [hub-project-name](../includes/hub-project-name.md)].
216+
- Select the link for the **Azure AI hub** resource.
217+
- Select **Delete** to delete the hub and all its associated projects.
206218

207219
# [Bicep](#tab/bicep)
208220

209221
- Keep *CognitiveServices/account/kind=AIServices* resource type. This is your Foundry resource.
210222

211223
- Remove *Microsoft.MachineLearningServices/workspace/kind=project* and *Microsoft.MachineLearningServices/workspace/kind=hub* from your template definition.
212224

213-
- Use alternative methods for resource deletion, since this is not supported via Bicep.
225+
- Use alternative methods for resource deletion, since this isn't supported via Bicep.
214226

215227
---
216228

0 commit comments

Comments
 (0)