通过

代理 365 CLI config 命令参考

重要

需要成为 Frontier 预览计划的一部分，才能获得 抢先体验Microsoft Agent 365。 Frontier将你直接连接到Microsoft最新的人工智能创新。 Frontier预览受现有客户协议的预览条款约束。 由于这些功能仍在开发中，其可用性和功能可能会随着时间发生变化。

管理代理 365 CLI 配置。 提供用于管理代理 365 CLI 配置设置的选项。 可以交互方式初始化新配置，也可以显示当前配置设置。

所需的最低角色：无（本地配置）

Syntax

a365 config [command] [options]

选项

选项 Description
-?、-h、--help 显示帮助和使用情况信息

config init

以交互方式配置代理 365 CLI 或从文件导入。

a365 config init [options]

使用此命令通过交互式过程或通过从现有配置文件导入设置来设置代理 365 CLI 配置。

init 选项

选项 Description
-c、--configfile <configfile> 要导入的现有配置文件的路径
-g、--global 在全局目录（AppData）而不是当前目录中创建配置
-?、-h、--help 显示帮助和使用情况信息

注解

该 config init 命令启动一个交互式向导，该向导可最大程度地减少手动输入：

  • Azure CLI集成：自动检测订阅、租户、资源组、应用服务计划和区域。
  • 智能默认值：从代理名称和时间戳（例如， myagent-webapp-11140916）生成资源名称。 可以在保存之前自定义这些名称。
  • Platform 检测：从部署项目路径检测项目类型（.NET、Node.js、Python），并在找不到支持的类型时发出警告。
  • 客户端应用验证：根据 Entra 租户验证客户端应用 ID，检查是否已配置所需的权限并授予管理员同意。 在向导退出之前，最多有三次尝试。

Custom 蓝图权限（可选）：向导包含一个可选步骤，用于为其他外部资源（例如 Teams 状态或OneDrive文件）配置权限。 大多数代理都不需要这样做。 也可以使用初始设置 a365 config permissions后配置权限。

更新现有配置：重新运行 a365 config init 以默认值的形式加载当前 a365.config.json 配置。 在每个提示符下按 Enter 以保留当前值，或键入新值以更新该值。

config display

显示当前代理 365 CLI 配置。

a365 config display [options]

此命令显示代理 365 CLI 的当前配置设置，以便查看当前设置。

display 选项

选项 Description
-g、--generated 显示生成的配置（a365.generated.config.json）
-a、--all 同时显示静态配置和生成的配置
-?、-h、--help 显示帮助和使用情况信息

配置文件结构

CLI 使用以下键属性的 JSON 配置文件 （a365.config.json）：

{
  "$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