Creación de un proyecto para Microsoft Foundry (clásico)

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.

Visualización actual:Versión - Cambio a la versión del nuevo portal de Foundry

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

Un proyecto Foundry se administra en un recurso Microsoft Foundry. Es un contenedor para la administración de acceso, la carga y la integración de datos y la supervisión. Esto le permite mantener el trabajo separado entre casos de uso sin necesidad de crear recursos adicionales Azure.
Si necesita acceso a modelos de código abierto o PromptFlow, cree un tipo de proyecto de centro en su lugar.
Para obtener más información sobre los distintos tipos de proyecto, vea Tipos de proyectos.

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.

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.
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 carece de este rol, solicite al administrador de la suscripción que cree un recurso Foundry y, a continuación, vaya a Creación de varios proyectos en el mismo recurso.

Use las pestañas siguientes para seleccionar el método que desea usar para crear un proyecto 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>")
```

(Opcional) Si trabaja en el Azure Government - US o Azure operado por 21Vianet regiones, especifique la región a la que desea autenticarse. En este ejemplo se autentica en la región de Azure Government de Estados Unidos.
```
from azure.identity import AzureAuthorityHosts
DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)
```

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

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

Creación de un proyecto Foundry

Use uno de los métodos siguientes.

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:

Inicie sesión en Microsoft Foundry. Asegúrese de que el interruptor New Foundry está desactivado. Estos pasos hacen referencia a Foundry (clásico).
Lo que haces a continuación depende de dónde estés:
- Si no está en un proyecto o no tiene ningún proyecto: seleccione Crear nuevo en la esquina superior derecha para crear un nuevo proyecto Foundry.
- Si está en un proyecto: seleccione la ruta de navegación del proyecto y, a continuación, seleccione Crear nuevo recurso.
Seleccione Foundry resource (Recurso de foundry) y, a continuación, seleccione Next (Siguiente).
Proporcione un nombre para el proyecto y seleccione Crear. O consulte la sección siguiente para ver las opciones avanzadas.

Opciones avanzadas

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.
Seleccione una ubicación o use el valor predeterminado. La ubicación es la región donde se hospedan los recursos del proyecto.
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.

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

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.

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

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

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

Creación de varios proyectos en el mismo recurso

Cree varios proyectos de Foundry en un recurso existente Foundry para habilitar la colaboración en equipo y el acceso a recursos compartidos, como la seguridad, las implementaciones y las 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.

Diagrama que muestra cómo un equipo podría compartir el acceso a recursos con varios proyectos en un recurso Foundry.

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 desde su recurso primario.

Aunque aún no todas las funcionalidades de Foundry admiten la organización del trabajo en proyectos, el primer proyecto "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	Proyecto predeterminado	Otros proyectos
Inferencia de modelos	✅	✅
Juegos infantiles	✅	✅
Agentes	✅	✅
Evaluaciones	✅	✅
Seguimiento	✅	✅
Conjuntos de datos	✅	✅
Índices	✅	✅
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 foundry
- SDK de Python
- CLI de Azure
Propina

Dado que puede customizar el panel izquierdo en el portal de Microsoft Foundry, es posible que vea elementos diferentes de los que se muestran en estos pasos. Si no ve lo que busca, seleccione ... Más en la parte inferior del panel izquierdo.
1. Inicie sesión en Microsoft Foundry. Asegúrese de que el interruptor New Foundry está desactivado. Estos pasos hacen referencia a Foundry (clásico).
2. Seleccione el proyecto Foundry o su recurso asociado.
3. En el panel izquierdo, seleccione Centro de administración.
4. En la sección de recursos, seleccione Información general.
5. Seleccione Nuevo proyecto y proporcione un nombre.
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": {}
    }
)
```
Para agregar un nuevo proyecto 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.

Visualización de la configuración del proyecto

En la página Proyecto principal, encontrará información sobre el proyecto.

Nombre: el nombre del proyecto aparece en la esquina superior izquierda.
Suscripción: la suscripción que hospeda el recurso que hospeda el proyecto.
Grupo de recursos: el grupo de recursos que hospeda el recurso que hospeda el proyecto.

# 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

Eliminar proyectos

Inicie sesión en Microsoft Foundry. Asegúrese de que el interruptor New Foundry está desactivado. Estos pasos hacen referencia a Foundry (clásico).
Abra el proyecto.
Seleccione Centro de administración.
En Recurso, seleccione Información general.
Seleccione los proyectos que ya no quiera conservar.
Seleccione Eliminar proyecto.

Para eliminar el recurso Foundry y todos sus proyectos:

En el Centro de administración, seleccione el nombre del recurso en la sección Información general para ir al portal de Azure.
En el portal de Azure, seleccione Delete para eliminar el recurso y todos sus proyectos asociados.

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.

Importante

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

Creación de la primera conexión

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

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2026-05-01

Creación de un proyecto para Microsoft Foundry (clásico)

Requisitos previos

Creación de un proyecto Foundry

Opciones avanzadas

Creación de varios proyectos en el mismo recurso

Visualización de la configuración del proyecto

Eliminar proyectos

Contenido relacionado

Comentarios

Recursos adicionales