Migrate Agents created using Azure AI foundry > Azure AI Hub > Projects > Agents to Azure AI Foundry > Projects > Agents

Question

Migrate Agents created using Azure AI foundry > Azure AI Hub > Projects > Agents to Azure AI Foundry > Projects > Agents

67050851 0

I have multiple agents with vector store and files added to vector store in a Azure AI hub based projects. But looking at the sdk, latest version is only supporting to Azure AI Foundry based projects. How can i migrate these agents to Azure AI Foundry based projects.

https://learn.microsoft.com/en-us/azure/ai-foundry/what-is-azure-ai-foundry#which-type-of-project-do-i-need

SriLakshmi C 6,010 Reputation points Microsoft External Staff Moderator

2025-05-28T16:30:14.0466667+00:00

Hi @67050851,

Yes, your concern is absolutely valid. Azure AI Hub–based projects are still supported at the moment, but Microsoft is clearly moving toward Azure AI Foundry as the long-term platform. This is evident from the fact that the latest SDK versions are designed to work only with Foundry-based projects. While there hasn’t been any official deprecation announcement for Hub-based projects, the direction is clear, and continued investment will likely focus on Foundry.

Regarding the GitHub issue you referenced, the Microsoft team’s recommendation to use an earlier version of the SDK is intended as a short-term workaround. It means that while AI Hub projects still function with older SDKs, support for them in future SDK releases is unlikely to return. This suggests that AI Hub compatibility is being phased out and should not be relied upon for new development or long-term planning.

So, although Hub-based projects are not yet deprecated and remain usable, it is advisable to begin planning a migration to Azure AI Foundry. This ensures you remain compatible with ongoing SDK updates and new features. If you have hundreds of agents to migrate, it’s reasonable to phase the migration, but delaying it too long may result in operational friction as older SDKs lose support or compatibility.

Thank you!
SriLakshmi C 6,010 Reputation points Microsoft External Staff Moderator

2025-05-29T12:44:23.3866667+00:00

Hi @67050851,

Following up to see if the above suggestion was helpful. And, if you have any further query do let us know.

Thank you!
SriLakshmi C 6,010 Reputation points Microsoft External Staff Moderator

2025-05-30T05:24:13.3433333+00:00

Hi @67050851,

We haven’t heard from you on the last response and was just checking back to see if you have a resolution yet. In case if you have any resolution please do share that same with the community as it can be helpful to others. Otherwise, will respond with more details and we will try to help.

Thank you!

2 answers

Your answer

SriLakshmi C 6,010 Reputation points Microsoft External Staff Moderator

2025-05-28T16:30:14.0466667+00:00

Hi @67050851,

Yes, your concern is absolutely valid. Azure AI Hub–based projects are still supported at the moment, but Microsoft is clearly moving toward Azure AI Foundry as the long-term platform. This is evident from the fact that the latest SDK versions are designed to work only with Foundry-based projects. While there hasn’t been any official deprecation announcement for Hub-based projects, the direction is clear, and continued investment will likely focus on Foundry.

Regarding the GitHub issue you referenced, the Microsoft team’s recommendation to use an earlier version of the SDK is intended as a short-term workaround. It means that while AI Hub projects still function with older SDKs, support for them in future SDK releases is unlikely to return. This suggests that AI Hub compatibility is being phased out and should not be relied upon for new development or long-term planning.

So, although Hub-based projects are not yet deprecated and remain usable, it is advisable to begin planning a migration to Azure AI Foundry. This ensures you remain compatible with ongoing SDK updates and new features. If you have hundreds of agents to migrate, it’s reasonable to phase the migration, but delaying it too long may result in operational friction as older SDKs lose support or compatibility.

Thank you!
SriLakshmi C 6,010 Reputation points Microsoft External Staff Moderator

2025-05-29T12:44:23.3866667+00:00

Hi @67050851,

Following up to see if the above suggestion was helpful. And, if you have any further query do let us know.

Thank you!
SriLakshmi C 6,010 Reputation points Microsoft External Staff Moderator

2025-05-30T05:24:13.3433333+00:00

Hi @67050851,

We haven’t heard from you on the last response and was just checking back to see if you have a resolution yet. In case if you have any resolution please do share that same with the community as it can be helpful to others. Otherwise, will respond with more details and we will try to help.

Thank you!

Answer 1

Hello @67050851,

Yes, you're correct Microsoft is transitioning from Azure AI Hub–based projects to Azure AI Foundry–based projects, and the latest SDK versions now support only the Foundry-based setup. If you have agents built under AI Hub, migration to Foundry requires a manual but straightforward process, as there is no automated migration path at this time.

Here's are some steps to consider doing:

Before migrating, make sure you've set up a new Azure AI Foundry project. You can follow the quickstart guide to create it.

You will need to switch your code to use the updated SDK methods for Azure AI Foundry. As outlined in the migration guides, the way you create clients, agents, and upload files has changed. Ensure that you refer to the .NET Migration Guide or the Python Migration Guide to adjust the code you’re using.

Since a direct migration path is not available, you’ll need to manually recreate the agents in the new Azure AI Foundry project. Be sure to document any associated vector stores or files from the original setup, and re-upload them using the updated SDK methods.

After completing the migration, review your existing codebase to ensure compatibility. Since endpoint URLs and authentication methods differ in Azure AI Foundry, make sure to update all relevant connection settings accordingly.

Foundry projects use different endpoints and authentication mechanisms. Update your environment configuration and code to reflect these new details for smooth integration.

I hope this helps, do let me know if you have further queries.

Thank you!

Answer 2

67050851 0

Will the hub based projects be phased out? can you confirm please. It should not happen that we migrate 100s of hub based agents only to find out hub based projects are also GA.

Check this https://github.com/Azure/azure-sdk-for-python/issues/41197 where some one from microsoft said to use previous version of SDK for time being. What does that mean, does it mean that support for hub based projects in next version of SDK is expected?

Share via

Migrate Agents created using Azure AI foundry > Azure AI Hub > Projects > Agents to Azure AI Foundry > Projects > Agents

2 answers

Your answer