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.
La CLI de Agent 365 es una herramienta de línea de comandos multiplataforma para implementar y administrar aplicaciones de Agent 365 en Azure.
No tiene que instalar la CLI manualmente. La configuración guiada por IA comprueba la CLI, la instala o actualiza automáticamente y ejecuta todos los comandos requeridos en su nombre. Esta página es una referencia para desarrolladores que necesitan instalar o usar la CLI directamente; por ejemplo, al crear automatización de CI/CD, solucionar problemas en un paso específico o trabajar sin un agente de codificación de IA.
Nota
El flujo de trabajo completo del desarrollador —incluyendo la configuración guiada por IA, la orientación de roles y los pasos posteriores a la implementación— se encuentra en Comenzar con el desarrollo de Agent 365. Esta página es la referencia de la CLI: instalación, actualización, desinstalación, comandos disponibles y solución de problemas.
Requisitos previos
La CLI requiere .NET 8.0 o posterior. Para todos los demás requisitos previos — suscripción a Azure, roles requeridos en Entra y registro personalizado de la aplicación cliente — consulte Configuración guiada por IA.
Instalar la CLI de Agent 365
Siga estos pasos para instalar la CLI de Agent 365 globalmente en el sistema operativo.
Requisitos previos
Debe haber instalado .NET. (Se recomienda .NET 8.0)
Usar dotnet tool install
Instale la CLI de Agent 365 con el siguiente comando:
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli
Para obtener las instrucciones más recientes y las versiones disponibles, visite la página oficial de NuGet: Microsoft.Agents.A365.DevTools.Cli en NuGet.org
Verificar instalación
Después de instalar la CLI de Agent 365, compruebe que está correctamente instalada ejecutando el comando --help:
a365 -h
Este comando muestra la información de ayuda y confirma que la CLI está lista para usarse.
Update
Actualice la CLI de Agent 365 mediante el comando dotnet tool update:
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli
Nota
Para actualizar la CLI de Agent 365, necesita una conexión a Internet para acceder al paquete NuGet más reciente: Microsoft.Agents.A365.DevTools.Cli.
Desinstalar
Desinstale Agent 365 mediante el comando dotnet tool update:
dotnet tool uninstall --global Microsoft.Agents.A365.DevTools.Cli
Ubicaciones de archivo
La ubicación predeterminada del archivo ejecutable de una herramienta depende del sistema operativo:
| SO | Path |
|---|---|
| Linux/macOS | $HOME/.dotnet/tools |
| Windows | %USERPROFILE%\.dotnet\tools |
El SDK agrega esta ubicación a su ruta cuando lo ejecutas por primera vez. Por lo tanto, puede invocar herramientas globales desde cualquier directorio sin especificar la ubicación de la herramienta.
El acceso a la herramienta es específico del usuario, no global de la máquina. Una herramienta global solo está disponible para el usuario que instala la herramienta.
Comandos disponibles
Para obtener la lista completa de comandos disponibles, use el comando --help o consulte Referencia de la CLI de Agent 365.
Sugerencia
No necesita ejecutar comandos de CLI manualmente. La configuración guiada por IA automatiza todo el flujo de trabajo: instalación de la CLI, configuración, configuración de plano técnico, implementación y publicación, mediante un agente de codificación IA. Utilice la referencia de CLI aquí solo si se está creando la automatización de CI/CD, solucionando los problemas de un paso específico o trabajando sin un agente con codificación de IA.
Para instrucciones completas sobre cómo configurar un agente de Agent 365 usando la CLI, consulte Empezar con el desarrollo de Agent 365.
Solución de problemas
Esta sección proporciona información sobre cómo solucionar errores con la CLI de Agent 365.
Sugerencia
La Guía de solución de problemas de Agent 365 contiene recomendaciones generales, procedimientos recomendados y vínculos a recursos de solución de problemas para cada parte del ciclo de vida del desarrollo de Agent 365.
Problemas específicos de la CLI cubiertos en esta sección:
El agente no aparece en Teams
Resolución de problemas de instancias de agentes creados: El agente no aparece en Teams
No se puede crear una instancia de agente en Teams
Solución de problemas de instancias de agentes: No se puede crear instancia de agente en Teams