Copilot Studio 讓您能透過技能擴展 Agent 功能。 若您的組織已針對特定情境建置並部署 Agent (使用 Microsoft 365 Agents SDK 或其他專業程式碼工具)，即可將這些機器人轉換為技能，並將該技能註冊至 Copilot Studio Agent 中。
注意
要在 Microsoft Teams 中的 Copilot Studio 應用程式內新增技能，您必須擁有 Microsoft Copilot Studio 獨立訂閱。
本文適用於系統管理員或熟悉 技能的 IT 專業人員。
將技能註冊至 Copilot Studio Agent 後，即可在交談中流暢觸發技能動作。
先決條件
重要
Copilot Studio Agent 僅支援使用舊版 Bot Framework SDK 4.12.0+ 及 Microsoft 365 Agents SDK v1.0.0+ 建立的技能。 新技能應採用 Microsoft 365 Agents SDK 進行開發。
設定技能時，請於 Microsoft Entra ID 中將技能關聯的應用程式註冊設定為單租用戶設定。
何時使用 Agent 流程與技能
下表協助您判斷何時使用 Agent 流程技能進行交談。
| 因素 | 使用 Agent 流程時機 | 使用技能時機 |
|---|---|---|
| 角色 | Agent 作者可以建立可重複使用的流程以嵌入到任何 Agent 交談中。 | 開發人員可以在自己的環境中建立、部署和託管自訂技能。 |
| 交談類型 | 使用流程進行簡單的單轉動作。 例如，下訂單或取得訂單狀態。 | 使用技能進行複雜的多輪作業。 例如，排程召開會議或預訂航班。 |
| 回應 | 使用流程來發出 Agent 回應。 例如，顯示個人化訊息或內嵌影像。 | 使用技能來發出任何受支援的 Agent 回應。 例如，顯示調適型卡片或傳送隨機回覆。 |
| 動作 | 使用流程來觸發伺服器端的單轉動作。 例如，呼叫 HTTP API 或觸發自訂連接器。 | 使用技能來觸發伺服器端和用戶端事件和動作。 例如，在 Agent 回應時導覽到某個頁面。 |
設定 技能
首先，使用 Copilot Studio 建立一個 Agent ，並透過專業程式碼工具在您的組織中建立並部署技能。 請參考這些範例：
在註冊技能之前，請向您的技能開發人員提供 Agent 的 ID，以授權 Agent 呼叫技能中的動作。 深入了解技能允許清單。 您可以從新增技能視窗取得 Agent 的 ID。
若要為您的 Agent 新增技能：
移至您的 Agent。
選擇設定>技能前往技能頁面。
選取新增技能。
複製您的 Agent 編號。 您需要提供您的技能開發人員 Agent 編號。
輸入資訊清單的網址。 技能資訊清單包含 Agent 觸發技能內的動作所需的資訊。
選取下一步開始驗證程序。 驗證成功後，您的技能將被新增到您的 Agent 中。 您現在可以在主題中使用這項技能。
合規性考量
為了保護使用者的隱私權，我們需要將技能註冊為登入使用者的 Microsoft Entra ID 租用戶中的應用程式。
疑難排解技能註冊期間的錯誤
針對 URL 進行一系列驗證檢查。 這些檢查可確保新增到您的 Agent 的技能的合規性、治理性和可用性。 在註冊技能之前，您必須修復這些錯誤。
| 錯誤訊息 | 疑難排解/風險降低 |
|---|---|
| 取得技能資訊清單時遇到問題。 ( MANIFEST_FETCH_FAILED) |
嘗試在網頁瀏覽器中開啟您的資訊清單 URL。 如果 URL 在 10 秒內呈現頁面，請重新註冊您的技能。 |
| 資訊清單不相容。
( MANIFEST_MALFORMED) |
(a) 檢查資訊清單是否為有效的 JSON 檔案。
(b) 檢查資訊清單是否包含所需的屬性， 例如，, ( name、msaAppId、單一 endpoint、activities/id、activities/description、activities/type (僅 event 或 message 支援))。 |
| 您的端點不相符 ( MANIFEST_ENDPOINT_ORIGIN_MISMATCH) |
請檢查您的技能端點是否符合您 Microsoft Entra ID 的應用程式註冊 Publisher domain (偏好) 或 Home page URL 欄位。
深入了解有關設定端點的首頁。 |
| 若要新增某技能，您必須先為其註冊 ( APPID_NOT_IN_TENANT) |
檢查您的技能應用程式識別碼是否已在您組織的 Microsoft Entra ID 租用戶中註冊。 |
| 結無效；連結必須以 https:// 開頭 ( URL_MALFORMED、URL_NOT_HTTPS) |
修改連結以新增安全的網址。 |
| 資訊清單太大； ( MANIFEST_TOO_LARGE) |
檢查資訊清單的大小。 必須小於或等於 500KB。 |
| 此技能已新增至您的 Agent。
( MANIFEST_ALREADY_IMPORTED) |
請刪除技能，然後再試一次註冊。 |
| 技能受限於 100 個動作。
( LIMITS_TOO_MANY_ACTIONS) |
技能資訊清單中定義的技能動作太多。 請移除動作，然後再試一次。 |
| 動作限制為 25 個輸入。
( LIMITS_TOO_MANY_INPUTS) |
有太多技能動作輸入參數。 請移除參數，然後再試一次。 |
| 動作限制為 25 個輸出。
( LIMITS_TOO_MANY_OUTPUTS) |
有太多技能動作輸出參數。 請移除參數，然後再試一次。 |
| 您的 Agent 最多可以擁有 100 項技能。
( LIMITS_TOO_MANY_SKILLS) |
Agent 中新增的技能太多。 請移除現有的技能，然後再試一次。 |
| 似乎發生錯誤。 ( AADERROR_OTHER) |
驗證您的技能時發生暫時性錯誤。 重試。 |
| 檢查技能時發生錯誤。
( ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED) |
檢查您的技能端點是否已上線，並回應訊息。 也請檢查單一租用戶技能的應用程式註冊是否部署到同一個租用戶。 |
| 此技能尚未將您的 Agent 列入允許名單 ( ENDPOINT_HEALTHCHECK_UNAUTHORIZED) |
檢查您的 Agent 是否已新增至技能允許清單。 |