Agent 365 CLI
這很重要
你需要參加 Frontier 預覽計畫 ，才能 搶先取得 Microsoft Agent 365 的使用權。 Frontier 直接連結你與 Microsoft 最新的 AI 創新。 Frontier 預覽受限於您現有的客戶協議預覽條款。 由於這些功能仍在開發中，其可用性與功能可能會隨時間改變。
在每個步驟上設置你的 Agent 365 環境，並細緻地控制每個步驟。 此指令管理 Agent 365 藍圖的初始設定工作流程。
最低所需角色： Azure Contributor + Global Administrator
語法
a365 setup [command] [options]
選項
| Option | 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
驗證 Agent 365 設定的前提條件。 執行模組化需求檢查，並針對發現的問題提供指導。
a365 setup requirements [options]
此指令執行以下步驟：
- 檢查 Agent 365 設置所需的所有前置條件。
- 提供詳細的解決指引回報任何問題。
- 即使有些檢查失敗，仍持續檢查所有需求。
- 最後會提供所有檢查的摘要。
requirements 選項
| Option | Description |
|---|---|
-c、--config <config> |
設定檔路徑。 預設為 a365.config.json。 |
-v、--verbose |
顯示所有檢查的詳細輸出。 |
--category <category> |
僅針對特定類別進行檢查，例如「Azure」、「Authentication」或「Configuration」。 |
-?、-h、--help |
顯示幫助與使用資訊。 |
setup infrastructure
建立 Azure 基礎架構。
最低必要權限：Azure 訂閱貢獻者或擁有者
a365 setup infrastructure [options]
infrastructure 選項
| Option | Description |
|---|---|
-c、--config <config> |
設定檔路徑。 預設為 a365.config.json。 |
-v、--verbose |
顯示詳細的成果。 |
--dry-run |
展示不執行的情況下會做什麼。 |
-?、-h、--help |
顯示幫助與使用資訊。 |
setup blueprint
建立代理藍圖（Entra ID 應用程式註冊）。
最低必要權限：代理 ID 開發者角色
a365 setup blueprint [options]
blueprint 選項
| Option | 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]
選項
| Option | Description |
|---|---|
-?、-h、--help |
顯示幫助與使用資訊。 |
子命令
-
mcp- 配置 MCP 伺服器 OAuth2 授權與可繼承權限 -
bot- 配置訊息機器人 API OAuth2 授權與可繼承權限
setup permissions mcp
設定 MCP 伺服器 OAuth2 授權與可繼承權限。
最低必要權限：全域管理員
a365 setup permissions mcp [options]
permissions mcp 選項
| Option | Description |
|---|---|
-c、--config <config> |
設定檔路徑。 預設為 a365.config.json。 |
-v、--verbose |
顯示詳細的成果。 |
--dry-run |
展示不執行的情況下會做什麼。 |
-?、-h、--help |
顯示幫助與使用資訊。 |
setup permissions bot
配置訊息機器人 API OAuth2 授權與可繼承權限。
最低必要權限：全域管理員
前置條件：Blueprint 與 MCP 權限（先執行 a365 setup permissions mcp ）
下一步：部署你的代理程式（ a365 deploy 如果是 Azure 主機，則執行）。
a365 setup permissions bot [options]
permissions bot 選項
| Option | Description |
|---|---|
-c、--config <config> |
設定檔路徑。 預設為 a365.config.json。 |
-v、--verbose |
顯示詳細的成果。 |
--dry-run |
展示不執行的情況下會做什麼。 |
-?、-h、--help |
顯示幫助與使用資訊。 |
setup all
執行所有設定步驟以建立您的 Agent 365 環境
a365 setup all [options]
執行完整的 Agent 365 設定，所有步驟依序執行。
包括：基礎架構、藍圖、權限與端點。
最低必要權限 （全域管理員擁有以下所有權限）：
- Azure Subscription Contributor （for infrastructure and endpoint）
- 代理 ID 開發者角色（用於藍圖創建）
- 全域管理員（用於權限授權與管理員同意）
setup all 選項
| Option | Description |
|---|---|
-c、--config <config> |
設定檔路徑。 預設為 a365.config.json。 |
-v、--verbose |
顯示詳細的成果。 |
--dry-run |
展示不執行的情況下會做什麼。 |
--skip-infrastructure |
跳過 Azure 基礎架構建立（如果已經有基礎架構就使用）。 這個選項仍然會建立：Blueprint、Permissions 和 Endpoint。 |
--skip-requirements |
跳過需求驗證檢查。 使用時請小心：若未達成前提條件，設定可能會失敗。 |
-?、-h、--help |
顯示幫助與使用資訊。 |