Agent 365 CLI 是跨平台的命令列工具，可用於在 Azure 上部署及管理 Agent 365 應用程式。
您不需要手動安裝 CLI。 AI 導引式設定會檢查 CLI、自動安裝或更新 CLI，並代您執行所有必要的命令。 本頁面是供需要直接安裝或使用 CLI 的開發人員參考，例如建立 CI/CD 自動化、疑難排解特定步驟，或在沒有 AI 程式碼撰寫 Agent 的情況下工作時使用。
注意
完整的開發人員工作流程 (包括 AI 導引式設定、角色指引及部署後步驟) 請參閱開始使用 Agent 365 開發。 本頁面為 CLI 參考資料，涵蓋安裝、更新、解除安裝、可用命令及疑難排解。
先決條件
CLI 需要 .NET 8.0 或更新版本。 如需其他必要條件 (例如 Azure 訂用帳戶、必要的 Entra 角色，以及自訂用戶端應用程式註冊)，請參閱 AI 導引式設定。
安裝 Agent 365 CLI
請依照下列步驟，在您的作業系統上全域安裝 Agent 365 CLI。
先決條件
您必須已安裝 .NET。 (建議使用 .NET 8.0。)
使用 dotnet tool install
請使用下列命令安裝 Agent 365 CLI：
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli
如需最新的指示與可用版本，請造訪官方 NuGet 頁面：NuGet.org 上的 Microsoft.Agents.A365.DevTools.Cli
確認安裝
安裝 Agent 365 CLI 後，請執行 --help 命令，確認已正確安裝：
a365 -h
此命令會顯示說明資訊，並確認 CLI 已可供使用。
Update
請使用 dotnet tool update 命令更新 Agent 365 CLI：
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli
注意
若要更新 Agent 365 CLI，您需要網際網路連線，才能存取最新的 NuGet 套件：Microsoft.Agents.A365.DevTools.Cli。
解除安裝
請使用 dotnet tool uninstall 命令解除安裝 Agent 365 CLI：
dotnet tool uninstall --global Microsoft.Agents.A365.DevTools.Cli
檔案位置
工具可執行檔的預設位置會因作業系統而異：
| OS | 路徑 |
|---|---|
| Linux/macOS | $HOME/.dotnet/tools |
| Windows | %USERPROFILE%\.dotnet\tools |
您首次執行 SDK 時，SDK 會將此位置新增至您的路徑。 因此您可以從任何目錄叫用全域工具，而不需要指定工具的位置。
工具存取是使用者所特有，而非機器全域。 全域工具僅供安裝該工具的使用者使用。
可用的命令
如需完整的可用命令清單，請使用 --help 命令，或參閱 Agent 365 CLI 參考。
提示
您不需要手動執行 CLI 命令。 AI 導引式設定會使用 AI 程式碼撰寫 Agent，自動完成完整的工作流程，包括 CLI 安裝、設定、藍圖設定、部署及發佈。 如果您要建立 CI/CD 自動化、疑難排解特定步驟，或在沒有 AI 程式碼撰寫 Agent 的情況下工作，請使用此處的 CLI 參考資料。
如需使用 CLI 設定 Agent 365 Agent 的完整指示，請參閱開始使用 Agent 365 開發。
疑難排解
本節提供如何疑難排解 Agent 365 CLI 錯誤的相關資訊。
提示
Agent 365 疑難排解指南包含高階疑難排解建議、最佳做法，以及每個階段的疑難排解連結，涵蓋 Agent 365 開發生命週期的所有部分。
本節涵蓋的 CLI 特定問題：
Agent 未顯示在 Teams 中
建立 Agent 執行個體疑難排解：Agent 未顯示在 Teams 中