Comparteix a través de

Referencia de comandos de la CLI config 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 la configuración de la CLI del Agente 365. Proporciona opciones para administrar los valores de configuración de la CLI del Agente 365. Puede inicializar nuevas configuraciones de forma interactiva o mostrar las opciones de configuración actuales.

Rol mínimo necesario: Ninguno (configuración local)

Syntax

a365 config [command] [options]

Options

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

config init

Configure interactivamente la CLI del Agente 365 o importe desde un archivo.

a365 config init [options]

Use este comando para configurar la configuración de la CLI del Agente 365 a través de un proceso interactivo o mediante la importación de la configuración desde un archivo de configuración existente.

init opciones

Opción Description
-c, --configfile <configfile> Ruta de acceso a un archivo de configuración existente que se va a importar
-g, --global Creación de una configuración en el directorio global (AppData) en lugar del directorio actual
-?, , -h, --help Mostrar información de ayuda y uso

Observaciones

El config init comando inicia un asistente interactivo que minimiza la entrada manual:

  • Azure CLI integración: detecta automáticamente la suscripción, el inquilino, los grupos de recursos, los planes y las regiones de App Service.
  • Valores predeterminados inteligentes: genera nombres de recursos a partir del nombre del agente y una marca de tiempo (por ejemplo, myagent-webapp-11140916). Puede personalizar estos nombres antes de guardarlos.
  • detección de Platform: detecta el tipo de proyecto (.NET, Node.js, Python) desde la ruta de acceso del proyecto de implementación y advierte si no se encuentra ningún tipo admitido.
  • Validación de aplicaciones cliente: valida el identificador de aplicación cliente en el inquilino de Entra, comprobando que se configuran los permisos necesarios y se concede el consentimiento del administrador. Tiene hasta tres intentos antes de que salga el asistente.

Permisos de plano técnico personalizados (opcional): el asistente incluye un paso opcional para configurar permisos para recursos externos adicionales, como la presencia de Teams o los archivos de OneDrive. La mayoría de los agentes no requieren esto. También puede configurar permisos después de la instalación inicial mediante a365 config permissions.

Actualización de la configuración existente: volver a ejecutar a365 config init carga el actual a365.config.json como valores predeterminados. Presione Entrar en cada símbolo del sistema para mantener el valor actual o escriba un nuevo valor para actualizarlo.

config display

Mostrar la configuración actual de la CLI del agente 365.

a365 config display [options]

Este comando muestra las opciones de configuración actuales de la CLI del Agente 365, por lo que puede revisar la configuración actual.

display opciones

Opción Description
-g, --generated Mostrar la configuración generada (a365.generated.config.json)
-a, --all Mostrar la configuración estática y generada
-?, , -h, --help Mostrar información de ayuda y uso

Estructura del archivo de configuración

La CLI usa un archivo de configuración JSON (a365.config.json) con las siguientes propiedades clave:

{
  "$schema": "./a365.config.schema.json",
  "tenantId": "your-tenant-id",
  "subscriptionId": "your-subscription-id",
  "resourceGroup": "rg-Agent 365-example",
  "location": "westus",
  "appServicePlanName": "asp-Agent 365-example",
  "appServicePlanSku": "B1",
  "webAppName": "webapp-Agent 365-example",
  "agentBlueprintDisplayName": "My Agent 365 Blueprint",
  "agentIdentityDisplayName": "My Agent 365 Agent",
  "agentUserPrincipalName": "agent@contoso.onmicrosoft.com",
  "agentUserDisplayName": "My Agent 365 User",
  "managerEmail": "manager@contoso.onmicrosoft.com",
  "agentUserUsageLocation": "US",
  "agentIdentityScopes": [
    "User.Read",
    "Mail.Send",
    "Calendars.ReadWrite",
    "Files.ReadWrite"
  ],
  "agentApplicationScopes": [
    "Mail.ReadWrite",
    "Chat.ReadWrite",
    "Sites.Read.All"
  ],
  "deploymentProjectPath": ".",
  "deploymentProjectFile": "YourProject.csproj",
  "botName": "my-Agent 365-bot",
  "botDescription": "My AI-powered agent for Microsoft 365 tasks"
}
  • Last updated on