Referencia de comandos de la CLI develop 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.

Administrar servidores de herramientas MCP para el desarrollo de agentes. El develop comando proporciona opciones para administrar servidores de herramientas MCP (Protocolo de contexto de modelo) para el desarrollo del agente. Puede enumerar los servidores disponibles, ver los servidores configurados y agregar o quitar servidores MCP de la configuración del agente.

Rol mínimo necesario: Ninguno (administración de manifiestos local)

Syntax

a365 develop [command] [options]

Options

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
-?, , -h, --help	Mostrar información de ayuda y uso.

develop list-available

Enumere todos los servidores MCP disponibles en el catálogo (lo que puede instalar).

a365 develop list-available [options]

Este comando muestra todos los servidores MCP que están disponibles en el catálogo y puede instalarlos para usarlos con el desarrollo del agente.

list-available opciones

Opción	Description
-c, --config <config>	Ruta de acceso del archivo de configuración. Valor predeterminado: a365.config.json
--dry-run	Mostrar lo que haría el comando sin ejecutarlo.
--skip-auth	Omitir la autenticación. Solo para pruebas. Es probable que se produzca un error en el comando sin autenticación válida.
-?, , -h, --help	Mostrar información de ayuda y uso.

develop list-configured

Enumere los servidores MCP configurados actualmente desde el local ToolingManifest.json.

a365 develop list-configured [options]

Este comando muestra todos los servidores MCP que configuró actualmente en el archivo ToolingManifest.json local.

list-configured opciones

Opción	Description
-c, --config <config>	Ruta de acceso del archivo de configuración. Valor predeterminado: a365.config.json
--dry-run	Mostrar lo que haría el comando sin ejecutarlo.
-?, , -h, --help	Mostrar información de ayuda y uso.

develop add-mcp-servers

Agregue servidores MCP a la configuración del agente actual.

a365 develop add-mcp-servers [<servers>...] [options]

Este comando agrega los servidores MCP especificados a ToolingManifest.json en la carpeta del proyecto. No concede permisos al plano técnico del agente.

Importante

Este comando solo actualiza ToolingManifest.json : no concede permisos al plano técnico del agente. La forma en que se aplican los permisos depende de dónde se encuentra en el proceso de configuración:

• Antes de la instalación inicial: continúe con a365 setup all. Los permisos de MCP se aplican como parte de la creación inicial del plano técnico.
• Después de que el plano técnico ya exista: un administrador global debe ejecutarse a365 setup permissions mcp por separado. El administrador debe ejecutarse a365 config display primero para comprobar que deploymentProjectPath en sus a365.config.json puntos a la carpeta del proyecto que contiene el actualizado ToolingManifest.json.

Argumentos de add-mcp-servers

Especifique uno o varios nombres de servidor MCP para agregar a la configuración del agente. Puede proporcionar varios nombres de servidor separados por espacios.

Argument	Description
<servers>	Nombres de los servidores MCP que se van a agregar

add-mcp-servers opciones

Use estas opciones para personalizar el comportamiento del add-mcp-servers comando, incluida la selección de archivos de configuración y las pruebas de ejecución seca.

Opción	Description
-c, --config <config>	Ruta de acceso del archivo de configuración. Valor predeterminado: a365.config.json
--dry-run	Mostrar lo que haría el comando sin ejecutarlo.
-?, , -h, --help	Mostrar información de ayuda y uso.

develop remove-mcp-servers

Quite los servidores MCP de la configuración del agente actual.

a365 develop remove-mcp-servers [<servers>...] [options]

Este comando quita los servidores MCP especificados de la configuración del agente actual.

Argumentos de remove-mcp-servers

Argument	Description
<servers>	Nombres de los servidores MCP que se van a quitar

remove-mcp-servers opciones

Opción	Description
-c, --config <config>	Ruta de acceso del archivo de configuración. Valor predeterminado: a365.config.json
--dry-run	Mostrar lo que haría el comando sin ejecutarlo.
-?, , -h, --help	Mostrar información de ayuda y uso.

develop add-permissions

Agregue permisos de API de servidor MCP para Microsoft Entra aplicaciones para escenarios de desarrollo en los que necesite configurar aplicaciones personalizadas para acceder a los servidores MCP.

a365 develop add-permissions [options]

add-permissions opciones

Use estas opciones para agregar los ámbitos y permisos de API necesarios al registro de la aplicación, aprovechando los valores del manifiesto de herramientas.

Opción	Description
-c, --config <config>	Ruta de acceso del archivo de configuración (valor predeterminado: a365.config.json)
-m, --manifest <manifest>	Ruta de acceso a ToolingManifest.json (valor predeterminado: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id>	Id. de aplicación (cliente) para agregar permisos a (valor predeterminado: clientAppId desde la configuración)
--scopes <scopes>	Ámbitos específicos que se van a agregar (separados por espacios) (valor predeterminado: Todos los ámbitos de ToolingManifest.json)
--dry-run	Mostrar lo que haría el comando sin realizar cambios
-v, --verbose	Mostrar salida detallada
-?, , -h, --help	Mostrar información de ayuda y uso.

Importante

La aplicación especificada por --app-id o clientAppId debe tener el permiso Application.ReadWrite.All en Microsoft Entra. Este comando es para aplicaciones cliente personalizadas. Para configurar los permisos para los planos técnicos del agente, use a365 setup permissions mcp en su lugar.

develop get-token

Recupere tokens de portador para probar servidores MCP durante el desarrollo mediante la autenticación interactiva del explorador.

a365 develop get-token [options]

get-token opciones

Use estas opciones para solicitar un token de acceso, controlar ámbitos, comportamiento de actualización y elegir el formato de salida.

Opción	Description
-c, --config <config>	Ruta de acceso del archivo de configuración (valor predeterminado: a365.config.json)
--app-id <app-id>	Id. de aplicación (cliente) para la autenticación (valor predeterminado: clientAppId desde la configuración)
-m, --manifest <manifest>	Ruta de acceso a ToolingManifest.json (valor predeterminado: <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes>	Ámbitos específicos para solicitar (separados por espacios) (valor predeterminado: Leer de ToolingManifest.json)
-o, --output <output>	Formato de salida: table, jsono raw (valor predeterminado: table)
--force-refresh	Forzar la actualización del token pasando la memoria caché
--resource <resource>	Palabra clave resource para la que se va a obtener el token: mcp (valor predeterminado) o powerplatform
--resource-id <resource-id>	Identificador de aplicación de recursos personalizados (GUID) para recursos no cubiertos por --resource palabras clave
-v, --verbose	Mostrar una salida detallada, incluido el token completo
-?, , -h, --help	Mostrar información de ayuda y uso.

get-token opciones de recursos

Use las opciones --resource y --resource-id para obtener tokens para distintos recursos de Azure:

• --resource: use una palabra clave para seleccionar un recurso predefinido:
  • mcp (valor predeterminado): Herramientas del agente 365 para servidores MCP
  • powerplatform: Power Platform API
• --resource-id: escriba un identificador de aplicación de recurso personalizado (GUID) para los recursos no cubiertos por palabras clave.

Importante

--resource y --resource-id no se pueden usar juntos. Cuando use cualquiera de las opciones, incluya --scopes. Solo el flujo de MCP predeterminado admite la resolución de ámbito basada en manifiestos.

develop start-mock-tooling-server

Inicie un servidor de herramientas ficticio con fines de prueba y desarrollo.

a365 develop start-mock-tooling-server [options]

Este comando inicia un servidor de herramientas ficticio con fines de prueba y desarrollo. Con este servidor, puede simular interacciones de servidor MCP sin necesidad de implementaciones reales del servidor.

start-mock-tooling-server opciones

Use estas opciones para personalizar el comportamiento del start-mock-tooling-server comando.

Opción	Description	Predeterminado
-p, --port <port>	Número de puerto del servidor ficticio	5309
-v, --verbose	Habilitación del registro detallado	false
-?, -h, --help	Mostrar información de ayuda y uso	-
-bg	Ejecución del servidor en un nuevo terminal	-