Nota
O acceso a esta páxina require autorización. Pode tentar iniciar sesión ou modificar os directorios.
O acceso a esta páxina require autorización. Pode tentar modificar os 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 es necesario instalar la CLI manualmente. La configuración guiada por IA comprueba la CLI, la instala o la actualiza automáticamente y ejecuta todos los comandos necesarios en su nombre. Esta página es una referencia para desarrolladores que necesitan instalar o usar directamente la CLI, por ejemplo, al compilar la automatización de CI/CD, solucionar problemas de un paso específico o trabajar sin un agente de codificación de IA.
Nota:
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.
Prerrequisitos
La CLI requiere .NET 8.0 o posterior. Para todos los demás requisitos previos: suscripción de Azure, roles necesarios de Entra y registro de aplicaciones cliente personalizadas, consulte configuración guiada por AI.
Instalar la CLI de Agent 365
Siga estos pasos para instalar la CLI de Agent 365 globalmente en el sistema operativo.
Prerrequisitos
Debe tener .NET instalado. (se recomienda .NET 8.0).
Usar 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.
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 del Agente 365, necesitas una conexión a internet para acceder al último paquete NuGet: Microsoft.Agents.A365.DevTools.Cli.
Desinstalar
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:
| SO | Ruta de acceso |
|---|---|
| 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.
Sugerencia
No es necesario ejecutar comandos de la CLI manualmente. La configuración guiada por IA automatiza el flujo de trabajo completo( instalación de la CLI, configuración, configuración del plano técnico, implementación y publicación) mediante un agente de codificación de 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.
Sugerencia
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 creados: El agente no aparece 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