將 Agent 發佈至 Microsoft 系統管理中心

使用 a365 publish 命令封裝您的 Agent，然後將封裝包上傳至 Microsoft 365 系統管理中心。 發佈後，您可以在組織內建立 Agent 執行個體，並治理該 Agent。

先決條件

開始之前，請確認您已具備下列項目。

必要的帳戶與權限

  • Microsoft 365 租用戶，並具備下列其中一種角色 (系統管理中心上傳步驟需要)：

    • 全域系統管理員

必要工具

必要的設定步驟

發佈之前，請完成下列步驟：

  1. 建立 Agent 藍圖 - 依照設定步驟建立您的 Agent 藍圖。
  2. 在本機測試 Agent - 使用 Agents Playground 確認您的 Agent 運作正常 (請參閱在本機測試 Agent)。
  3. 準備設定檔 - 確認 a365.config.json 與 a365.generated.config.json 為最新版本。

發佈命令

執行 a365 publish 命令：

a365 publish

注意

執行 a365 publish -h 會顯示此命令支援的所有選項。

此命令的作用：

  1. 更新資訊清單 - 使用您的 Agent 藍圖識別碼更新 manifest.json。
  2. 建立套件 - 將 manifest.json 與圖示封裝為 manifest.zip。
  3. 列印指示 - 顯示透過 Microsoft 365 系統管理中心上傳的逐步指示。

注意

a365 publish 命令同時適用於 Agent 與 AI 隊友。 對於使用 --agent-name 佈建 (免設定) 的 Agent，執行 a365 publish 之前，請確認工作目錄中存在 a365.generated.config.json，因為此命令會從此檔案讀取藍圖識別碼。

上傳至系統管理中心

a365 publish 完成後，請依照列印的指示上傳您的 Agent：

  1. 請移至 Microsoft 365 系統管理中心。
  2. 巡覽至 Agent>所有 Agent。
  3. 選取上傳自訂 Agent。
  4. 從專案的 manifest 資料夾上傳 manifest.zip 檔案。

如需詳細資訊，請參閱將 Agent 上傳至 Microsoft 365 系統管理中心。

確認發佈成功

使用下列檢查清單，確認您的 Agent 已成功發佈：

✅ CLI 發佈成功
✅ manifest 資料夾已建立，內含 manifest.json 與 manifest.zip
✅ Agent 出現在 Microsoft 系統管理中心

CLI 輸出

發佈命令成功時，您會看到下列輸出訊息：

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ 已列印逐步上傳指示

如果命令失敗，請檢查錯誤訊息，並確認您已完成藍圖設定。

可能發生的錯誤：

錯誤 解決步驟
Agent blueprint ID not found 執行 a365 setup 以完成藍圖設定。
Permissions missing 使用 a365 setup permissions 命令重新執行設定。

發佈失敗時，請依照這些步驟執行。

資訊清單

您可以使用 Test-Path PowerShell 命令，測試 manifest 資料夾中的下列檔案。

# Check manifest folder and contents exists
Test-Path <deploymentProjectPath>/manifest/
Test-Path <deploymentProjectPath>/manifest/manifest.json
Test-Path <deploymentProjectPath>/manifest/manifest.zip
# All should return: True

注意

如果沒有看到這些檔案，請再次嘗試執行 a365 publish 命令。

Agent 出現在系統管理中心

注意

上傳後，您的 Agent 可能需要 5-10 分鐘才會出現在系統管理中心和 Teams 中。 此延遲屬正常現象。

請依照下列步驟確認 Agent 是否存在：

  1. 移至 Microsoft 365 系統管理中心。
  2. 巡覽至 Agent>所有 Agent。
  3. 您的 Agent 會顯示在清單中。

下表顯示您可以找到的詳細資料：

欄位 要檢查的項目
名稱 您的 Agent 名稱 (來自 manifest.json)
版本 版本號碼 (例如 1.0.0)
發行者 您的組織名稱
可用性 可用/所有使用者

請參閱

後續步驟

發佈 Agent 後，請建立執行個體，以便在您的租用戶中設定並使用它。

建立 Agent 執行個體

疑難排解​​

將 Agent 發佈至 Microsoft 365 系統管理中心時的常見問題。

提示

Agent 365 疑難排解指南包含高階疑難排解建議、最佳做法，以及每個階段的疑難排解連結，涵蓋 Agent 365 開發生命週期的所有部分。

發佈命令失敗

徵狀：

  • 執行 a365 publish 時發生錯誤
  • 未建立 manifest.zip

根本原因：

  • 設定未完成
  • 資訊清單驗證錯誤
  • 權限不足

解決方案：

  1. 請確認設定已完成。

    Get-Content a365.generated.config.json | ConvertFrom-Json | Select-Object agentBlueprintId

  2. 執行發佈命令，並依照提示操作。

在系統管理中心上傳失敗

徵狀：

  • 在 Microsoft 365 系統管理中心上傳 manifest.zip 時發生錯誤
  • 上傳後 Agent 未出現

根本原因：

  • 系統管理中心中的權限不足
  • manifest.zip 無效或已過期

解決方案：

  1. 請確認您具備全域系統管理員角色。
  2. 再次執行 a365 publish，產生新的 manifest.zip。
  3. 請依照上傳步驟再次嘗試上傳。

如需進一步協助，請參閱將 Agent 上傳至 Microsoft 365 系統管理中心。

  • Last updated on