代理 365 CLI
重要
您需要加入 Frontier 预览计划 ,才能提前获得 Microsoft Agent 365 的 访问权限 。 Frontier将你直接连接到Microsoft最新的人工智能创新。 Frontier预览受现有客户协议的预览条款约束。 由于这些功能仍在开发中,其可用性和功能可能会随着时间发生变化。
设置代理 365 环境,并精细控制每个步骤。 此命令管理代理 365 蓝图的初始设置工作流。
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 |
显示帮助和使用情况信息。 |