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.

Propina

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 Azure Propietario de IA de Cuenta o Azure Propietario de IA en la suscripción o grupo de recursos. Para obtener más información sobre los permisos, consulte Control de acceso basado en roles para Microsoft Foundry.
  • 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:

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

  • Inicie sesión en Azure:

    az login

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.

  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

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.

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

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.Captura de pantalla de la pantalla de bienvenida de Microsoft Foundry Models que muestra la dirección URL del punto de conexión y el botón copiar.
  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 va a administrar un equipo, asigne el rol usuario de IA Azure 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.

  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

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.

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

Paso siguiente

Inicio rápido de Microsoft Foundry

  • Last updated on