Creación de un project para Microsoft Foundry

En este artículo se describe cómo crear un project 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 las opciones de Azure portal o template 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.

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

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

  Portal de la Fundición

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

  SDK de Python

  • Configuración del entorno de desarrollo

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

  • Quick validation: antes de crear un project, compruebe que el SDK y la autenticación funcionan probando el 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.")
    

  • Complete estos pasos para iniciar el script de Python:

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

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

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

    4. (Opcional) Si tiene varias cuentas, agregue el identificador del arrendatario del Microsoft Entra ID que desea usar en el DefaultAzureCredential.

       DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
       

  Azure CLI

  • Instale el Azure CLI.

  • Establezca los valores predeterminados para subscription.

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

Crear un proyecto Foundry

Portal de la Fundición

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

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.

SDK de Python

Para crear un proyecto Foundry:

• Agregue el siguiente código para crear un proyecto Foundry mediante las variables y la conexión client desde 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.

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

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 del recurso principal.

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

  El portal "Foundry" (nuevo) muestra solo el proyecto default para cada recurso de Foundry. No puede crear varios proyectos ni ver ninguno de los proyectos no predeterminados en el portal foundry (nuevo).

  SDK de Python

  Aunque este código puede agregar proyectos adicionales a un recurso, no podrá verlos en el portal foundry (nuevo). Solo el proyecto predeterminado de un recurso está disponible en el portal Foundry (Nuevo).
  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": {}
      }
  )
  

  Azure CLI

  Aunque este código puede agregar proyectos adicionales a un recurso, no podrá verlos en el portal foundry (nuevo). Solo el proyecto predeterminado de un recurso está disponible en el nuevo portal Foundry. Para agregar un nuevo project a my-foundry-resource:

   az cognitiveservices account project create \
   --name my-foundry-resource \
   --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 autenticación de Microsoft Entra ID.

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

Azure CLI

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

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

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.

SDK de Python

Este código usa las variables y client connection de los requisitos previos. En primer lugar, cree la conexión de cliente:

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.

Azure CLI

Ejecute el siguiente comando:

az cognitiveservices account project delete \
--name 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.

Contenido relacionado

• Inicio rápido de Microsoft Foundry
• ¿Qué es Foundry?