Referencia de comandos de la CLI `setup` del agente 365

Importante

Debe formar parte del programa de versión preliminar Frontier para obtener acceso early a Microsoft Agent 365. Frontier le conecta directamente con las últimas innovaciones de inteligencia artificial 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.

Configure el entorno del Agente 365 con control pormenorizado sobre cada paso. Este comando administra el flujo de trabajo de instalación inicial para los planos técnicos del Agente 365.

rol Minimum requerido: Azure Colaborador + Agent ID Developer

Nota:

El rol que contiene determina la cantidad de la configuración que se completa en una sola ejecución. El administrador global puede completar todos los pasos a la vez. El administrador de id . de agente y el desarrollador del id. de agente pueden completar todos los pasos, excepto las concesiones de permisos de OAuth2 (consentimiento del administrador), que requieren un paso independiente por parte de un administrador global. Para más información sobre el flujo de trabajo de entrega, consulte setup admin.

Syntax

a365 setup [command] [options]

Options

Opción	Description
`-?`, , `-h`, `--help`	Mostrar información de ayuda y uso.

Orden de ejecución recomendado

# 0. Check prerequisites (optional)
a365 setup requirements

# 1. Create blueprint
a365 setup blueprint

# 2. Configure MCP permissions
a365 setup permissions mcp

# 3. Configure bot permissions
a365 setup permissions bot

# 4. Configure CopilotStudio permissions (if needed)
a365 setup permissions copilotstudio

# 5. Configure custom permissions (if needed)
a365 setup permissions custom

O bien, ejecute todos los pasos a la vez:

# Full setup using config file (a365.config.json)
a365 setup all

# Config-free: no a365.config.json needed
a365 setup all --agent-name "MyAgent"

Si se ejecuta como administrador de id. de agente o desarrollador de id. de agente (no administrador global), a365 setup all completa todos los pasos excepto las concesiones de permisos de OAuth2. Una vez finalizado, un administrador global debe completar las concesiones:

# Non-admin path: run setup, then hand off to Global Administrator
a365 setup all

# Global Administrator completes OAuth2 grants
a365 setup admin --config-dir "<path-to-config-folder>"

`setup requirements`

Valide los requisitos previos para la configuración del Agente 365. Ejecuta comprobaciones de requisitos modulares y proporciona instrucciones para cualquier problema que encuentre.

a365 setup requirements [options]

Este comando ejecuta los pasos siguientes:

Comprueba todos los requisitos previos necesarios para la configuración del Agente 365.
Informa de cualquier problema con instrucciones de resolución detalladas.
Continúa comprobando todos los requisitos incluso si se produce un error en algunas comprobaciones.
Proporciona un resumen de todas las comprobaciones al final.

`requirements` opciones

Opción	Description
`-c`, `--config <config>`	Ruta de acceso del archivo de configuración. El valor predeterminado es `a365.config.json`.
`-v`, `--verbose`	Muestra la salida detallada de todas las comprobaciones.
`--category <category>`	Ejecuta comprobaciones solo de una categoría específica, como `Azure`, `Authentication` o `Configuration`.
`-?`, , `-h`, `--help`	Mostrar información de ayuda y uso.

`setup blueprint`

Cree un plano técnico del agente (Entra ID registro de aplicaciones).

Permisos mínimos necesarios: rol de desarrollador de id. de agente

a365 setup blueprint [options]

`blueprint` opciones

Opción	Description
`-c`, `--config <config>`	Ruta de acceso del archivo de configuración. El valor predeterminado es `a365.config.json`.
`-v`, `--verbose`	Mostrar la salida detallada.
`--dry-run`	Mostrar lo que haría el comando sin ejecutarlo.
`--no-endpoint`	No registre el punto de conexión de mensajería (solo plano técnico).
`--endpoint-only`	Registre solo el punto de conexión de mensajería. Requiere un plano técnico existente.
`-?`, , `-h`, `--help`	Mostrar información de ayuda y uso.

`setup permissions`

Configure las concesiones de permisos de OAuth2 y los permisos heredables.

Permisos mínimos necesarios: Administrador global

a365 setup permissions [command] [options]

Options

Opción	Description
`-?`, , `-h`, `--help`	Mostrar información de ayuda y uso.

Subcomandos

Subcommand	Description
`mcp`	Configurar el servidor MCP OAuth2 concede y permisos heredables.
`bot`	Configure Messaging Bot API OAuth2 concede y permisos herebles.
`custom`	Aplica permisos de API personalizados al plano técnico del agente que van más allá de los permisos estándar necesarios para la operación del agente.
`copilotstudio`	Configura los permisos de OAuth2 y los permisos heredables para que el plano técnico del agente invoque Copilot Studio copilots a través de Power Platform API.

`setup permissions mcp`

Configurar el servidor MCP OAuth2 concede y permisos heredables.

Permisos mínimos necesarios: Administrador global

a365 setup permissions mcp [options]

Este comando:

ToolingManifest.json Lee del deploymentProjectPath especificado en a365.config.json.
Concede permisos delegados de OAuth2 para cada ámbito de servidor MCP al plano técnico del agente.
Configura los permisos heredables para que las instancias del agente puedan acceder a las herramientas de MCP.
Es idempotente y seguro para ejecutarse varias veces.

Importante

Antes de ejecutar este comando, ejecute a365 config display para comprobar que deploymentProjectPath apunta a la carpeta del proyecto que contiene el actualizado ToolingManifest.json. Si el desarrollador agrega servidores MCP en otra máquina, comparta primero el actualizado ToolingManifest.json con el administrador global. La ejecución sin el correcto ToolingManifest.json no agrega los nuevos permisos de servidor MCP al plano técnico.
Ejecute este comando después de que el desarrollador ejecute a365 develop add-mcp-servers. La adición de servidores MCP al manifiesto y la concesión de permisos al plano técnico son dos pasos independientes. Una vez completado este comando, los permisos del servidor MCP están visibles en el plano técnico del agente.

`permissions mcp` opciones

Opción	Description
`-c`, `--config <config>`	Ruta de acceso del archivo de configuración. El valor predeterminado es `a365.config.json`.
`-v`, `--verbose`	Mostrar la salida detallada.
`--dry-run`	Mostrar lo que haría el comando sin ejecutarlo.
`-?`, , `-h`, `--help`	Mostrar información de ayuda y uso.

`setup permissions bot`

Configure Messaging Bot API OAuth2 concede y permisos herebles.

Permisos mínimos necesarios: Administrador global

Requisitos previos: permisos de plano técnico y MCP (ejecute a365 setup permissions mcp primero)

a365 setup permissions bot [options]

`permissions bot` opciones

Opción	Description
`-c`, `--config <config>`	Ruta de acceso del archivo de configuración. El valor predeterminado es `a365.config.json`.
`-v`, `--verbose`	Mostrar la salida detallada.
`--dry-run`	Mostrar lo que haría el comando sin ejecutarlo.
`-?`, , `-h`, `--help`	Mostrar información de ayuda y uso.

`setup permissions custom`

Aplica permisos de API personalizados al plano técnico del agente que van más allá de los permisos estándar necesarios para la operación del agente. Mediante este comando, concede al agente acceso a ámbitos de Microsoft Graph adicionales, como Presencia, Archivos y Chat, o a api personalizadas registradas en el inquilino de Microsoft Entra ID de la organización.

Permisos mínimos necesarios: Administrador global

Requisitos previos: ejecute a365 setup blueprint primero. Agregue permisos personalizados a a365.config.json mediante a365 config permissions antes de ejecutar este comando.

a365 setup permissions custom [options]

Este comando:

Configura las concesiones de permisos delegados de OAuth2 con el consentimiento del administrador para cada recurso configurado.
Establece permisos heredables para que los usuarios del agente puedan heredar el acceso del plano técnico.
Reconcilia Microsoft Entra con la configuración actual agregando nuevos permisos y quitando los permisos eliminados de la configuración.
Es idempotente y seguro para ejecutarse varias veces.

`permissions custom` opciones

Opción	Description
`-c`, `--config <config>`	Ruta de acceso del archivo de configuración. El valor predeterminado es `a365.config.json`.
`-v`, `--verbose`	Mostrar la salida detallada.
`--dry-run`	Mostrar lo que haría el comando sin ejecutarlo.
`-?`, , `-h`, `--help`	Mostrar información de ayuda y uso.

Configuración de permisos personalizados

Use a365 config permissions para agregar permisos personalizados a la configuración antes de ejecutar este comando:

# Add Microsoft Graph extended permissions
a365 config permissions `
  --resource-app-id 00000003-0000-0000-c000-000000000000 `
  --scopes Presence.ReadWrite,Files.Read.All,Chat.Read

# Add custom API permissions
a365 config permissions `
  --resource-app-id <your-api-app-id> `
  --scopes CustomScope.Read,CustomScope.Write

# Apply all configured custom permissions
a365 setup permissions custom

Durante la instalación, el nombre del recurso se resuelve automáticamente desde Azure. No es necesario especificarlo en la configuración.

Eliminación de permisos personalizados

Para quitar permisos personalizados de la configuración y Microsoft Entra:

# Step 1: Remove from config
a365 config permissions --reset

# Step 2: Reconcile Microsoft Entra with updated config
a365 setup permissions custom

Integración con `setup all`

Cuando la configuración incluye permisos personalizados, la ejecución a365 setup all las configura automáticamente como parte de una sola fase de permisos por lotes. El orden de instalación completo es:

Plano técnico
Lote de permisos (MCP, Bot API, Permisos de plano técnico personalizados, todos configurados juntos)

`setup permissions copilotstudio`

Configura los permisos de OAuth2 y los permisos heredables para que el plano técnico del agente invoque Copilot Studio copilots a través de Power Platform API.

Permisos mínimos necesarios: Administrador global

Requisitos previos: ejecute a365 setup blueprint primero.

a365 setup permissions copilotstudio [options]

Este comando:

Garantiza que la entidad de servicio de Power Platform API existe en el inquilino.
Crea una concesión de permisos de OAuth2 desde el plano técnico a Power Platform API con el CopilotStudio.Copilots.Invoke ámbito.
Establece permisos heredables para que las instancias del agente puedan invocar Copilot Studio copilots.

`permissions copilotstudio` opciones

Opción	Description
`-c`, `--config <config>`	Ruta de acceso del archivo de configuración. El valor predeterminado es `a365.config.json`.
`-v`, `--verbose`	Mostrar la salida detallada.
`--dry-run`	Mostrar lo que haría el comando sin ejecutarlo.
`-?`, , `-h`, `--help`	Mostrar información de ayuda y uso.

Use este comando cuando el agente necesite invocar Copilot Studio copilots en tiempo de ejecución o llame a las API de Power Platform que requieren permisos de CopilotStudio.

`setup all`

Realice todos los pasos de configuración para configurar el entorno del Agente 365.

a365 setup all [options]

Ejecuta la configuración completa del Agente 365, todos los pasos en secuencia.

Incluye: Plano técnico y permisos.

Los pasos que se completen dependen de su rol:

Paso	Administrador global	Administrador de ID de Agente	Desarrollador de Identificación de Agente
Comprobación de requisitos previos	Sí	Sí	Sí
Creación del plano técnico del agente	Sí	Sí	Sí
Permisos heredados	Sí	Sí	Sí
Concesiones de permisos de OAuth2 (consentimiento del administrador)	Sí	Requiere el paso de disponibilidad general	Requiere el paso de disponibilidad general

Cuando se ejecuta a365 setup all sin administrador global, la CLI:

Completa todos los pasos que puede (creación de planos técnicos y permisos heredables).
Genera direcciones URL de consentimiento del administrador por recurso y las a365.generated.config.jsonguarda en .
Muestra los pasos siguientes que muestran cómo un administrador global puede completar las concesiones de OAuth2 mediante a365 setup admin o las direcciones URL de consentimiento generadas.

Sugerencia

Si es administrador global, a365 setup all completa todo en una sola ejecución sin necesidad de entrega.

Permisos mínimos requeridos:

Rol desarrollador de id. de agente (para la creación del plano técnico)
Administrador global (para concesiones de permisos de OAuth2, si no está disponible, use setup admin handoff)

`setup all` opciones

Opción	Description
`-c`, `--config <config>`	Ruta de acceso del archivo de configuración. El valor predeterminado es `a365.config.json`. Se omite cuando `--agent-name` se proporciona.
`-v`, `--verbose`	Mostrar la salida detallada.
`--dry-run`	Mostrar lo que haría el comando sin ejecutarlo.
`--skip-requirements`	Omitir la comprobación de validación de requisitos. Use con precaución: es posible que se produzca un error en la configuración si no se cumplen los requisitos previos.
`--aiteammate <true\\|false>`	Establézcalo en `true` para ejecutar el flujo de configuración del compañero de equipo de IA. El valor predeterminado es `false` (agente). Invalida el `aiTeammate` campo en `a365.config.json`.
`--agent-instance-only`	Solo agente. Omita el plano técnico y los permisos y registre solo la instancia del agente. Use para reintentar un paso de registro con errores.
`-n`, `--agent-name <name>`	Nombre base del agente (por ejemplo, `"MyAgent"`). Cuando se proporciona, no se requiere ningún archivo de configuración. Deriva nombres para mostrar como `"<name> Agent"` y `"<name> Blueprint"`. TenantId se detecta automáticamente desde `az account show` (invalida con `--tenant-id`). ClientAppId se resuelve buscando `Agent 365 CLI` en el inquilino.
`--tenant-id <tenantId>`	Azure identificador de inquilino de AD. Invalida la detección automática de `az account show`. Úselo con `--agent-name` cuando se ejecuta en un entorno no interactivo o para tener como destino un inquilino específico.
`-?`, , `-h`, `--help`	Mostrar información de ayuda y uso.

Instalación del agente

De forma predeterminada, a365 setup all ejecuta el flujo del agente. Este flujo crea un agente sin una dependencia de equipo de Dataverse o ai. Funciona para agentes que se comunican directamente con la plataforma del Agente 365 sin necesidad de una licencia de compañero de equipo de IA.

# Default: uses a365.config.json
a365 setup all

# Or explicitly (same result)
a365 setup all --aiteammate false

Para ejecutar el flujo del compañero de equipo de IA en su lugar, pase --aiteammate true.

Este flujo realiza los pasos siguientes en secuencia:

Requirements validation: comprueba Azure roles y requisitos previos.
Blueprint creation: crea o reutiliza la aplicación de plano técnico del agente de Entra ID.
permisos Batch: configura concesiones de permisos delegados en el plano técnico para Microsoft Graph, herramientas del agente 365, API de bot de mensajería, API de observabilidad, Power Platform y cualquier recurso personalizado.
Agent Identity creation : crea una identidad del agente en Entra ID a través del Graph API De identidad del agente.
Registro del agente : registra el agente a través de la API de registro del agente AgentX V2.
Sincronización de configuración: escribe la configuración de conexión en tiempo de ejecución y la configuración de observabilidad en los archivos del proyecto (appsettings.json, .env).

Nota:

La configuración del agente requiere seis permisos adicionales de API beta en la aplicación cliente personalizada: , , , , y AgentIdentityBlueprint.AddRemoveCreds.AllAgentIdentityBlueprint.DeleteRestore.All. AgentInstance.ReadWrite.AllAgentIdentity.ReadWrite.AllAgentIdentity.Create.AllAgentIdentity.DeleteRestore.All Consulte Registro de aplicaciones cliente personalizadas para obtener la lista completa.

Configuración sin configuración con `--agent-name`

Si no tiene un a365.config.json archivo, use --agent-name para ejecutar el programa de instalación sin uno. La CLI detecta automáticamente el inquilino y resuelve la aplicación cliente mediante la búsqueda del registro de aplicaciones conocido Agent 365 CLI en el inquilino.

# Preview what would happen (no changes made)
a365 setup all --agent-name "MyAgent" --dry-run

# Run the full setup
a365 setup all --agent-name "MyAgent"

Cuando se usa --agent-name:

TenantId se detecta automáticamente desde az account show. Pase --tenant-id a invalidar.
ClientAppId se resuelve buscando una aplicación Entra denominada Agent 365 CLI en el inquilino. Si no se encuentra, la CLI se cierra con un error. Consulte Registro de aplicaciones cliente personalizado para obtener información sobre cómo registrar esta aplicación.
Los nombres para mostrar se derivan como "<name> Agent" (identidad) y "<name> Blueprint" (plano técnico).
La infraestructura siempre se omite (se asume el hospedaje externo).
Se omite la sincronización de configuración (escrituraappsettings.json), ya que no hay ninguna ruta de acceso del proyecto configurada.

Si la aplicación cliente no tiene AllPrincipals el consentimiento del administrador para los permisos necesarios, la CLI detecta esto y le pide que conceda consentimiento de forma interactiva:

The following permissions require admin consent:
  AgentIdentity.ReadWrite.All
  AgentIdentity.Create.All
  ...
Grant admin consent for these permissions now? [y/N]:

Escriba y para conceder consentimiento en línea. Si no es administrador global, rechace y use el flujo de trabajo de setup admin entrega en su lugar.

Sincronización de configuración

Después de una ejecución correcta, la CLI escribe automáticamente la configuración del entorno de ejecución en los archivos del proyecto:

Configuración	Escrito en	Description
`Connections.ServiceConnection`	`appsettings.json` / `.env`	Identificador de cliente del plano técnico, secreto de cliente, identificador de inquilino y punto de conexión de token
`Agent365Observability`	`appsettings.json` / `.env`	Id. de agente (identidad del agente), identificador de plano técnico, identificador de inquilino, identificador de cliente y secreto de cliente para la exportación de telemetría
`TokenValidation`	`appsettings.json`	Configuración de validación de tokens (deshabilitada de forma predeterminada para no DW)
`ConnectionsMap`	`appsettings.json` / `.env`	Dirección URL de servicio predeterminada a la asignación de conexiones

La CLI crea el archivo si no existe y actualiza campos individuales sin sobrescribir el resto de la configuración.

Reintentar un registro con errores

Si la configuración completa el plano técnico y los permisos correctamente, pero se produce un error durante el registro del agente, use --agent-instance-only para reintentar solo ese paso sin repetir el trabajo anterior:

a365 setup all --agent-instance-only

`setup admin`

Completa las concesiones de permisos de OAuth2 (consentimiento del administrador) que requieren el administrador global. Ejecute este comando después de que un administrador de identificadores de agente o un desarrollador de identificadores de agente ejecute a365 setup all.

Permisos mínimos necesarios: Administrador global

a365 setup admin [options]

Cuándo debe usarse `setup admin`

Use este comando cuando:

Después de que un administrador de id. de agente o desarrollador de id. de agente ejecute a365 setup all.
El resumen de configuración muestra que las concesiones de OAuth2 están pendientes e indica al administrador global que ejecute este comando.
Quiere volver a ejecutar las concesiones de consentimiento después de cambiar los permisos en la configuración.

Flujo de trabajo de entrega típico

# Step 1: Agent ID Admin or Developer runs setup
a365 setup all

# The CLI displays next steps, for example:
# "ACTION REQUIRED — Global Administrator must complete OAuth2 grants"
# "Option 1: a365 setup admin --config-dir '<path-to-config-folder>'"
# "Option 2: Share the consent URL displayed above with your Global Administrator"

# Step 2: Agent ID Admin shares config folder with Global Administrator
# (contains a365.config.json and a365.generated.config.json)

# Step 3: Global Administrator completes the grants
a365 setup admin --config-dir "<path-to-config-folder>"

Este comando:

Carga la configuración del agente desde el directorio especificado o el directorio actual de forma predeterminada.
Lee el identificador del plano técnico del agente y los permisos de recursos configurados de la configuración generada.
Crea AllPrincipals concesiones de permisos de OAuth2 para todos los recursos configurados, incluidos:
- Microsoft Graph (ámbitos delegados)
- Herramientas del Agente 365 (ámbitos de servidor MCP)
- API de bot de mensajería
- API de observabilidad
- API de Power Platform
- Todos los permisos personalizados definidos en la configuración
Muestra un mensaje de confirmación antes de realizar cambios. Use --yes para omitir el mensaje.

Advertencia

Las concesiones de OAuth2 creadas por este comando son para todo el inquilino (consentType=AllPrincipals). Esta configuración significa que todos los usuarios del inquilino pueden usar los permisos delegados del agente. Revise detenidamente los ámbitos enumerados antes de confirmarlo.

`setup admin` opciones

Opción	Description
`-d`, `--config-dir <dir>`	Directorio que contiene `a365.config.json` y `a365.generated.config.json`. El valor predeterminado es el directorio actual.
`-v`, `--verbose`	Mostrar la salida detallada.
`--dry-run`	Mostrar lo que haría el comando sin ejecutarlo.
`--skip-requirements`	Omitir la comprobación de validación de requisitos. Úselo con precaución.
`-y`, `--yes`	Omita el mensaje de confirmación y continúe automáticamente.
`-?`, , `-h`, `--help`	Mostrar información de ayuda y uso.

En lugar de ejecutar a365 setup admin, el administrador global puede abrir la dirección URL de consentimiento combinada que a365 setup all se guarda en a365.generated.config.json. Esta dirección URL cubre todos los recursos necesarios en una sola visita del explorador.

# Display the generated config to find the consent URL
a365 config display -g
# Look for: combinedAdminConsentUrl

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2026-04-22

Referencia de comandos de la CLI setup del agente 365

Syntax

Options

Orden de ejecución recomendado

setup requirements

requirements opciones

setup blueprint

blueprint opciones

setup permissions

Options

Subcomandos

setup permissions mcp

permissions mcp opciones

setup permissions bot

permissions bot opciones

setup permissions custom

permissions custom opciones

Configuración de permisos personalizados

Eliminación de permisos personalizados

Integración con setup all

setup permissions copilotstudio

permissions copilotstudio opciones

setup all

setup all opciones

Instalación del agente

Configuración sin configuración con --agent-name

Consentimiento del administrador durante la instalación

Sincronización de configuración

Reintentar un registro con errores

setup admin

Cuándo debe usarse setup admin

Flujo de trabajo de entrega típico

setup admin opciones

Alternativa: dirección URL de consentimiento

Comentarios

Recursos adicionales

Referencia de comandos de la CLI `setup` del agente 365

`setup requirements`

`requirements` opciones

`setup blueprint`

`blueprint` opciones

`setup permissions`

`setup permissions mcp`

`permissions mcp` opciones

`setup permissions bot`

`permissions bot` opciones

`setup permissions custom`

`permissions custom` opciones

Integración con `setup all`

`setup permissions copilotstudio`

`permissions copilotstudio` opciones

`setup all`

`setup all` opciones

Configuración sin configuración con `--agent-name`

`setup admin`

Cuándo debe usarse `setup admin`

`setup admin` opciones