Compartir a través de

Referencia de comandos de la CLI del agente 365

Importante

Debe formar parte del programa de versión preliminar Frontier para obtener acceso anticipado a Microsoft Agent 365. Frontier te conecta directamente con las últimas innovaciones de IA de Microsoft. Las previsualizaciones de Frontier están sujetas a los términos de vista previa existentes en tus acuerdos con clientes. Como estas funciones aún están en desarrollo, su disponibilidad y capacidades pueden cambiar con el tiempo.

Implementación de archivos binarios de aplicación del Agente 365 en los permisos de herramientas del Agente 365 Azure App Service configurados y actualización: el comando deploy proporciona opciones para crear implementaciones del Agente 365. Use este comando para implementar archivos binarios de aplicación en la infraestructura de Azure y conceder permisos de las herramientas del Agente 365.

rol Minimum requerido: Azure Colaborador + Administrador global

Para obtener información sobre el uso de este comando, consulte Deploy agent to Azure.

Syntax

a365 deploy [command] [options]

Options

Opción Description
, Ruta de acceso al archivo de configuración (valor predeterminado: a365.config.json)
, Habilitación del registro detallado
--dry-run Mostrar lo que se haría sin ejecutar
--inspect Pausar antes de la implementación para inspeccionar el contenido de la carpeta de publicación y el archivo ZIP
--restart Omitir la compilación y empezar a comprimir la carpeta de publicación existente (para iteración rápida después de los cambios manuales)
, , , Mostrar información de ayuda y uso

Observaciones

La ejecución sin un subcomando ejecuta una implementación en dos fases:

  • Phase 1: archivos binarios de aplicación: compila e implementa la aplicación en Azure App Service.
  • Fase 2: permisos de MCP: lee los ámbitos necesarios de y actualiza el plano técnico del agente con los permisos necesarios.

Ambas fases se ejecutan incluso con . La salida de la ejecución seca se divide en dos secciones etiquetadas para que pueda revisar lo que haría cada fase.

Comprobaciones preparatorias

Antes de la implementación, la CLI valida:

  • Azure autenticación y suscripción: la sesión y la suscripción de CLI de Azure deben ser válidas. Si no es así, la implementación se detiene con un error. Corrija con y .
  • Azure App Service existencia: la aplicación web de destino debe existir antes de que continúe la implementación. Si no se encuentra la aplicación, ejecute o corrija y en .

Configuración

La CLI lee de dos archivos de configuración:

  • : la configuración del proyecto (mantenida por el usuario).
  • : estado dinámico generado por comandos de instalación.

Los ámbitos de la herramienta MCP se leen en el directorio del proyecto de implementación.

La CLI también almacena una copia global de la configuración y el estado en:

  • Windows: %LocalAppData%\Microsoft.Agents.A365.DevTools.Cli
  • Linux/macOS:

Comportamiento de marca

: omite el paso de compilación y comienza directamente desde la compresión de la carpeta existente . Si no existe, se produce un error en la implementación. Ejecute primero una implementación completa (sin ) para generar la carpeta.

: se detiene antes del paso de carga para poder inspeccionar la carpeta y el archivo ZIP generado. Disponible solo para la fase de la aplicación.

: imprime todo lo que sucedería sin realizar ningún cambio. Cuando se ejecuta (dos fases), la salida se divide en:

  • Parte 1: Implementación de archivos binarios de aplicación
  • Parte 2: Permisos de herramientas del Agente de implementación y actualización 365

deploy app

Implementa el código del agente en la Azure aplicación web creada durante la instalación.

a365 deploy app [options]

Implemente archivos binarios de aplicaciones de Microsoft Agent 365 en el Azure App Service configurado. Este comando implementa archivos binarios de aplicación en el servicio de aplicaciones Azure configurado en Azure.

opciones

Opción Description
, Ruta de acceso al archivo de configuración (valor predeterminado: a365.config.json)
, Habilitación del registro detallado
--dry-run Mostrar lo que se haría sin ejecutar
--inspect Pausar antes de la implementación para inspeccionar el contenido de la carpeta de publicación y el archivo ZIP
--restart Omitir la compilación y empezar a comprimir la carpeta de publicación existente (para iteración rápida después de los cambios manuales)
, , , Mostrar información de ayuda y uso

deploy mcp

Actualiza los permisos del servidor MCP en el plano técnico del agente.

a365 deploy mcp [options]

opciones

Opción Description
, Ruta de acceso del archivo de configuración (valor predeterminado: a365.config.json)
, Habilitación del registro detallado
--dry-run Mostrar lo que se haría sin ejecutar
, , , Mostrar información de ayuda y uso

Notas de uso

Actualice los ámbitos y permisos de los servidores MCP en el plano técnico del agente existente. Este comando agrega permisos para las herramientas del Agente 365 al plano técnico del agente.

Si agrega o modifica servidores MCP en el código del agente, use este comando para actualizar los permisos en el plano técnico del agente.

Este comando:

  • Lee la configuración del servidor MCP del código.
  • Actualiza el plano técnico del agente con los permisos necesarios.
  • Concede permisos de API necesarios para los servidores MCP.

La actualización de permisos se aplica en el orden siguiente:

  1. Concesión de permisos de OAuth2 (entidad de servicio de plano técnico → plataforma MCP)
  2. Permisos que se pueden heredar (recurso mcP del plano técnico del agente →)
  3. Consentimiento del administrador (identidad del agente → plataforma MCP)

Cuándo usar :

  • Después de agregar nuevos servidores MCP al agente.
  • Después de cambiar las configuraciones del servidor MCP.
  • Cuando las herramientas de MCP no son accesibles para el agente.

No es necesario ejecutar :

  • En la implementación inicial. Esto se controla automáticamente durante la instalación.
  • Cuando solo se cambia la lógica del agente sin cambios de MCP.
  • Después de las actualizaciones de código rutinarias que no afectan a las herramientas.

Nota:

solo actualiza los permisos: no implementa el código. Ejecute primero si tiene cambios de código.

Solución de problemas

Use las secciones siguientes para resolver posibles problemas con el comando .

No ha iniciado sesión en Azure o una suscripción incorrecta

Ejecute y .

No se encontró la aplicación web

Asegúrese de que se ha ejecutado o compruebe que y son correctos en .

Se produce un error en la actualización de permisos

  • Confirme que , y el entorno están establecidos en .
  • Asegúrese de que su cuenta tiene derechos para administrar entidades de servicio y concesiones.
  • Compruebe que existe en el directorio del proyecto de implementación y que contiene ámbitos válidos.

falla

Ejecute una implementación completa sin generar la carpeta y después use para iteraciones posteriores.

Registros

Los archivos de registro de la CLI se almacenan en:

  • Windows: %LocalAppData%\Microsoft.Agents.A365.DevTools.Cli\logs\
  • Linux/macOS:

Para ver las últimas 80 líneas del archivo de registro de implementación más reciente, use Get-Content en Windows o tail en Linux/macOS:

# Windows
Get-Content $env:LOCALAPPDATA\Microsoft.Agents.A365.DevTools.Cli\logs\a365.deploy.log -Tail 80

# Linux/macOS
tail -80 ~/.config/a365/logs/a365.deploy.log

En el caso de los registros de aplicaciones en tiempo de ejecución, use Log Stream en el portal de Azure para stdout/stderr desde App Service.

  • Last updated on