Creación de un proyecto para Microsoft Foundry

Use este artículo para crear un proyecto foundry y confirmar que el entorno está listo antes de empezar a compilar agentes, evaluaciones y archivos.

En este artículo se describe cómo crear un proyecto foundry en Microsoft Foundry. Los proyectos le permiten organizar su trabajo, incluyendo agentes, evaluaciones y archivos, a medida que crea aplicaciones con memoria de estado y explora nuevas ideas.

Si su organización requiere configuraciones de Azure personalizadas, como nombres alternativos, controles de seguridad o etiquetas de costo, es posible que tenga que usar el portal Azure o template opciones para cumplir los requisitos de Azure Policy de la organización.

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 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 un rol que permite completar asignaciones de roles, como 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 IDs de grupo de seguridad de Microsoft Entra para los miembros del equipo que necesitan acceso.

Use las pestañas siguientes para seleccionar el método que desea usar para crear un project Foundry:

Portal de la Fundición

• No se necesitan otros requisitos previos al usar el portal.

Python

• Configure el entorno de desarrollo.

• Ejecute az login o az login --use-device-code en el entorno antes de ejecutar código.

• Instalar paquetes: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0. Si está en una celda del cuaderno, use %pip install en su lugar.

• Utilice pip show azure-mgmt-cognitiveservices para comprobar que su versión es 13.7 o posterior.

• Validación rápida: antes de crear un proyecto, compruebe el SDK y la autenticación mediante la prueba del cliente:

  from azure.identity import DefaultAzureCredential
  from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
  
  # Test authentication by instantiating the client
  credential = DefaultAzureCredential()
  subscription_id = "<your-subscription-id>"  # Replace with your subscription ID
  client = CognitiveServicesManagementClient(credential, subscription_id)
  print("✓ Authentication successful! Ready to create a project.")
  

• Inicie el script con el código siguiente para crear la conexión y las client variables que se usan en este artículo. En este ejemplo se crea el proyecto en el este de EE. UU.

  from azure.identity import DefaultAzureCredential
  from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
  
  subscription_id = 'your-subscription-id'
  resource_group_name = 'your-resource-group-name'
  foundry_resource_name = 'your-foundry-resource-name'
  foundry_project_name = 'your-foundry-project-name'
  location = 'eastus'
  
  client = CognitiveServicesManagementClient(
      credential=DefaultAzureCredential(), 
      subscription_id=subscription_id,
      api_version="2025-04-01-preview"
  )
  

• (Opcional) Si tiene varias cuentas, agregue el identificador de inquilino del Microsoft Entra ID que desea usar en DefaultAzureCredential:

  DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
  

CLI de Azure

• Instale el CLI de Azure.
• Establezca el valor predeterminado para subscription.

# Set your default subscription
az account set --subscription "{subscription-name}"

Crear un proyecto Foundry

Use uno de los métodos siguientes.

Portal de la Fundición

Estos pasos proporcionan una manera de crear un nuevo recurso Azure con la configuración predeterminada básica.

Para crear un project Foundry, siga estos pasos:

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

   

2. El proyecto en el que estás trabajando aparece en la esquina superior izquierda.

3. Para crear un nuevo project, seleccione el nombre del project y, a continuación, seleccione Crear nuevo project.

4. Asigne un nombre al project y seleccione Crear project. O consulte la sección siguiente para ver las opciones avanzadas.

Opciones avanzadas

1. Tú creas un proyecto Foundry en un recurso de Foundry. El portal crea automáticamente este recurso al crear el project. Seleccione un grupo de recursos existente que se va a usar o deje el valor predeterminado para crear un nuevo grupo de recursos.

   Sugerencia

   Para empezar, cree un nuevo grupo de recursos para su proyecto. El grupo de recursos simplifica la gestión del proyecto y de todos sus recursos.

2. Seleccione una ubicación o use la predeterminada. La ubicación es la región donde están alojados los recursos del proyecto.

3. Selecciona Crear. Verá el progreso de la creación de recursos. El proyecto se crea cuando el proceso se completa.

Python

Para crear un proyecto Foundry:

• Agregue el siguiente código para crear un proyecto de client mediante las variables y la conexión de la sección de requisitos previos.

  # Create resource
  resource = client.accounts.begin_create(
      resource_group_name=resource_group_name,
      account_name=foundry_resource_name,
      account={
          "location": location,
          "kind": "AIServices",
          "sku": {"name": "S0",},
          "identity": {"type": "SystemAssigned"},
          "properties": {
              "allowProjectManagement": True,
              "customSubDomainName": foundry_resource_name
          }
      }
  )
  
  # Wait for the resource creation to complete
  resource_result = resource.result()
  
  # Create default project
  project = client.projects.begin_create(
      resource_group_name=resource_group_name,
      account_name=foundry_resource_name,
      project_name=foundry_project_name,
      project={
          "location": location,
          "identity": {
              "type": "SystemAssigned"
          },
          "properties": {}
      }
  )
  

  Referencias: CognitiveServicesManagementClient.

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

Creación de varios proyectos en el mismo recurso

Cree varios proyectos de Foundry en un recurso de Foundry existente para habilitar la colaboración en equipo y el acceso a recursos compartidos, incluyendo la seguridad, implementaciones y herramientas conectadas. Esta configuración es ideal en suscripciones de Azure restringidas en las que los desarrolladores necesitan la capacidad de exploración de autoservicio dentro de la configuración de un entorno preconfigurado.

Los proyectos de Foundry como recursos secundarios de Azure pueden tener asignados sus propios controles de acceso, pero comparten configuraciones comunes, como la seguridad de red, las implementaciones y la integración de herramientas de Azure con su recurso primario.

Aunque aún no todas las funcionalidades de Foundry admiten la organización del trabajo en proyectos, el primer project "predeterminado" del recurso es más eficaz. Puede identificarlo mediante la etiqueta "default" en las experiencias de experiencia del usuario y la propiedad de recurso "is_default" al usar las opciones de código.

Característica	Projecto predeterminado	Otros proyectos
Inferencia de modelos	✅	✅
Áreas de juego	✅	✅
Agents	✅	✅
Evaluations	✅	✅
Seguimiento	✅	✅
Datasets	✅	✅
Indexes	✅	✅
SDK y API de Foundry	✅	✅
Comprensión del contenido	✅	✅
SDK y API de OpenAI	✅	Respuestas, archivos, conversaciones
OpenAI Batch, Ajuste fino, Finalizaciones almacenadas	✅	-
Ajuste de idioma	✅	✅
Ajuste de voz	✅	-
Conexiones	✅	✅

• Para agregar un proyecto a un recurso Foundry:

  Portal de la Fundición

  1. Seleccione Operar en el panel de navegación superior derecho.
  2. Seleccione Administrador en el panel izquierdo.
  3. Seleccione el recurso primario al que desea agregar un proyecto.
  4. Seleccione Agregar proyecto.

  Python

  Agregue este código al script para crear un nuevo proyecto en el recurso existente.

  # Create additional project
  new_project_name = 'your-new-project-name'
  
  project = client.projects.begin_create(
      resource_group_name=resource_group_name,
      account_name=foundry_resource_name,
      project_name=new_project_name,
      project={
          "location": location,
          "identity": {
              "type": "SystemAssigned"
          },
          "properties": {}
      }
  )
  

  CLI de Azure

  Para agregar un nuevo project a my-foundry-resource:

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

• Si elimina el proyecto predeterminado del recurso Foundry, el siguiente proyecto creado se convertirá en el proyecto predeterminado.

Ver la configuración del proyecto

Portal de la Fundición

En la página del proyecto Home, verá el punto de conexión del proyecto y la clave de API del proyecto. No necesita la clave API si usa la autenticación de Microsoft Entra ID.

Python

# Get project
project = client.projects.get(
    resource_group_name=resource_group_name,
    account_name=foundry_resource_name,
    project_name=foundry_project_name
)
print(project)

Referencias: CognitiveServicesManagementClient.

CLI de Azure

Para ver la configuración del proyecto, use el comando az cognitiveservices account project show. Por ejemplo:

az cognitiveservices account project show \
--name my-foundry-resource \
--resource-group my-foundry-rg \
--project-name my-foundry-project

Concesión de acceso a los miembros del equipo

Si creó el proyecto para un equipo, asigne el rol Azure ai User a los miembros del equipo para que puedan usar el proyecto y sus recursos. Este rol proporciona los permisos mínimos necesarios para compilar y probar aplicaciones de IA. Para otros roles que pueda necesitar asignar, consulte Control de acceso basado en roles para Microsoft Foundry.

Importante

Para completar las asignaciones de roles, necesita un rol como Propietario en el proyecto. Para obtener más información, consulte control de acceso basado en roles para Microsoft Foundry.

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

Python

Use el portal de CLI de Azure o Foundry para administrar las asignaciones de roles. El SDK de Python no admite operaciones de asignación de roles.

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 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.

Eliminar proyectos

Portal de la Fundición

1. Inicie sesión en Microsoft Foundry. Asegúrese de que el interruptor New Foundry está activado. Estos pasos hacen referencia a Foundry (nuevo).
2. En el panel de navegación superior derecho, seleccione Operar.
3. En el panel izquierdo, seleccione Administrador.
4. Seleccione su proyecto.
5. En la esquina superior derecha, seleccione el icono de papelera para eliminar el proyecto.

Python

Este código usa las variables y la conexión client de los requisitos previos. Para eliminar un único proyecto:

client.projects.begin_delete(
    resource_group_name, foundry_resource_name, foundry_project_name
)

Referencias: CognitiveServicesManagementClient.

Elimine un recurso Foundry y todos sus proyectos:

# Delete projects
projects = client.projects.list(resource_group_name, foundry_resource_name)

for project in projects: 
    print("Deleting project:", project.name)
    client.projects.begin_delete(resource_group_name, foundry_resource_name,
        project_name=project.name.split('/')[-1]
    ).wait()

# Delete resource
print("Deleting resource:", foundry_resource_name)
client.accounts.begin_delete(resource_group_name, foundry_resource_name).wait()

Referencias: CognitiveServicesManagementClient.

CLI de Azure

Ejecute el siguiente comando:

az cognitiveservices account project delete \
--name my-foundry-resource \
--resource-group my-foundry-rg \
--project-name my-foundry-project

Referencias: az cognitiveservices account project delete.

Importante

Úselo con precaución. No se puede recuperar un project después de eliminarlo.

Creación de la primera conexión

Contenido relacionado

• Inicio rápido de Microsoft Foundry
• ¿Qué es Foundry?
• Crear recursos mediante la plantilla Bicep