手動將代理程式部署至 Azure

在 Azure 上執行 Microsoft 365 Agents SDK Agent 需遵循以下步驟：

• 建立並設定 Agent
• 配置一個 Azure Bot 資源並設定該資源的認證
• 將你的代理部署到 Azure
• 可選擇將您的代理部署到 Teams 或 Microsoft Copilot

本文件涵蓋如何部署你建立的代理程式到 Azure 和 Teams 或 Microsoft Copilot。

如果你還沒建立代理，建議先從 Quickstart 開始：用 C# 建立並測試一個基本代理。

將你的代理發佈到 Azure 作為網頁應用程式

1. 把你的代理程式部署到 Azure。 Agents SDK 代理是一種網頁應用程式。 發佈 Agent 時，可採用常規部署網頁應用程式至 Azure 的方法：

   • 將 ZIP 套件部署至 Azure App 服務 應用程式
   • 使用 Visual Studio 發佈至 Azure App 服務 應用程式或容器
   • Azure 支援的其他容器部署方式
   • Microsoft 365 Agent 工具包部署

Agent 程式碼部署完成後，將產生基礎網址 (例如：example.azurewebsites.net)。

1. 於 Azure 中開啟您的 Azure Bot 資源。 在設定區段中，將訊息傳送端點變更為：https://{yourwebsite}/api/messages。 請將 {yourwebsite} 替換為您的網頁應用程式基礎網址。

在網路聊天中測試

若要在網頁聊天中查看訊息，請於 Azure Bot 資源中選取網頁聊天測試，並向您的 Agent 發送訊息。

準備你的 Teams 與 Microsoft Copilot 清單

若要在 Microsoft Teams 和 Microsoft Copilot 中使用，您需要建立並上傳資訊清單。 無法提供涵蓋所有 Teams 或 Microsoft Copilot 需求的清單範例。 Teams 功能需特定資訊清單內容。

以下步驟概述基本「聊天」風格 Teams Agent 架構：

1. 在專案中建立空資料夾。
2. 將 Teams 資訊清單檔內容複製至該資料夾。
3. 在資料夾中開啟 manifest.json 並進行以下編輯：
   • 凡出現佔位符字串 <<AAD_APP_CLIENT_ID>> 之處，皆替換為您的 Azure Bot 資源對應的 ClientId。
   • 將 <<BOT_DOMAIN>> 替換為您的 Agent 基礎網址。
   • 將資料夾內容壓縮為 manifest.zip 檔案，內容如下：
     • manifest.json
     • outline.png
     • color.png

部署至 Microsoft 365

1. 請確保您的 Azure Bot 資源在「通道」下新增了 Microsoft Teams 頻道。

2. 流覽至 Microsoft 系統管理入口網站 （MAC）。

3. 於設定與整合應用程式中，選擇上傳自訂應用程式。

4. 選取前一節建立的 manifest.zip 檔案並上傳。

過了一段時間後，代理會出現在 Microsoft Teams 和 Microsoft Copilot 中。