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 del agente 365 es una herramienta de línea de comandos multiplataforma para implementar y administrar aplicaciones del Agente 365 en Azure.
No necesitas instalar la CLI manualmente.Agent 365 Skills comprueba la línea de crédito, instálala o actualízala automáticamente y ejecuta todos los comandos necesarios en tu nombre. Este artículo es una referencia para desarrolladores que necesitan instalar o usar la CLI directamente, por ejemplo, al construir automatización de CI/CD, solucionar un paso específico o trabajar sin un agente de codificación de IA.
Note
El flujo de trabajo completo para desarrolladores , incluida la configuración guiada por IA, la guía de roles y los pasos posteriores a la implementación, se encuentra en Introducción al desarrollo del agente 365. Esta página es la referencia de la CLI: instalación, actualización, desinstalación, comandos disponibles y solución de problemas.
Prerequisites
La CLI requiere .NET 8.0 o posterior. Para todos los demás requisitos previos - suscripción a Azure, roles obligatorios de Entra y registro personalizado de la app de cliente - consulta Inicio rápido: Conectar un agente existente al Agente 365.
Instalar la CLI de Agent 365
Siga estos pasos para instalar la CLI de Agent 365 globalmente en el sistema operativo.
Prerequisites
Debe tener .NET instalado. (se recomienda .NET 8.0).
Utiliza dotnet tool install
Instale la CLI del Agente 365 mediante el comando siguiente:
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
Comprobación de la instalación
Después de instalar la CLI de Agent 365, verifica que esté correctamente instalada ejecutando el --help comando:
a365 -h
Este comando muestra la información de ayuda y confirma que la CLI está lista para usarse.
Actualización
Actualice la CLI de Agent 365 mediante el comando dotnet tool update:
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli
Note
Para actualizar la CLI del Agente 365, necesitas una conexión a internet para acceder al último paquete NuGet: Microsoft.Agents.A365.DevTools.Cli.
Uninstall
Desinstale Agent 365 mediante el comando dotnet tool uninstall:
dotnet tool uninstall --global Microsoft.Agents.A365.DevTools.Cli
Ubicaciones de archivos
La ubicación predeterminada del archivo ejecutable de una herramienta depende del sistema operativo:
| Sistema operativo | Camino |
|---|---|
| Linux/macOS | $HOME/.dotnet/tools |
| Windows | %USERPROFILE%\.dotnet\tools |
El SDK añade esta ubicación a tu ruta cuando la ejecutas por primera vez. Así que puedes 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 la instala.
Comandos disponibles
Para la lista completa de comandos disponibles, utilice el --help comando o consulte la Referencia CLI del Agente 365.
Tip
No es necesario ejecutar comandos de la CLI manualmente. Agent 365 Skills automatiza todo el flujo de trabajo: instalación, configuración, configuración de blueprints, despliegue y publicación, utilizando un agente de codificación con IA. Consulte la referencia de la CLI si va a crear la automatización de CI/CD, resolver problemas de un paso específico o trabajar sin un agente de programación de IA.
Para obtener instrucciones completas sobre cómo configurar un agente de Agente 365 mediante la CLI, consulte Introducción al desarrollo del Agente 365.
Troubleshooting
Esta sección proporciona información sobre cómo solucionar errores con la CLI del Agente 365.
Tip
La Guía de Resolución de Problemas del Agente 365 contiene recomendaciones de alto nivel para la solución de problemas, mejores prácticas y enlaces a contenido de solución de problemas para cada parte del ciclo de vida del desarrollo del Agente 365.
Cuestiones específicas de la CLI tratadas en esta sección:
El agente no aparece en Teams
Resolución de problemas de instancias de agentes: Los agentes no aparecen en Teams
No puedo crear una instancia de agente en Teams
Resolución de problemas de instancias de agentes: No se puede crear instancia de agente en Teams