Migrar desde el portal Foundry (clásico)

Microsoft Foundry ha evolucionado a través de varios cambios de nomenclatura y arquitectura. Si va a pasar de la experiencia del portal clásico, este artículo le ayuda a planear y ejecutar la transición con asignaciones de referencia para terminología, funcionalidades, SDK y navegación del portal.

Requisitos previos

• Una cuenta de Azure con una suscripción activa. Cree uno gratis.
• Un proyecto de fundición.
• Para la migración del SDK: Python 3.9+ o .NET 8+, asegurando que los paquetes azure-ai-projects 2.x y openai estén instalados.
• Para la actualización de recursos: rol de Propietario o Colaborador en el recurso de Azure OpenAI que planea actualizar.

Planeamiento de la migración

Siga estos pasos para pasar de la experiencia del portal clásico al portal de Foundry actual:

1. Revise los cambios de terminología. Examine la asignación de terminología para comprender los conceptos con cambio de nombre y los nuevos tipos de recursos.
2. Compruebe la comparación de características. Use la tabla de comparación de características para identificar las funcionalidades nuevas, mejoradas o solo clásicas.
3. Actualice los paquetes del SDK. Reemplace los paquetes en desuso mediante la tabla de asignación del SDK .
4. Migre agentes a la API de respuestas. Vuelva a escribir agentes que usan la API de asistentes para usar la API de respuestas antes de su retirada en agosto de 2026.
5. Compruebe que la región de recursos de Foundry admite la API de respuestas. La API de Responses y el servicio de agente Foundry no están disponibles en todas las regiones de Azure. Si el recurso foundry está en una región no admitida, los agentes y otras características de la API de respuestas no funcionan en el portal actual. Compruebe la lista de disponibilidad de la región de la API de respuestas antes de migrar.
6. Valide en el nuevo portal. Use la referencia de navegación del portal para comprobar los flujos de trabajo en la experiencia actual.

Asignación de terminología

En la tabla siguiente se asignan los conceptos clásicos a sus equivalentes actuales.

Asignación del SDK

Use la tabla siguiente para identificar qué paquetes del SDK se asignan a la experiencia de Foundry actual y cuáles reemplazan.

En el ejemplo siguiente se muestra la migración del SDK más común, reemplazando el cliente de Azure específico AzureOpenAI por el cliente OpenAI estándar.

Clásico (antes):

from openai import AzureOpenAI

client = AzureOpenAI(
    azure_endpoint="https://my-resource.openai.azure.com",
    api_key="my-key",
    api_version="2024-12-01-preview"
)

Actual (después):

from openai import OpenAI
from azure.identity import DefaultAzureCredential, get_bearer_token_provider

client = OpenAI(
    base_url="https://my-project.services.ai.azure.com/openai/v1",
    default_headers={"Authorization": f"Bearer {get_bearer_token_provider(DefaultAzureCredential(), 'https://cognitiveservices.azure.com/.default')()}"}
)

Comparación de características

En las tablas siguientes se compara la disponibilidad de las características entre las experiencias clásicas y del portal actual.

Disponible en ambos portales

Novedades en el portal actual

Estas características solo están disponibles en el portal de Foundry actual:

Versión clásica solamente (migración requerida)

Navegación por el portal

El portal clásico usa un único panel izquierdo personalizable para toda la navegación, con el Centro de administración en la parte inferior. El portal actual divide las características en cinco secciones de nivel superior, cada una con su propio panel izquierdo.

En la siguiente tabla se indican las ubicaciones clásicas del portal que se utilizan con mayor frecuencia y sus equivalentes actuales.

Cambio entre experiencias del portal

Puede cambiar entre las experiencias del portal clásica y actual en cualquier momento. El interruptor conserva tu contexto actual, como el proyecto en el que estás trabajando.

1. Busque el interruptor New Foundry en el banner superior.
2. Seleccione el botón de alternancia para cambiar entre las experiencias clásicas y actuales.
3. La página se vuelve a cargar con la interfaz del portal seleccionada.

Solución de problemas comunes de migración

Contenido relacionado

• ¿Qué es Microsoft Foundry?
• Comenzar con el servicio Foundry Agent
• Desarrollo con la API de respuestas
• Implementación de modelos desde el catálogo de modelos
• Utiliza un lector de pantalla con Microsoft Foundry