代理 365 CLI 參考

Agent 365 CLI 參考是一個完整的命令列介面,用於建置和管理 Microsoft 365 的 AI 代理。 了解如何開始使用 Agent 365 CLI

Global options

所有指令都支援以下全域選項:

  • --version:顯示版本資訊。
  • -?-h, : --help顯示幫助與使用資訊。

Commands

下表列出可用的指令。

Tip

每個指揮部都有特定的職務要求。 請參閱各指令參考頁面,了解執行每個指令所需的最低角色。 例如,setup 指令 至少需要 Azure Contributor + Agent ID Developer。 全域管理員僅用於授予 OAuth2 權限;當全域管理員是不同的人時,a365 setup all會列印他們需要完成的下一步步驟。 對於 S2S(伺服器對伺服器)代理身份授權(--authmode s2sboth),代理識別 管理員 或更高等級,則需啟用。

Command Description
cleanup 清理ALL資源(藍圖、實例和Azure)。 使用子指令來進行細緻清理。
cleanup azure Remove Azure resources (App Service, App Service Plan).
cleanup blueprint 移除 Entra ID 藍圖應用程式與服務主體。
cleanup instance 從 Entra ID 移除代理實例的身份和使用者。
develop 管理 MCP 工具伺服器以進行代理開發。
develop add-mcp-servers 將 MCP 伺服器加入目前的代理配置。
develop add-permissions 在開發情境中,為需要設定自訂應用程式以存取 MCP 伺服器的 Microsoft Entra 應用程式新增 API 權限。
develop get-token 在開發過程中使用互動式瀏覽器認證,取得 MCP 伺服器測試的持有憑證。
develop list-available 列出目錄中所有可用的 MCP 伺服器(你能安裝的設備)。
develop list-configured 從你本地 ToolingManifest.json的 MCP 伺服器列出目前已設定的伺服器。
develop remove-mcp-servers 將 MCP 伺服器從目前代理設定中移除。
develop start-mock-tooling-server 啟動一個模擬工具伺服器,用於測試和開發目的。
develop-mcp 管理 Dataverse 環境中的 MCP 伺服器。
develop-mcp approve 批准 MCP 伺服器。
develop-mcp block 封鎖一台 MCP 伺服器。
develop-mcp list-environments 列出所有可用於 MCP 伺服器管理的 Dataverse 環境。
develop-mcp list-servers 列出特定 Dataverse 環境中的 MCP 伺服器。
develop-mcp package-mcp-server 產生 MCP 伺服器套件以提交至 Microsoft 管理中心。
develop-mcp publish 將 MCP 伺服器發佈到 Dataverse 環境。
develop-mcp register-external-mcp-server 請用 Entra、外部 OAuth、API 金鑰或無認證註冊外部 MCP 伺服器。
develop-mcp unpublish 從 Dataverse 環境中卸載 MCP 伺服器。
publish 更新 manifest.json 中的 ID 值,並建立一個 manifest.zip 套件上傳到 Microsoft 365 系統管理中心。
query-entra 提供查詢 Microsoft Entra ID 代理資訊的選項,包括範圍、權限及同意狀態。
query-entra blueprint-scopes 列出配置範圍與同意狀態,為代理藍圖提供。
query-entra instance-scopes 列出代理實例的配置範圍與同意狀態。
setup 在每個步驟上設置你的 Agent 365 環境,並細緻地控制每個步驟。
setup all 執行所有設定步驟以建立您的 Agent 365 環境
setup blueprint 建立代理藍圖(Entra ID 應用程式註冊)。
setup permissions 設定 OAuth2 權限授予與可繼承權限。
setup permissions bot 配置訊息機器人 API OAuth2 授權與可繼承權限。
setup permissions copilotstudio 配置 OAuth2 授權並繼承代理藍圖可透過 Power Platform API 呼叫 Copilot Studio 副駕駛。
setup permissions custom 為你的代理藍圖套用自訂的 API 權限,超出代理操作所需的標準權限。
setup permissions mcp 設定 MCP 伺服器 OAuth2 授權與可繼承權限。
setup requirements 驗證 Agent 365 設定的前提條件。