設定外掛程式的開發環境

在 準備期間,使用 選擇開發工具 中的開發計劃來設定外掛程式元件所需的環境、帳戶、工具、身分、權限、連線和服務。 您已完成已驗證的存取權和工具先決條件,因此您可以返回 建置或重複使用。

在建置、設定、擴充或重複使用元件之前,請先完成此設定。 當外掛程式結合代理程式、技能、連接器和 MCP 型功能時,您可能需要多個環境或工具。

從開發計劃開始

針對每個元件,請確認:

  • 開發工具和事實來源存放庫或受管理環境。
  • 開發或測試租用戶、環境、區域和目標 Microsoft 體驗。
  • 所需的產品授權、根據使用量計費、訂閱和服務方案。
  • 必要的系統管理員角色、應用程式註冊、身分識別、權限和同意。
  • 必要的資料來源、API、遠端服務、主機、網路存取和密碼。
  • 測試使用者和代表性非生產資料。
  • 負責提供每個相依性的擁有者。

不要以遺失存取權開始實作,或以無訊息方式取代不同的環境。 在開發計劃中將未解決的先決條件記錄為障礙。

Microsoft 365 Copilot Chat 是可供所有 Microsoft 365 使用者使用的廣泛存取 AI 聊天介面。 Copilot Chat 使用者可以存取擴充其功能的代理程式,並可以指示或 Web 為基礎。 已啟用Copilot Studio隨量付費 (作為 Copilot 點數) 使用的租用戶中的使用者,以及擁有 Microsoft 365 Copilot 授權的使用者,可以存取具有增強功能的代理程式,例如 SharePoint 資料基礎設置和Microsoft 365 Copilot連接器。

如需 Microsoft 365 Copilot 授權資訊,請參閱授權選項。

Copilot 開發環境

您有下列 Copilot 開發環境選項:

  • Microsoft 365 開發人員計畫沙箱訂閱。 符合開發人員訂閱資格的 Microsoft 365 開發人員計畫成員,可以使用其訂閱來開發代理程式。

    如果您選擇即時沙箱,您會獲得預先設定的 E5 開發人員環境,該環境會在幾分鐘內完成佈建,並預先載入範例使用者、Microsoft Teams 資料套件和預先設定的自訂應用程式。 即時沙箱選項已啟用附加元件購買。 您可以直接從沙箱內購買其他服務,包括 Microsoft 365 Copilot。 如需設定需求的詳細資訊,請參閱 設定 Microsoft 365 開發人員沙箱訂閱。

    如果您佈建可設定的沙箱,則訂閱不支援商務。 您無法購買 Copilot 授權,因此,當您選擇此選項時,就無法讓代理程式接地組織資料或新增其他功能。

    重要

    Microsoft 365 開發人員計畫的資格僅限於 Visual Studio Professional 或企業版訂閱者、ISV 成功計畫成員、符合Microsoft AI資格的雲端合作夥伴計畫 (MAICPP) 合作夥伴,以及頂級或統一支援客戶。

  • 符合資格的 Microsoft 365 或具有 Microsoft 365 Copilot 授權的 Office 365 生產環境。

    注意

    在生產環境中建置代理程式時,可能會遇到系統管理員施加的限制。 例如,系統管理員可以封鎖自訂應用程式側載,或可能不會授與建置 Copilot 連接器所需的必要權限。

  • 若您想要組建和測試功能有限的 Microsoft 365 Copilot Chat 代理程式,則不包含 Copilot 授權的 Microsoft 365 訂閱,例如 Microsoft 365 商務基本版。

您也可以購買 Microsoft 365 Copilot 授權,並設定獨立於生產環境的開發環境,在這裡您可以成為自己的系統管理員。

具有 Microsoft 365 Copilot 授權的組織

您可以使用 Microsoft 365 Copilot 授權直接在 Microsoft 365 生產環境中作業,以開發 Copilot 擴充性解決方案。

請連絡您的 Microsoft 代表,將 Copilot 新增至您的 Microsoft 方案。 企業客戶必須使用目前通道或每月企業通道,Microsoft 365 應用程式才能存取 Copilot。

沒有 Microsoft 365 Copilot 授權的組織

您可以為沒有 Copilot 授權的組織使用者開發 Copilot 擴充性解決方案,但您的代理程式功能有一些限制。 如果您想要利用代理程式功能,例如以組織資料為基礎,您可以啟用Copilot Studio Copilot 點數 (隨用付費計費) 。

Copilot 擴充性選項的需求

您可以使用外部服務和資料的智慧,以數種方式擴充 Microsoft 365 Copilot:

若要深入瞭解並為使用者選擇最佳的擴充性路徑,請參閱 Copilot 擴充性規劃指南 和 代理程式概觀。

代理程式的需求

若要建置代理程式,您必須根據選擇使用的工具來完成先決條件。

注意

某些代理程式功能僅適用於已啟用Copilot Studio隨用隨付計費的租用戶中的使用者 (作為 Copilot 點數使用) ,或擁有 Microsoft 365 Copilot 授權的使用者。 例如,如果您想要建置以組織資料為基礎的代理程式,您必須啟用隨用隨付計費,或購買 Microsoft 365 Copilot 授權。

工作 IQ 開發工具需求

Work IQ 開發工具 已正式推出,而且是支援的宣告式代理程式和外掛程式案例的預設專業開發人員路由。 首先審查為您的 插件選擇開發工具,然後僅在場景需要時才添加 Toolkit 或其他特定於組件的工具。 確認:

  • Node.js 24.15 或更新版本,以及用於 CLI 和安裝指令碼執行的 npm PATH 。 安裝程式不會安裝 Node.js。 這些不只是為了開始交談式或檔案型編寫所必需。
  • Windows 上的 PowerShell 7 或更新版本。
  • 可存取 Copilot 的 Microsoft 365 帳戶。
  • 選取的案例佈建 Azure 資源時,為 Azure 訂閱。
  • 允許必要的自訂應用程式安裝、共用或目錄動作的開發或測試租用戶。

安裝指令碼會安裝 WIQD CLI、其選用的 Visual Studio Code 擴充功能,以及用於偵測到之支援主機的公用 WIQD 編碼助理外掛程式,除非您略過這些整合。 它不會安裝主機。 您可以改為從其市集安裝編碼助理外掛程式,但這不會安裝 CLI。 安裝之後,啟動新的主機工作階段。 請參閱安裝適用於 GitHub Copilot CLI 和 Claude 程式碼設定的 Work IQ 開發工具。

驗證:wiqd --version啟動並wiqd doctor報告所需元件的狀態。 解決報告的錯誤。 對於租用戶佈建,請在 wiqd auth login --interactive 繼續之前執行並確認預期的帳戶和租用戶 wiqd auth status 。 遵循 Work IQ 開發工具驗證。

若要持續整合,請針對支援的核心生命週期命令使用記載的受信任管線驗證。 不要在管線中執行 wiqd auth login 或將認證公開給不受信任的提取要求作業。 Work IQ 監控、評估和其他擴充功能有個別的驗證需求。 請參閱 CI/CD 驗證。

Microsoft 365 代理程式工具組需求

這些需求適用於保留的工具組型逐步解說。 對於新支援的宣告式代理程式和外掛程式專案,請從 Work IQ 開發工具開始。

您可以使用 Microsoft 365 代理程式工具組來建立沒有 Microsoft 365 Copilot 授權的代理程式。 如果您想要建置以組織資料為基礎的代理程式,您必須在租用戶中設定隨用隨付計費,或購買 Microsoft 365 Copilot 授權。

若要使用 Agents Toolkit 和其他 IDE 建置代理程式,您必須讓系統管理員能夠側載 自訂應用程式 至您的租用戶。

若要啟用側載,請從 Teams 系統管理中心選取 Teams 應用程式>設定原則>全域 (全組織預設) ,然後將上傳自訂應用程式切換為開啟。

驗證:您的系統管理員確認原則適用於開發帳戶和預期的測試案例。

在 Teams 系統管理中心中啟用 [上傳自訂應用程式] 切換的全組織設定原則螢幕擷取畫面

若要從 Teams 用戶端管理側載自訂應用程式,包括代理程式,請移至 [應用程式>] [管理您的應用程式]。

Copilot Studio 需求

Copilot Studio 可供所有 Microsoft 365 使用者使用。 您可以使用 Copilot Studio 來建立代理程式和動作。 如果您想要透過 SharePoint 或 Copilot 連接器建置以組織資料為基礎的代理程式,您必須在租用戶中設定隨用隨付計費,或購買 Copilot Studio 授權。 如需詳細資訊,請參閱 計費費率和管理。

使用 Copilot Studio 建立代理程式需要執行下列步驟:

驗證:選取的 Copilot Studio 環境、撰寫存取權、頻道必要條件和必要的連接器可供測試帳戶使用。 獨立 Copilot Studio 代理程式會顯示在代理程式登錄中,而不是外掛程式中。

啟用開發人員模式

您可以使用 Copilot 中的 開發人員模式 來測試協調器是否及如何選取您的外掛程式以回應指定的提示。

若要啟用開發人員模式,請在 Copilot Chat 中輸入-developer on。 若要停用開發人員模式,請輸入 -developer off。

驗證:授權的 Copilot 體驗會報告開發人員模式已依照要求啟用或停用。 此診斷不會在其他體驗中建立外掛程式探索或安裝。

'Microsoft 365 Copilot' 工作階段的螢幕擷取畫面,使用者已輸入 '-developer on' 以成功啟用開發人員模式

開發人員模式僅適用於授權的 Microsoft 365 Copilot 體驗。 在 元件整合測試期間使用它。 如需詳細資訊,請參閱 偵錯代理程式。

Microsoft 365 Copilot 開發人員授權

用來測試以組織資料為基礎或包含增強功能的代理程式的帳戶需要 Microsoft 365 Copilot 開發人員授權。 系統管理員可以在Microsoft 365 系統管理中心 (中的 [帳單>授權]) 下管理 Microsoft 365 Copilot 開發人員授權。 您也可以 使用 PowerShell 將 Microsoft 365 授權指派給使用者帳戶。

代理程式功能和授權模型

Copilot 代理程式可透過多種授權模式使用,每種模式都提供不同層級的功能:

  • 具有 Microsoft 365 Copilot 附加元件授權的 Microsoft 365 - 擁有 Microsoft 365 訂閱和 Copilot 附加元件授權的使用者可以在支援的應用程式和平台上完整存取 Copilot 代理程式體驗。
  • Microsoft 365 Copilot Business - 專為中小型企業推出的獨立 SKU。 提供符合 Microsoft 365 商務版方案的 Copilot 代理程式存取權。
  • Microsoft 365 E7 (Frontier Suite) - 為企業客戶提供Microsoft 365 E5、Microsoft 365 Copilot和Agent 365功能的搭售方案。
  • 根據使用量計費 (隨用隨付) - 租用戶可以在沒有完整授權的情況下啟用代理程式存取權,但代理程式設定選項有一些限制。 消耗量以 Copilot 點數為單位測量。
  • 沒有 Copilot 附加元件授權的 Microsoft 365 - 使用者可能會在某些應用程式中看到 Copilot Chat 進入點,但根據租用戶設定,對代理程式體驗的存取權會受到限制或停用。

下表摘要列出根據使用者授權類型的代理存取權。

授權模式 代理程式存取
授權的使用者 同時擁有 Microsoft 365 訂閱和 Copilot 附加元件授權 (,包括 Microsoft 365 Copilot Business 和 E7 Frontier 套件 (如適用) )。 他們可以在支援的應用程式和平台上完整存取 Copilot Chat 和代理程式體驗。 此授權也可讓您使用以租用戶資料為基礎的代理程式, (SharePoint、Microsoft Graph) ,而且這是在 Copilot Studio 中撰寫代理程式的必要條件。
依使用量計費 (依量付費的使用者) 屬於已啟用隨用隨付計費的租用戶, (以 Copilot 點數) 使用。 使用者可以在沒有完整 Copilot Chat 授權的情況下存取 Copilot Chat 和代理程式。 使用計費適用於以租用戶資料為基礎的代理程式,而以公用資料或指示為基礎的代理程式則可免費使用。 某些進階功能 - 例如客服專員互動或基礎設置 - 可能需要額外的設定。 需要在 Microsoft 365 系統管理中心設定 Azure 訂閱和計費原則。 對於使用 SharePoint 檔案做為知識來源的代理程式,計費原則必須 連線至 SharePoint 代理程式服務 ,而且使用者必須位於 指派給計費原則的安全性群組中。
沒有 Copilot 附加元件授權的 Microsoft 365 訂閱者 可能會在某些應用程式中看到 Copilot Chat 進入點,但存取權會受到限制或停用,這取決於租用戶設定和推出狀態。 這些使用者無法存取代理程式製作或進階代理程式體驗。

下表列出了根據租用戶中的授權和使用計費組態可供使用者使用的代理程式類型和代理程式功能。 如需使用費率的相關資訊,請參閱 計費費率和管理。

注意

Microsoft 365 政府社群雲端高 (GCCH) 和政府社群雲端 (GCC) 環境中不支援使用量計費。

功能 Copilot Chat (無依使用量計費) * Copilot Chat (根據使用量計費的) ** Microsoft 365 Copilot (授權)
Microsoft 365 Copilot ✅ ✅ ✅
Copilot Studio ✅ ✅ ✅
宣告式代理程式
     自訂動作 ✅ ✅ ✅
     自訂指示 ✅ ✅ ✅
     程式碼解譯器 ✅ ✅ ✅
     影像產生器 ✅ ✅ ✅
     MCP 應用程式
(互動式 UI 小工具)
✅ ✅ ✅
     自訂知識:
Web 搜尋
✅ ✅ ✅
     自訂知識:
範圍 Web 搜尋
✅ ✅ ✅
     自訂知識:
Copilot 連接器
❌ ✅ ✅
     自訂知識:
SharePoint 資料
❌ ✅ ✅
     自訂知識:
內嵌檔案內容
❌ ✅ ✅
     自訂知識:
Dataverse
❌ ✅ ✅
     自訂知識:
Email
❌ ❌ ✅
     自訂知識:
People
❌ ❌ ✅
     自訂知識:
Teams 訊息
❌ ❌ ✅
     自訂知識:
Teams 會議
❌ ❌ ✅
自訂引擎代理程式 ✅ ✅ ✅

* 使用限制適用於所有包含的功能。

** 存取可供使用者使用之知識來源,而不需要依使用量計費,因此不會產生任何費用。

注意

如需 Microsoft 365 Copilot Chat 和 Microsoft 365 Copilot 中 Web 搜尋的資料、隱私權和安全性的詳細資訊,請參閱 Web 搜尋的資料、隱私權和安全性。

注意

以共用租用戶工作資料為基礎的代理程式目前無法在 Microsoft 365 政府社群雲端 (GCC) 、政府社群雲端高 (GCCH) 或美國國防部 (DoD) 環境中使用。

常見問題集

我可以使用 Microsoft 365 開發人員計畫訂閱來使用 Copilot 進行開發嗎?

是的,您可以使用 Microsoft 365 開發人員計畫訂閱來建置代理程式。 如果您佈建即時沙箱,則會啟用附加元件購買。 您可以直接從沙箱內購買其他服務,包括 Microsoft 365 Copilot。 此選項可讓您建置以組織資料為基礎的代理程式,並存取其他增強功能。 如果您佈建可設定的沙箱,訂閱就不支援商務,因此您無法購買 Microsoft 365 Copilot 授權或啟用隨用隨付計費。 代理程式功能僅限於 Web 搜尋基礎設置。 如需詳細資訊,請參閱 設定 Microsoft 365 開發人員沙箱訂閱。

我不是 ISV,也沒有 Microsoft 365 Copilot 授權。 我可以取得 Microsoft 365 Copilot 開發環境嗎?

如果您有 Microsoft 365 訂閱,您可以在 Microsoft 365 Copilot Chat 中組建和測試代理程式,但功能有限。 如果您想要建置以組織資料為基礎的代理程式,您必須在租用戶中啟用隨用隨付計費,或購買 Microsoft 365 Copilot 授權。

確認環境整備

在下列情況下,您的環境已準備就緒:

  • 每個選定的開發工具都可供預期的貢獻者使用。
  • 開發或測試租用戶和目標 Microsoft 體驗是可存取的。
  • 已設定必要的授權、計費、訂用帳戶、環境和區域。
  • 應用程式身分、角色、權限、同意、連線和密碼都可用。
  • 必要的資料來源、API、遠端服務和裝載環境都是可連線的。
  • 可以使用測試使用者和代表性的非生產資料。
  • 每個相依性都有一個擁有者,並會記錄未解決的封鎖程式。

安全性及隱私權

Copilot 會使用現有的權限和原則來提供最相關的資訊,以我們對企業資料安全性和資料隱私權的現有承諾為基礎。 如需 Copilot 如何使用及保護組織資料的相關資訊,請參閱 Microsoft 365 Copilot 的資料、隱私權和安全性。 如需開發不同 Copilot 擴充性解決方案的資料隱私權和安全性考量,請參閱延伸 Microsoft 365 Copilot 的資料、隱私權和安全性考量。

後續步驟

輸入 [組建或重複使用] 搭配外掛程式的建置或重複使用功能。 如果您選取了 Work IQ 開發工具,請根據您的起點繼續使用 現有代理程式快速入門 或 建立新的外掛程式。