Inicio rápido: Configuración de recursos de Microsoft Foundry

• Instale el CLI de Azure versión 2.80.0 o posterior. Compruebe la versión con az versiony ejecute az upgrade si necesita una más reciente.

  La versión 2.80.0 agregó los az cognitiveservices account project comandos que usan estos pasos. En una versión anterior, los comandos producen un error con unrecognized arguments o 'project' is misspelled or not recognized by the system.

• Inicie sesión en Azure:

  az login
  

• Acceso al portal Microsoft Foundry.

1. Cree un grupo de recursos o use uno existente. Por ejemplo, cree my-foundry-rg en eastus:

   az group create --name my-foundry-rg --location eastus
   

   Compruebe que el grupo de recursos existe:

   az group show --name my-foundry-rg --query properties.provisioningState --output tsv
   

   La salida muestra Succeeded.

2. Cree el recurso Foundry con la administración de proyectos habilitada. Por ejemplo, cree my-foundry-resource en el my-foundry-rg grupo de recursos:

   az cognitiveservices account create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --kind AIServices \
       --sku S0 \
       --location eastus \
       --custom-domain my-foundry-resource \
       --assign-identity \
       --allow-project-management true
   

   Use estos valores:

   Parameter	propósito
   --assign-identity	Crea la identidad administrada que requiere la administración del proyecto. Sin ella, la creación del proyecto falla con un error que indica que debe habilitarse una identidad administrada en el recurso.
   --allow-project-management	Habilita la administración de proyectos. No puede cambiar esta configuración después de crear el recurso.
   --custom-domain	Debe ser único globalmente. Si my-foundry-resource se toma , se produce un error en el comando con CustomDomainInUse. Elija otro nombre y vuelva a ejecutar el comando.

3. Cree un proyecto. Por ejemplo, cree my-foundry-project en :my-foundry-resource

   az cognitiveservices account project create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --project-name my-foundry-project \
       --location eastus
   

4. Compruebe que el recurso está aprovisionado:

   az cognitiveservices account show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --query properties.provisioningState --output tsv
   

   La salida debe mostrar Succeeded. Si la salida muestra un estado diferente, compruebe los permisos, la disponibilidad de regiones y las cuotas de recursos. Para obtener más ayuda, consulte Creación de un recurso de varios servicios.

5. Compruebe que se creó el proyecto:

   az cognitiveservices account project show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --project-name my-foundry-project \
       --query properties.provisioningState --output tsv
   

   La salida debe mostrar Succeeded. Si se produce un error en el comando con un mensaje que indica que se debe habilitar una identidad administrada, confirme que creó el recurso con --assign-identity.

Referencia: az cognitiveservices account project

1. Inicie sesión en Microsoft Foundry. Asegúrese de que el interruptor New Foundry esté activado. Estos pasos hacen referencia a Foundry (new).

   

2. Cree un proyecto.

   • Si este es el primer uso de Foundry, se le pedirá que cree o busque un proyecto para continuar. Seleccione Crear un nuevo proyecto en la lista desplegable.
   • Si ya tiene un proyecto cargado, seleccione su nombre en la esquina superior izquierda y, a continuación, seleccione Crear nuevo proyecto.

3. Escriba un nombre de proyecto, como my-foundry-project.

4. Seleccione Opciones avanzadas para configurar el grupo de recursos y la ubicación:

   • Grupo de recursos: cree un nuevo grupo de recursos o seleccione uno existente. Si crea un nuevo grupo de recursos, puede administrar más fácilmente el proyecto y todos sus recursos juntos.
   • Ubicación: seleccione la región más cercana al equipo.

5. Seleccione Crear proyecto.

   Espere a que se cree el proyecto. Cuando aparezca la página de información general del proyecto, el proyecto estará listo.

1. Enumere los modelos disponibles en su región para que pueda confirmar el nombre y la versión del modelo:

   az cognitiveservices model list \
       --location eastus \
       --query "[?model.name=='gpt-5-mini'].{version:model.version,skus:join(',',model.skus[].name)}" \
       --output table
   

2. Implemente el modelo:

   az cognitiveservices account deployment create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --deployment-name gpt-5-mini \
       --model-name gpt-5-mini \
       --model-version "2025-08-07" \
       --model-format OpenAI \
       --sku-capacity 10 \
       --sku-name GlobalStandard
   

   Si se produce un error en el comando con DeploymentModelNotSupported, el modelo, la versión o la SKU no están disponibles en la región. Use la salida del paso anterior para elegir una combinación admitida.

3. Compruebe que la implementación se ha realizado correctamente:

   az cognitiveservices account deployment show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --deployment-name gpt-5-mini \
       --query properties.provisioningState --output tsv
   

   La salida muestra Succeeded cuándo está lista la implementación.

Referencia: az cognitiveservices account deployment

1. Seleccione Detectar en el panel de navegación superior derecho y, a continuación, Modelos en el panel izquierdo.
2. Busque por gpt-5-mini.
3. Seleccione Implementar>configuración predeterminada para agregarla al proyecto.
4. Anote el nombre de implementación (por ejemplo, gpt-5-mini). Su equipo necesita este nombre para usar el modelo.

Obtenga el endpoint del proyecto:

az cognitiveservices account project show \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --project-name my-foundry-project \
    --query 'properties.endpoints."AI Foundry API"' --output tsv

El resultado es el punto de conexión del proyecto, con la forma https://my-foundry-resource.services.ai.azure.com/api/projects/my-foundry-project. Use este valor en otros inicios rápidos y tutoriales.

1. Inicie sesión en Microsoft Foundry con su cuenta de Azure.
2. Seleccione el proyecto.
3. Busque el punto de conexión del proyecto en la pantalla de bienvenida del proyecto.
4. Copie el valor del punto de conexión. Este valor se usa en otros inicios rápidos y tutoriales.

1. Obtenga el identificador de recurso del proyecto:

   PROJECT_ID=$(az cognitiveservices account project show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --project-name my-foundry-project \
       --query id -o tsv)
   

2. Asigne el rol Usuario de Foundry a un miembro del equipo:

   Importante

   Recientemente se cambió el nombre de los roles RBAC de Foundry. Foundry User, Foundry Owner, Foundry Account Owner y Foundry Project Manager se llamaban anteriormente Usuario de Azure AI, Propietario de Azure AI, Propietario de la cuenta de Azure AI y Administrador de proyectos de Azure AI. Es posible que siga viendo los nombres anteriores en algunos lugares mientras se implementa el cambio de nombre. El cambio de nombre no modifica los identificadores de rol y los permisos principales.

   az role assignment create \
       --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
       --assignee "user@contoso.com" \
       --assignee-principal-type User \
       --scope $PROJECT_ID
   

Para agregar un grupo de seguridad en lugar de un usuario individual:

az role assignment create \
    --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
    --assignee-object-id "<security-group-object-id>" \
    --assignee-principal-type Group \
    --scope $PROJECT_ID

1. Compruebe la asignación de roles:

   az role assignment list \
       --scope $PROJECT_ID \
       --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
       --output table
   

Referencia: az role assignment

1. En el portal de Foundry, seleccione Administrar en el panel de navegación superior derecho.
2. Seleccione Detalles del proyecto en el panel izquierdo.
3. Seleccione la pestaña Usuarios.
4. Seleccione Agregar usuario en la esquina superior derecha.
5. Escriba la dirección de correo electrónico del miembro del equipo.
6. Seleccione Agregar.

Repita estos pasos para cada miembro del equipo o grupo de seguridad.

az group delete --name my-foundry-rg --yes --no-wait

La eliminación se ejecuta en segundo plano. Para confirmar que el grupo de recursos ha desaparecido, ejecute:

az group exists --name my-foundry-rg

La salida muestra false cuándo finaliza la eliminación.

En el portal Azure, busque y seleccione el grupo de recursos. Seleccione Eliminar y confirme para eliminar el grupo de recursos y todos sus recursos asociados.