You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/ai-foundry/how-to/migate-project.md
+63-51Lines changed: 63 additions & 51 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,20 +10,20 @@ ms.reviewer: deeikele
10
10
11
11
# Migrate from hub-based to Foundry projects
12
12
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.
14
14
15
15
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).
16
16
17
17
> [!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.
19
19
20
20
## New Foundry projects overview
21
21
22
22
Foundry projects are designed to unify and simplify the composition of developer workflows, and the management of core building blocks of AI applications:
23
23
24
24
- Models
25
25
- Agents & their tools
26
-
- Observability, security and trust
26
+
- Observability, security, and trust
27
27
28
28
Previously, AI Foundry project's capabilities required the management of multiple Azure resources and SDKs for workflows in the backend to compose these components.
29
29
@@ -35,16 +35,16 @@ New capabilities include:
35
35
36
36
-**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.
37
37
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.
39
39
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.
41
41
42
42
> [!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).
44
44
45
45
## How to switch to Foundry project
46
46
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:
48
48
49
49
1.[Locate your existing AI Foundry resource)(#locate)
50
50
1.[Create a project](#create-project)
@@ -61,43 +61,43 @@ What can you take forward to the new project type?
61
61
62
62
Limitations:
63
63
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.
66
66
67
67
## <aname="locate"></a> 1. Locate your existing AI Foundry resource
68
68
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.
70
70
71
71
> [!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).
73
73
74
74
# [Azure AI Foundry portal](#tab/azure-ai-foundry)
75
75
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.
81
80
82
81
:::image type="content" source="../media/migrate-project/find-resource.png" alt-text="Screenshot of AI Foundry connection details.":::
83
82
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.
85
84
86
85
:::image type="content" source="../media/migrate-project/resource-details.png" alt-text="Screenshot of Foundry resource in management center.":::
87
86
88
87
# [Azure portal](#tab/azure)
89
88
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.')
91
91
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.":::
93
93
94
-
- Follow its link to open its resource overview page.
94
+
- Follow the link to open the Foundry resource overview page.
95
95
96
96
# [Bicep](#tab/bicep)
97
97
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.
99
99
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.
101
101
102
102
---
103
103
@@ -107,63 +107,74 @@ New capabilities, including Agent service, are only accessible via projects, whi
107
107
108
108
# [Azure AI Foundry portal](#tab/azure-ai-foundry)
109
109
110
-
- Picking up from management center overview, create a project.
110
+
You can create a new project in one of two ways:
111
111
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**.
113
121
114
-
-Post-creation, follow its link, and return to resource build view 'go to project'.
122
+
-In the **Agents** section of your resource:
115
123
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.
117
126
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.":::
119
128
120
129
# [Azure portal](#tab/azure)
121
130
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**.
123
134
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.":::
125
136
126
137
# [Bicep](#tab/bicep)
127
138
128
139
- 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).
129
140
130
141
- By default, in the basic configuration, Agent service uses deployments and storage capabilities that come with your AI Foundry resource.
131
142
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.
133
144
134
145
---
135
146
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.
137
148
138
149
:::image type="content" source="../media/migrate-project/agent-playground.png" alt-text="Screenshot of agent building interface.":::
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.
143
154
144
155
# [Azure AI Foundry portal](#tab/azure-ai-foundry)
145
156
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)].
147
158
148
159
# [Azure portal](#tab/azure)
149
160
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.
151
162
152
163
# [Bicep](#tab/bicep)
153
164
154
165
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).
155
166
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.
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:
163
174
164
175
1. Install the [latest version](/azure/ai-foundry/agents/quickstart?pivots=programming-language-python-azure) of your preferred SDK client.
165
176
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:
167
178
168
179
```python
169
180
from azure.identity import DefaultAzureCredential
@@ -178,39 +189,40 @@ Any code agents build using the preview of Agent service, require the following
178
189
179
190
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.
180
191
181
-
## 5. (Optional) Clean up hub-based projects
192
+
## 5. (Optional) Clean up hubbased projects
182
193
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.
184
195
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:
186
197
187
-
- Access to select features that are notsupported yet inFoundry 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).
188
199
189
-
- Use cases that are focused on custom machine learning model training. Hub-based projects asbuilt on Azure MLstack andcontinue 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)] isbuilt on the Azure Machine Learning stack andcontinues to be accessible via Azure Machine Learning Studio/CLI/SDK.
190
201
191
202
# [Azure AI Foundry portal](#tab/azure-ai-foundry)
192
203
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)].
196
205
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**.
197
210
- 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 andall its projects. This link will open the Azure portal for you to delete the hub.
200
212
201
213
# [Azure portal](#tab/azure)
202
214
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 andall its associated projects.
206
218
207
219
# [Bicep](#tab/bicep)
208
220
209
221
- Keep *CognitiveServices/account/kind=AIServices* resource type. This is your Foundry resource.
210
222
211
223
- Remove *Microsoft.MachineLearningServices/workspace/kind=project*and*Microsoft.MachineLearningServices/workspace/kind=hub*from your template definition.
212
224
213
-
- Use alternative methods for resource deletion, since this isnot supported via Bicep.
225
+
- Use alternative methods for resource deletion, since this isn't supported via Bicep.
0 commit comments