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.
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 Azure Portal o las opciones de plantilla para cumplir los requisitos de Azure Policy de su organización.
Prerrequisitos
-
Una cuenta de Azure con una suscripción activa. Si no tiene una, cree una cuenta gratuita de Azure, que incluye una suscripción de evaluación gratuita.
-
Acceso a un rol que le permite crear un recurso Foundry, como Azure Account AI Owner o Azure AI Owner en la suscripción o el grupo de recursos. Para obtener más información sobre los permisos, consulte Control de acceso basado en rol para Microsoft Foundry.
Use las pestañas siguientes para seleccionar el método que desea usar para crear un proyecto Foundry:
Configuración del entorno de desarrollo
Ejecute az login o az login --use-device-code en el entorno antes de ejecutar código.
Validación rápida: antes de crear un proyecto, 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 notebook, use %pip install en su lugar.
Use 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 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 ID de arrendatario del ID de Microsoft Entra que desea usar en el lugar indicado por DefaultAzureCredential.
DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
Crea un proyecto de Foundry
Estos pasos proporcionan una manera de crear un nuevo recurso de Azure con la configuración básica, predeterminada.
Para crear un proyecto 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á trabajando aparece en la esquina superior izquierda.
Para crear un nuevo proyecto, seleccione el nombre del proyecto y, a continuación, seleccione Crear nuevo proyecto.
Asigne un nombre al proyecto y seleccione Crear proyecto. O consulte la sección siguiente para ver las opciones avanzadas.
Opciones avanzadas
Creas un proyecto Foundry en un 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.
Sugerencia
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 la predeterminada. La ubicación es la región donde se hospedan los recursos del proyecto.
Selecciona 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 siguiente código para crear un Proyecto Foundry utilizando las variables y la conexión especificadas en los client.
# 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 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
Creación del 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 restringidas de Azure 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 compartir 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 |
✅ |
✅ |
| Á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 predeterminado para cada recurso 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 portal foundry (nuevo).
Para agregar un nuevo proyecto 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.
Visualización de la configuración del proyecto
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 de API si usa la autenticación de Id. de Entra de Microsoft.
# 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 proyecto después de eliminarlo.
Contenido relacionado