Comparteix a través de

Referencia de comandos de la CLI deploy 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
-c, --config <config> Ruta de acceso al archivo de configuración (valor predeterminado: a365.config.json)
-v, --verbose 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)
-?, , -h, --help Mostrar información de ayuda y uso

Observaciones

La ejecución a365 deploy 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 toolingManifest.json y actualiza el plano técnico del agente con los permisos necesarios.

Ambas fases se ejecutan incluso con --dry-run. 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 Azure CLI deben ser válidas. Si no es así, la implementación se detiene con un error. Corrija con az login --tenant <TENANT_ID> y az account set --subscription <SUBSCRIPTION_ID>.
  • 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 a365 setupwebAppName y resourceGroup en a365.config.json.

Configuración

La CLI lee de dos archivos de configuración:

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

Los ámbitos de toolingManifest.json 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: ~/.config/a365

Comportamiento de marca

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

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

--dry-run: imprime todo lo que sucedería sin realizar ningún cambio. Cuando se ejecuta a365 deploy (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.

app opciones

Opción Description
-c, --config <config> Ruta de acceso al archivo de configuración (valor predeterminado: a365.config.json)
-v, --verbose 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)
-?, , -h, --help 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]

mcp opciones

Opción Description
-c, --config <config> Ruta de acceso del archivo de configuración (valor predeterminado: a365.config.json)
-v, --verbose Habilitación del registro detallado
--dry-run Mostrar lo que se haría sin ejecutar
-?, , -h, --help 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 deploy mcp:

  • 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 deploy mcp:

  • 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:

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

Solución de problemas

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

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

Ejecute az login --tenant <TENANT_ID> y az account set --subscription <SUBSCRIPTION_ID>.

No se encontró la aplicación web

Asegúrese a365 setup de que se ha ejecutado o compruebe que webAppName y resourceGroup son correctos en a365.config.json.

Se produce un error en la actualización de permisos

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

--restart falla

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

Registros

Los archivos de registro de la CLI se almacenan en:

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

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