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:
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:
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.
Utilice pip show azure-mgmt-cognitiveservices para comprobar que su versión es 13.7 o posterior.
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 del arrendatario del Microsoft Entra ID que desea usar en el DefaultAzureCredential.
DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
Crear un proyecto Foundry
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:
-
Inicie sesión en Microsoft Foundry. Asegúrese de que el interruptor New Foundry está activado. Estos pasos hacen referencia a Foundry (nuevo).
El proyecto en el que estás trabajando aparece en la esquina superior izquierda.
Para crear un nuevo project, seleccione el nombre del project y, a continuación, seleccione Crear nuevo project.
Asigne un nombre al project y seleccione Crear project. O consulte la sección siguiente para ver las opciones avanzadas.
Opciones avanzadas
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.
Seleccione una ubicación o use la predeterminada. La ubicación es la región donde están alojados los recursos del proyecto.
Selecciona Crear. Verá el progreso de la creación de recursos. El proyecto se crea cuando el proceso se completa.
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.
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 marca --allow-project-management habilita la creación de proyectos dentro de este recurso.
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
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
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:
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).
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": {}
}
)
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
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.
# 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 comando az cognitiveservices account connection show. Por ejemplo:
az cognitiveservices account connection show \
--name my-foundry-project \
--resource-group my-foundry-rg
Eliminar proyectos
- Inicie sesión en Microsoft Foundry. Asegúrese de que el interruptor New Foundry está activado. Estos pasos hacen referencia a Foundry (nuevo).
- En el panel de navegación superior derecho, seleccione Operar.
- En el panel izquierdo, seleccione Administrador.
- Seleccione su proyecto.
- En la esquina superior derecha, seleccione el icono de papelera para eliminar el proyecto.
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.
Importante
Úselo con precaución. No se puede recuperar un project después de eliminarlo.
Contenido relacionado