Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Importante
Los elementos marcados (versión preliminar) de este artículo se encuentran actualmente en versión preliminar pública. Esta versión preliminar se ofrece sin acuerdo de nivel de servicio y no se recomienda para las cargas de trabajo de producción. Es posible que algunas características no se admitan o que tengan funcionalidades restringidas. Para más información, consulte Términos de uso complementarios para las versiones preliminares de Microsoft Azure.
Las extensiones Azure Developer CLI (azd) ai le permiten compilar, implementar, evaluar y operar agentes de IA en Microsoft Foundry desde el terminal. En este artículo, instalará las extensiones, comprobará la instalación y se autenticará en Azure.
Prerequisites
- Una suscripción a Azure. Crear uno gratis.
- CLI para desarrolladores de Azure (
azd) versión 1.25.2 o una versión posterior. Instale azd. - Python 3.10 o posterior, o .NET 8 o posterior, en función del marco de trabajo del agente que planee usar.
Permisos de Azure
Necesita los siguientes roles en la suscripción de Azure.
| Función | propósito |
|---|---|
| Colaborador | Aprovisionar y administrar recursos de Azure. |
| Propietario de Foundry | Solo es necesario si crea nuevos proyectos de Foundry. |
Importante
Recientemente se cambió el nombre de los roles RBAC de Foundry. Foundry User, Foundry Owner, Foundry Account Owner y Foundry Project Manager se llamaban anteriormente Usuario de Azure AI, Propietario de Azure AI, Propietario de la cuenta de Azure AI y Administrador de proyectos de Azure AI. Es posible que siga viendo los nombres anteriores en algunos lugares mientras se implementa el cambio de nombre. El cambio de nombre no modifica los identificadores de rol y los permisos principales.
Comprender cómo se empaquetan las extensiones
El azd ai espacio de nombres se compone de varias extensiones independientes azd . Cada uno de ellos aporta un grupo de comandos de nivel superior bajo azd ai.
| Id. de extensión | Grupo de comandos | Qué hace |
|---|---|---|
microsoft.foundry |
metapaquete | Agrupa todas las extensiones de Foundry en una única instalación. |
azure.ai.agents |
azd ai agent |
Distribuye agentes con Foundry desde tu terminal. |
azure.ai.connections |
azd ai connection |
Administre las conexiones del proyecto Foundry. |
azure.ai.inspector |
azd ai inspector |
Interfaz de usuario del inspector basada en explorador para agentes en ejecución local. |
azure.ai.projects |
azd ai project |
Administrar el contexto del proyecto Foundry (set, unset, show). |
azure.ai.routines |
azd ai routine |
Administrar rutinas de Foundry (temporizadores, programaciones, desencadenadores de eventos). |
azure.ai.skills |
azd ai skill |
Gestionar las habilidades de Foundry (directrices reutilizables sobre el comportamiento del agente). |
azure.ai.toolboxes |
azd ai toolbox |
Administrar cuadros de herramientas de Foundry (colecciones de herramientas con versiones). |
microsoft.foundry es un metapaquete ligero que no aporta comandos propios. Al instalarlo, se instalan todas las extensiones individuales, lo cual es el punto de partida recomendado. Instalar azure.ai.agents por sí solo también instala automáticamente azure.ai.inspector, porque la extensión del agente depende de él.
Instala el paquete completo
Instalar todas las extensiones de Foundry de una sola vez mediante el metapaquete:
azd ext install microsoft.foundry
Para actualizar más adelante:
azd ext upgrade microsoft.foundry
Instalación o actualización de una extensión individual
También puede administrar cada extensión por su cuenta:
# Just the agent surface
azd ext install azure.ai.agents
# Just the routine surface
azd ext install azure.ai.routines
# Upgrade one extension without touching the others
azd ext upgrade azure.ai.connections
Las extensiones individuales tienen versiones independientes, por lo que puede fijar o actualizar una por una.
Comprobación de la instalación
Lista de extensiones instaladas:
azd ext list
Debería ver microsoft.foundry más cada extensión individual. Cada extensión también expone un version subcomando:
azd ai agent version
azd ai connection version
azd ai inspector version
azd ai project version
azd ai routine version
azd ai skill version
azd ai toolbox version
Authenticate
Inicie sesión en Azure para que la CLI pueda aprovisionar y administrar recursos en su nombre:
azd auth login
Este comando abre una ventana del explorador para la autenticación interactiva. Después de iniciar sesión, la CLI almacena en caché las credenciales localmente para los comandos posteriores.