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

En este inicio rápido, creará un proyecto Microsoft Foundry e implementará un modelo. Si está gestionando un equipo, también concede acceso a los miembros del equipo. Después de completar estos pasos, usted o el equipo pueden empezar a compilar aplicaciones de inteligencia artificial mediante el modelo implementado.

Sugerencia

En este inicio rápido se muestra cómo crear recursos para compilar un agente con una configuración básica. Para ver escenarios más avanzados que usan sus propios recursos, consulte Configuración del entorno para el desarrollo del agente.

Requisitos previos

• Una cuenta de Azure con una suscripción activa. Si no tiene una, cree una cuenta de free Azure, que incluye una suscripción de evaluación gratuita.
• Si va a crear el proyecto por sí mismo:
  • Acceso a un rol que le permite crear un recurso foundry, como el propietario de la cuenta de Foundry o el propietario de Foundry en la suscripción o el grupo de recursos. Para obtener más información sobre los permisos, consulte Control de acceso basado en roles para Microsoft Foundry.

    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.

• Si va a crear el proyecto para un equipo:
  • Acceso a una función que le permite completar las asignaciones de funciones, como por ejemplo Propietario. Para obtener más información sobre los permisos, consulte Control de acceso basado en roles para Microsoft Foundry.
  • Una lista de direcciones de correo electrónico de usuario, o identificadores de grupo de seguridad de Microsoft Entra, para los miembros del equipo que necesitan acceso.

Seleccione el método preferido mediante las siguientes pestañas:

CLI de Azure

• Instale el CLI de Azure versión 2.67.0 o posterior (compruebe con az version).

• Inicie sesión en Azure:

  az login
  

Portal de Foundry

• Acceso al portal Microsoft Foundry.

Creación de un proyecto

Cree un proyecto de Foundry para organizar el trabajo. El proyecto contiene modelos, agentes y otros recursos que usa el equipo.

CLI de Azure

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
   

2. Cree el recurso Foundry. 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 \
      --allow-project-management
   

   La --allow-project-management marca habilita la creación del proyecto dentro de este recurso.

3. Cree un subdominio personalizado para el recurso. El nombre de dominio personalizado debe ser único globalmente. Si my-foundry-resource está en uso, pruebe un nombre más distintivo.

   az cognitiveservices account update \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --custom-domain my-foundry-resource
   

4. Cree el 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
   

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
   

   La salida muestra las propiedades del proyecto, incluido su identificador de recurso.

Referencia: az cognitiveservices account

Portal de Foundry

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.

Implementación de un modelo

Implemente un modelo que pueda usar. En este ejemplo se usa gpt-4.1-mini, pero puede elegir cualquier modelo disponible.

CLI de Azure

az cognitiveservices account deployment create \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --deployment-name gpt-4.1-mini \
    --model-name gpt-4.1-mini \
    --model-version "2025-04-14" \
    --model-format OpenAI \
    --sku-capacity 10 \
    --sku-name Standard

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-4.1-mini

Cuando la implementación esté lista, la salida muestra "provisioningState": "Succeeded".

Referencia: az cognitiveservices account deployment

Portal de Foundry

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

Obtención de los detalles de conexión del proyecto

Para conectarte a través del código, necesitas el punto de conexión del proyecto. Si administra este proyecto para otros usuarios, envíeles este endpoint junto con el nombre de implementación.

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.

Para administradores: concesión de acceso

Si administra un equipo, asigne el rol Usuario de Foundry a los miembros del equipo para que puedan usar el proyecto y los modelos implementados. Este rol proporciona los permisos mínimos necesarios para compilar y probar aplicaciones de IA. Para ver otros roles que puede necesitar asignar, consulte el control de acceso basado en roles para Microsoft Foundry.

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.

CLI de Azure

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" \
       --scope $PROJECT_ID
   

Note

Dado que los roles de RBAC de Foundry se cambiaron recientemente de nombre, use el identificador de definición de rol (GUID) en lugar del nombre del rol en el código para evitar problemas durante la implementación del cambio de nombre:

• Usuario de Foundry: 53ca6127-db72-4b80-b1b0-d745d6d5456d
• Propietario de la fundición: c883944f-8b7b-4483-af10-35834be79c4a
• Propietario de la cuenta de Foundry: e47c6f54-e4a2-4754-9501-8e0985b135e1
• Foundry Project Manager: eadc314b-1a2d-4efa-be10-5d325db5065e

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

Portal de Foundry

1. En el portal de Foundry, seleccione Operar en la navegación superior derecha.
2. Seleccione Administrador en el panel izquierdo.
3. Seleccione el nombre del proyecto en la tabla.
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.

Sugerencia

Para agregar varios usuarios a la vez, use un grupo de seguridad Microsoft Entra en lugar de direcciones de correo electrónico individuales.

Comprobación del acceso de los miembros del equipo

Pida a un miembro del equipo que compruebe su acceso iniciando sesión en Microsoft Foundry y seleccionando el proyecto en la lista de proyectos.

Si el miembro del equipo no puede acceder al proyecto, compruebe que la asignación de roles se completó correctamente. Compruebe que ha usado la dirección de correo electrónico correcta o el identificador del grupo de seguridad. Asegúrese de que la cuenta de Azure del miembro del equipo esté en el mismo inquilino Microsoft Entra.

Para confirmar que el modelo implementado está disponible, pida al miembro del equipo que seleccione Compilar en el panel superior derecho y, a continuación, Modelos en el panel izquierdo.

Limpieza de recursos

Cuando ya no desee este proyecto, elimine el grupo de recursos para eliminar todos los recursos asociados a él.

CLI de Azure

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

Portal de Foundry

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.

Paso siguiente

Inicio rápido de Microsoft Foundry