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

En este inicio rápido, creará un Microsoft Foundry project e implementará un modelo. Si estás administrando un equipo, tú también puedes conceder 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.

Prerrequisitos

• 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 vas a crear el proyecto para ti mismo:
  • Acceso a un rol que le permite crear un recurso Foundry, como Propietario de IA de Cuenta de Azure o Propietario de IA de Azure en la suscripción o el grupo de recursos. Para obtener más información sobre los permisos, consulte Role-based access control for Microsoft Foundry.
• Si estás creando el proyecto para un equipo:
  • Acceso a un rol que permite completar asignaciones de roles, como Propietario. Para obtener más información sobre los permisos, consulte Role-based access control for Microsoft Foundry.
  • Lista de direcciones de correo electrónico de usuarios o identificadores de grupos de seguridad de Microsoft Entra para los miembros del equipo que necesitan acceso.

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

Azure CLI

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

• Inicie sesión en Azure:

  az login
  

Portal de la Fundición

• Access al portal Microsoft Foundry.

Creación de un project

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

Azure CLI

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 marca --allow-project-management habilita la creación de proyectos dentro de este recurso.

3. Cree un subdominio personalizado para el recurso. El nombre custom domain debe ser único globalmente. Si my-foundry-resource ya está tomado, pruebe un nombre distinto.

   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 el 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 el proyecto haya sido creado.

   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, incluyendo su ID de recurso.

Referencia: az cognitiveservices account

Portal de la Fundición

1. Vaya a Microsoft Foundry.

2. Inicie sesión con su cuenta de Azure.

3. Seleccione el nombre del proyecto en la esquina superior izquierda y, a continuación, seleccione Crear nuevo proyecto.

4. Escriba un nombre de project, como my-foundry-project.

5. 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 project y todos sus recursos juntos.
   • Ubicación: seleccione la región más cercana al equipo.

6. Seleccione Crear project.

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

Implementar un modelo

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

Azure CLI

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: despliegue de cuenta de az cognitiveservices

Portal de la Fundición

1. En tu proyecto, selecciona Discover en la parte superior derecha de la navegación.
2. Seleccione Modelos.
3. Busque gpt-4.1-mini.
4. Seleccione Deploy>Configuración predeterminada para agregarla al project.
5. Anote el nombre de implementación (por ejemplo, gpt-4.1-mini). El equipo necesita este nombre para usar el modelo.

Obtén los detalles de conexión de tu proyecto

Necesita el punto de conexión del proyecto para conectarse desde el código. Si estás administrando este proyecto para otros, envíales esta dirección de extremo junto con el nombre de implementación.

1. Inicie sesión en Microsoft Foundry con su cuenta de Azure.
2. Seleccione su proyecto.
3. Busque el punto de conexión de su 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: concedan acceso

Si administra un equipo, asigne el rol de Azure de usuario de IA 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 es posible que tenga que asignar, consulte Control de acceso basado en roles para Microsoft Foundry

Azure CLI

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 Azure AI User a un miembro del equipo:

   az role assignment create \
       --role "Azure AI User" \
       --assignee "user@contoso.com" \
       --scope $PROJECT_ID
   

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

   az role assignment create \
       --role "Azure AI User" \
       --assignee-object-id "<security-group-object-id>" \
       --assignee-principal-type Group \
       --scope $PROJECT_ID
   

3. Compruebe la asignación de roles:

   az role assignment list \
       --scope $PROJECT_ID \
       --role "Azure AI User" \
       --output table
   

Referencia: az role assignment

Portal de la Fundición

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. Selecciona 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 de Microsoft Entra en lugar de direcciones de correo electrónico individuales.

Verificar acceso de miembro del equipo

Pida a un miembro del equipo que compruebe su acceso iniciando sesión en Microsoft Foundry, al seleccionar el proyecto en la lista de proyectos y confirmar que el modelo implementado aparece en Build>Models.

Si el miembro del equipo no puede acceder al proyecto, verifique que la asignación de rol 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 de Microsoft Entra.

Limpieza de recursos

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

Azure CLI

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

Portal de la Fundición

En el Azure portal, 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