共用方式為

Agent 365 CLI

重要

你需要參加 Frontier 預覽計畫 ，才能搶 先取得 Microsoft Agent 365 的使用權。 Frontier 直接連結你與 Microsoft 最新的 AI 創新。 Frontier 預覽受限於您現有的客戶協議預覽條款。 由於這些功能仍在開發中，其可用性與功能可能會隨時間改變。

Agent 365 CLI 是一款跨平台命令列工具，用於在 Azure 上部署和管理 Agent 365 應用程式。

安裝 Agent 365 CLI

請依照以下步驟在作業系統上全域安裝 Agent 365 CLI。

先決條件

你必須安裝 .NET 版本。 （建議使用 .NET 8.0。）

在 Windows 上安裝 .NET

dotnet tool install

使用下列命令來安裝客體代理程式：

dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli

如果收到 microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json 錯誤，請使用該 --prerelease 參數，因為該套件可能仍被標記為預發布。

dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease

欲取得最新說明與可用版本，請造訪官方 NuGet 頁面： Microsoft.Agents.A365.DevTools.Cli on NuGet.org

確認安裝

安裝 Agent 365 CLI 後，請執行以下操作來確認安裝正確：

a365 -h

此指令顯示說明資訊並確認 CLI 已準備好使用。

Update

透過使用 dotnet tool update 指令更新代理 365 CLI：

dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli

注意

所有針對 Agent 365 CLI 的更新，都需要網路連線才能存取最新的 Nuget 套件： Microsoft.Agents.A365.DevTools.Cli

解除安裝

使用 dotnet 工具的 卸載 指令解除安裝 agent 365 CLI：

dotnet tool uninstall --global Microsoft.Agents.A365.DevTools.Cli

檔案位置

工具二進位檔的預設位置取決於作業系統：

OS 路徑
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

第一次執行 SDK 時，會將此位置新增至使用者的路徑。 因此，可以從任何目錄叫用全域工具，而不需要指定工具位置。

工具存取是使用者所特有，而非機器全域。 全域工具僅適用於已安裝工具的使用者。

可用的命令

欲查詢完整可用指令清單，請使用該 --help 指令或參見 Agent 365 CLI 參考資料

疑難排解​​

本節包含如何排解 Agent 365 CLI 錯誤的資訊。

安裝、更新或卸載 CLI 都會失敗 Not found in NuGet feeds

若收到 microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json 錯誤，請使用 --prerelease 該參數，因為此套件仍可能標示為預發布。

欲取得最新說明與可用版本，請造訪官方 NuGet 頁面： Microsoft.Agents.A365.DevTools.Cli on NuGet.org

設定失敗且錯誤Authorization_RequestDenied

如果你在執行setup指令時收到Authorization_RequestDenied錯誤，表示你的 Microsoft Entra 環境存在權限問題。

常見原因

此問題通常會在下列情況發生：

  • 你的帳號缺乏必要的權限
  • Microsoft Graph 命令列工具應用程式需要管理員同意
  • 你的環境中存在衝突或過度權限的權限

解決步驟

  1. 確認您的帳戶具有 Reader 角色

    請確保你使用的帳號擁有以下其中一個角色：

    • 代理 ID 開發者
    • 代理識別管理員
    • 全域系統管理員

  2. 審查並授予 Microsoft Graph 命令列工具的管理員同意

    a365 設定指令使用 Microsoft Graph 命令列工具應用程式，該應用程式可能存在相互衝突的權限。

    要檢視並修正：

    1. 登入 Azure 入口網站

    2. 搜尋 Microsoft Graph 命令列工具 或搜尋應用程式 ID： 14d82eec-204b-4c2f-b7e8-296a70dab67e

    3. 從導覽區選擇安全>權限。

    4. 找許可Directory.AccessAsUser.All

      • 這種高度特權的權限會干擾藍圖的製作
      • 若有，請考慮移除或以最低權限替代方案取代，例如 Directory.Read.All

      警告

      只有在你確定環境中其他工具或腳本不需要時，才移除這個權限

    5. 如果尚未授予管理員同意，請選擇 授予[您的租戶]的管理員同意。

  3. 做完修改後，再跑一次a365 setup

其他資源

欲了解更多已知問題，請參閱 Microsoft Entra 代理 ID 已知問題 - Directory.AccessAsUser.All 會導致忽略其他權限。

  • Last updated on