通过


代理 365 CLI setup 命令参考

重要

您需要加入 Frontier 预览计划 ,才能提前获得 Microsoft Agent 365 的 访问权限 。 Frontier将你直接连接到Microsoft最新的人工智能创新。 Frontier预览受现有客户协议的预览条款约束。 由于这些功能仍在开发中,其可用性和功能可能会随着时间发生变化。

设置代理 365 环境,并精细控制每个步骤。 此命令管理代理 365 蓝图的初始设置工作流。

所需的最低角色Azure 参与者 + 全局管理员

Syntax

a365 setup [command] [options]

选项

选项 Description
-?-h--help 显示帮助和使用情况信息。
# 0. Check prerequisites (optional)
a365 setup requirements

# 1. Create infrastructure (or skip if infrastructure exists)
a365 setup infrastructure

# 2. Create blueprint
a365 setup blueprint

# 3. Configure MCP permissions
a365 setup permissions mcp

# 4. Configure bot permissions
a365 setup permissions bot

或者一次性运行所有步骤:

# Full setup (includes infrastructure)
a365 setup all

# Skip infrastructure if it already exists
a365 setup all --skip-infrastructure

setup requirements

验证代理 365 设置的先决条件。 运行模块化要求检查,并为发现任何问题提供指导。

a365 setup requirements [options]

此命令运行以下步骤:

  • 检查代理 365 安装所需的所有先决条件。
  • 报告有关详细解决指南的任何问题。
  • 继续检查所有要求,即使某些检查失败。
  • 提供末尾所有检查的摘要。

requirements 选项

选项 Description
-c--config <config> 配置文件路径。 默认值为 a365.config.json。
-v--verbose 显示所有检查的详细输出。
--category <category> 仅运行检查特定类别,例如“Azure”、“身份验证”或“配置”。
-?-h--help 显示帮助和使用情况信息。

setup infrastructure

创建 Azure 基础结构。

所需的最低权限:Azure 订阅参与者或所有者

a365 setup infrastructure [options]

infrastructure 选项

选项 Description
-c--config <config> 配置文件路径。 默认值为 a365.config.json。
-v--verbose 显示详细的输出。
--dry-run 显示在不执行的情况下将执行的作。
-?-h--help 显示帮助和使用情况信息。

setup blueprint

创建代理蓝图(Entra ID 应用程序注册)。

最低所需权限:代理 ID 开发人员角色

a365 setup blueprint [options]

blueprint 选项

选项 Description
-c--config <config> 配置文件路径。 默认值为 a365.config.json。
-v--verbose 显示详细的输出。
--dry-run 显示在不执行的情况下将执行的作。
--no-endpoint 请勿注册消息传送终结点(仅蓝图)
--endpoint-only 仅注册消息传送终结点。 需要现有蓝图
-?-h--help 显示帮助和使用情况信息。

setup permissions

配置 OAuth2 权限授予和可继承的权限。

所需的最低权限:全局管理员

a365 setup permissions [command] [options]

选项

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

子命令

  • mcp - 配置 MCP 服务器 OAuth2 授予和可继承的权限
  • bot - 配置消息传送机器人 API OAuth2 授予和可继承的权限

setup permissions mcp

配置 MCP 服务器 OAuth2 授予和可继承的权限。

所需的最低权限:全局管理员

a365 setup permissions mcp [options]

permissions mcp 选项

选项 Description
-c--config <config> 配置文件路径。 默认值为 a365.config.json。
-v--verbose 显示详细的输出。
--dry-run 显示在不执行的情况下将执行的作。
-?-h--help 显示帮助和使用情况信息。

setup permissions bot

配置消息传送机器人 API OAuth2 授予和可继承的权限。

所需的最低权限:全局管理员

先决条件:蓝图和 MCP 权限(首先运行 a365 setup permissions mcp

下一步:部署代理(在 Azure 上托管时运行 a365 deploy

a365 setup permissions bot [options]

permissions bot 选项

选项 Description
-c--config <config> 配置文件路径。 默认值为 a365.config.json。
-v--verbose 显示详细的输出。
--dry-run 显示在不执行的情况下将执行的作。
-?-h--help 显示帮助和使用情况信息。

setup all

执行所有设置步骤以设置代理 365 环境

a365 setup all [options]

运行完整的代理 365 安装程序,并按顺序执行所有步骤。

包括:基础结构、蓝图、权限和终结点。

最低所需权限 (全局管理员拥有所有这些权限):

  • Azure 订阅参与者(适用于基础结构和终结点)
  • 代理 ID 开发人员角色(用于创建蓝图)
  • 全局管理员(用于权限授予和管理员同意)

setup all 选项

选项 Description
-c--config <config> 配置文件路径。 默认值为 a365.config.json。
-v--verbose 显示详细的输出。
--dry-run 显示在不执行的情况下将执行的作。
--skip-infrastructure 跳过 Azure 基础结构创建(如果基础结构已存在)使用)。 此选项仍会创建:蓝图、权限和终结点。
--skip-requirements 跳过要求验证检查。 请谨慎使用:如果未满足先决条件,安装程序可能会失败。
-?-h--help 显示帮助和使用情况信息。