共用方式為

部署與發佈代理

重要

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

你已經建立了代理程式並在本地測試——現在是時候讓它在雲端實現了。 部署並發布代理程式能讓它在整個組織中可用，讓團隊能透過 Microsoft 365 發現、聘用並互動。

本指南將引導你如何部署代理程式碼到 Azure，並將其發佈到 Microsoft 管理中心，讓它成為組織可發現的資產。

概觀

部署與發布流程包含兩個關鍵步驟：

  1. 部署 - 將您的代理部署到 Azure Web App
  2. 發佈 - 將您的代理程式發佈到 Microsoft 365 系統管理中心的代理商店

完成這些步驟後，您的代理程式將會出現在 Microsoft 管理中心，組織可以在那裡被發現並聘用。

先決條件

開始前，請先確保下列事項：

必要權限和存取權

  • 具有下列其中一個角色的 Microsoft Entra 使用者帳戶：
    • 全域系統管理員
    • 代理識別管理員
    • 代理 ID 開發者
  • 對 Azure 訂閱具有參與者存取權的使用者

必要工具

必要的設定步驟

在部署與發布前，請確保依序完成以下步驟：

  1. 已建立代理身份 - 完成註冊代理的所有步驟，以建立您的代理藍圖與實例
  2. 本地測試 代理程式 - 確認您的代理程式是否能正常運作於 Agents Playground（參見 本地測試代理程式）
  3. 組態檔案準備好 了 - 確保 a365.config.json 且 a365.generated.config.json 是最新的

步驟 1：部署到 Azure

這個 a365 deploy 指令 會將你的代理部署到設定時建立的 Azure Web App。 這會將您的代理程式碼上傳到 Azure，讓它能在雲端執行並處理來自 Microsoft 365 的請求。

部署代理程式

以下是部署命令：

a365 deploy

.NET 代理程式的部署指令：

  • 偵測 .NET 專案檔案（*.csproj、 *.fsproj、 或 *.vbproj）
  • 還原 NuGet 套件 dotnet restore
  • 發佈應用程式並使用 dotnet publish Release 設定
  • 建立帶有入口點 DLL 指令的 Oryx 清單（例如， dotnet YourApp.dll）
  • 根據偵測到的 .NET 版本配置 Azure 執行環境（預設： DOTNET|8.0）
  • 透過壓縮檔部署，並有即時進度

警告

秘密管理：部署時，環境變數（包括 API 金鑰和秘密）會儲存在 Azure 應用程式設定中。 雖然環境變數常用於設定，但它們是以純文字形式儲存的。 對於生產環境，Microsoft 建議使用 Azure 金鑰保存庫來管理敏感秘密。 欲了解更多資訊，請參閱 ASP.NET Core 與 Azure 金鑰保存庫 配置提供者中開發中應用程式秘密的安全儲存。 請將這些檔案視為敏感性資訊，並且永遠都不要將其認可至原始檔控制。

驗證部署

部署完成後：

  1. 在 Azure 入口網站中，瀏覽至您的 Web App。
  2. 在應用程式中，移至設定>進階設定。
  3. 請查看部署中心的部署日誌

步驟 2：發佈至 Microsoft 管理中心

此指令會a365 publish將您的代理程式發佈到 Microsoft 365 系統管理中心的代理商店，使其可被發現並安裝。 此最後一步，讓您的代理程式可供組織在其 Microsoft 365 環境中聘用與使用。

4.發佈代理程式

執行 publish 指令：

a365 publish

發行命令。

  • 從嵌入資源中擷取清單範本（如果 manifest 資料夾不存在）
  • 代理藍圖 ID 更新manifest.json
  • 暫停讓你自訂清單欄位（版本、名稱、描述、開發者資訊、圖示）
  • 套件應用程式組合包（manifest.zip）
  • 上傳至 Microsoft 365 系統管理中心的代理商店
  • 建立 Teams 整合的聯邦身份
  • 指派必要的圖權限

自訂清單

CLI 在發佈時會暫停，讓你可以自訂代理清單：

=== CUSTOMIZE YOUR AGENT MANIFEST ===

Your manifest has been updated at: [path]\manifest\manifest.json

When you're done customizing, type 'continue' (or 'c') and press Enter to proceed:

手動步驟：

  1. 在文字編輯器中開啟您的 manifest.json 檔案。
  2. 自訂必填欄位：
    • 更新版本號。 如果重新上傳，則會比之前的增加。
    • 設定有意義的代理人名稱。 名稱應等於或小於30個字元。
    • 寫清楚的描述
    • 開發人員資訊
    • 可選擇替換圖示檔案
  3. 更新資訊清單檔
  4. 回到 CLI 輸入 continue 或 c ，然後按 Enter。

測試你部署的代理

部署並發布代理程式後，你可以在 Microsoft 365 中測試，確保它在生產環境中正常運作。 部署完成後，您的代理程式可整合 Microsoft 365 服務，包括 Teams（聊天、頻道、會議）、電子郵件與行事曆（發送/接收、排程）、SharePoint 與 OneDrive（文件存取、檔案分享），以及協作工具（組織在場、規劃任務、文件註解）。

重要

代理型使用者需取得適當的 Microsoft 365 授權才能存取這些服務。 常見的授權包括 Microsoft 365 E5、Teams Enterprise 及 Microsoft 365 Copilot。

在管理中心查看已部署的代理程式

發佈後，您的代理會出現在 Microsoft 行政中心進行招聘。 可能需要一些時間才能擴散。

巡覽至 MIcrosoft 365 系統管理中心。

  • 查看您已出版的代理人
  • 管理應用程式設定
  • 監控代理程式使用情況
  • 設定權限

Teams 中的測試代理

部署並發布代理程式後，你可以直接在 Microsoft Teams 中測試：

  1. 開放開發者入口網站

    • 瀏覽至開發人員入口網站。
    • 請依姓名搜尋您的代理人
    • 如果您無法存取此入口網站，請聯絡您的租戶管理員

  2. 配置代理藍圖

    • 將代理類型設為基於機器人
    • 從你的a365 config display -g輸出設定機器人 ID（使用該值）agentBlueprintId
    • 儲存設定。

  3. 開始在 Teams 中使用

    • 使用 Microsoft Teams 開啟您的帳號
    • 開始與你新建立的代理用戶聊天
    • 發送測試訊息以驗證代理功能

  4. 範例測試訊息

    發送此訊息以測試電子郵件功能（必要時更新收件人電子郵件）：

    Send an email to recipient@contoso.com with subject "Hello from Teams" and message "This is a test message from my agent!"

    客服應該會處理申請並發送電子郵件，無需額外確認。

後續步驟

恭喜！ 您的客服人員現在已在雲端上線，並準備與 Microsoft 365 團隊一同工作。 最初作為地方代碼的系統，現在已成為一個可被發現、企業級可用的助理，且可在整個組織中聘用。

當您的經紀人處理現實需求時，請考慮以下步驟：

  • 監控效能：利用 可觀察性功能 追蹤代理行為並優化回應
  • 新增工具：探索 工具目錄 ，擴展經紀人的能力
  • 反覆改進：更新代理程式碼、重新部署並重新發布（記得增加版本號！）
  • 在整個組織內擴展：分享你代理人的成功故事，推動採用

您的代理從開發到部署的旅程已經完成——但其影響才剛剛開始。

相關內容

  • Last updated on