Creación de un proyecto para Microsoft Foundry

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

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

• Usa pip show azure-mgmt-cognitiveservices para comprobar que tu 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, el proyecto se crea en el este de Estados Unidos.

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

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

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

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

Para crear un proyecto 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 (new).

   

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

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

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

Opciones avanzadas

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

   Propina

   Especialmente para empezar, cree un nuevo grupo de recursos para el proyecto. El grupo de recursos facilita la administración del proyecto y de todos sus recursos.

2. Seleccione una ubicación o use el valor predeterminado. La ubicación es la región donde se hospedan los recursos del proyecto.

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

Para crear un proyecto Foundry:

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

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

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

En la página Proyecto principal, 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.

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

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

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

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.

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.

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

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 el proyecto.
5. En la esquina superior derecha, seleccione el icono de papelera para eliminar el proyecto.

Este código usa las variables y client la conexión 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.

Ejecute el siguiente comando:

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

Referencia: az cognitiveservices account project delete.