使用 Microsoft 365 Copilot 的新 API 建置 API 外掛程式

重要

MCP 和 API 外掛程式可在 宣告式代理程式內提供動作。 它們不是獨立的可安裝外掛程式套件:只有包含的代理程式才能存取其功能和工具。 如需套件與動作資訊清單關係的相關資訊,請參閱 外掛程式和宣告式代理程式動作。

秘訣

推薦項目: 從 Work IQ 開發工具 開始,支援專業程式碼宣告式代理程式和外掛程式案例。 請參閱 WIQD 快速入門。 工具組式指示仍然適用於需要工具組的指示的現有專案和工作流程。 在選擇工具之前,請先檢查 功能和目標體驗支援 : WIQD 不會以自訂引擎代理程式為目標。

API 外掛程式 可讓宣告式代理程式呼叫 REST API。 使用 Microsoft 365 代理程式工具組 產生代理程式專案、API 外掛程式資訊清單和 REST API 實作做為起點。

建立代理程式和 API

注意

本文中的螢幕擷取畫面和使用者介面參考使用 Microsoft 365 Agents Toolkit 的發行版本。 發行前版本可能與顯示的使用者介面不同。

  1. 開啟 Visual Studio Code。 如果尚未安裝 Agents Toolkit,請參閱 安裝 Agents Toolkit 以取得安裝指示。

  2. 選取左側活動列中的 Microsoft 365 代理程式工具組 圖示。

  3. 在 [代理程式工具組] 工作窗格中選取 [建立新的代理程式/應用程式 ]。

    Agents Toolkit 介面的螢幕擷取畫面

  4. 選取 宣告式代理程式。

  5. 選取 [新增動作],然後選取 [從新 API 開始]。

  6. 選取 OAuth 作為 驗證類型。

  7. 選取您慣用的程式語言: JavaScript 或 TypeScript。 本指南假設 TypeScript。

  8. 為代理專案選擇一個位置。

  9. 輸入 Repairs Agent 為您的代理專案名稱。

當您完成這些步驟時,Agents Toolkit 會產生代理程式和 API 專案檔案,包括 API 外掛程式資訊清單,並在新的 Visual Studio Code 視窗中開啟專案。 如需詳細資訊,請參閱產生專案根目錄中的 README.md 檔案。

執行 API 並側載代理程式

  1. 在載入代理程式專案的 Visual Studio Code 視窗中,選取左側活動列中的 Microsoft 365 代理程式工具組圖示。

  2. 在 [帳戶 ] 窗格中,選取 [ 登入 Microsoft 365]。 (如果您已經登入,請繼續進行下一個步驟) 。

  3. 確認 [ 已啟用自訂應用程式上傳] 和 [已啟用 Copilot 存取 ] 都顯示在您的 Microsoft 365 帳戶下。 如果沒有,請洽詢貴組織的系統管理員。如需詳細資訊,請參閱 Copilot 擴充性選項的需求 。

  4. 選取左側活動列中的 [ 執行和偵錯 ] 圖示。

  5. 選取 [ 在 Copilot (Edge) 中偵錯 ] 或 [在 Copilot (Chrome) 中偵錯 ],然後按 F5 開始偵錯。

Agents Toolkit 會建置專案、建立包含代理程式及其 API 外掛程式組態的應用程式套件,以及側載您的使用者帳戶的代理程式。 它也會在本機啟動 API。 Microsoft Teams 應用程式會開啟一個新的瀏覽器視窗。

測試代理程式的 API 動作

  1. 在瀏覽器中的 Microsoft Teams 中,選取 Copilot。

  2. 在右側的 [代理程式] 清單中選取 [ 修復 Agentlocal ]。 如果清單不可用,請選取右上角的 [Copilot 聊天和其他] 圖示。

  3. 傳送有關修復的訊息給 Copilot。 例如,嘗試 Which repairs are assigned to Karin?。

此時,REST API 正在開發電腦上本機執行,無需驗證。 若要新增驗證,請將 API 部署到 Azure。

部署至 Azure 並啟用驗證

  1. 選取左側活動列中的 Microsoft 365 代理程式工具組 圖示。

  2. 在 [ 生命週期 ] 窗格中,選取 [佈建]。

  3. 當要求提供資源群組名稱時,請接受預設值或視需要變更,然後按 Enter。

  4. 選取資源群組的位置。

  5. 檢閱對話方塊中的訊息。 如果一切正常,請選取 [ 佈建] 以繼續。

  6. 等待佈建步驟完成,然後選取 [生命週期] 窗格中的 [部署]。

完成這些步驟後,您會將 REST API 部署為具有驗證的 Azure Function。 代理程式會透過其 API 外掛程式設定呼叫該主控 API。

使用已驗證的 API 測試代理程式

  1. 在瀏覽器中的 Microsoft Teams 中,選取 Copilot。

  2. 在右側的 [代理程式] 清單中選取 [ 修復 Agentdev ]。

  3. 傳送有關修復的訊息給 Copilot。 例如,嘗試 Which repairs are assigned to Issac?。