Note
本文描述由 標準線束驅動的代理或代理流程中使用的功能。
代理程式會使用工具和知識代表使用者執行動作，並收集相關的內容資訊。 開發者通常將這些工具與知識來源儲存在外部系統中，如 Microsoft Dataverse、Microsoft SharePoint 或其他 API。 為了安全存取這些資源，代理者需要進行認證，以建立自己與外部系統之間的 連結 。 代理人可依情境使用代理作者認證或使用者驗證。
在 Microsoft Copilot Studio 中，你可以透過連線安全地存取經過認證的工具與知識服務。 你可以建立與各種資料來源的連結，例如 Microsoft Dataverse、Microsoft SharePoint 或外部 API。
檢視和管理代理連線
在 Copilot Studio 中，你可以在 Connection Settings頁面查看並設定代理所使用的連線。
在 連線設定 頁面，你可以設定和管理代理所使用的連線。 您可以查看現有連線、建立新連線，並視需要編輯或斷開連結。
在 [連線設定] 頁面上檢視連線
在 Copilot Studio 中選擇「代理人」，然後選擇你想查看的代理人，進入你的代理人頁面。
代理人總覽頁面將會開啟。
選取 [設定 ] 以開啟 [代理程序 設定 ] 頁面。
選擇 連線設定。
你會看到一個表格中的清單，裡面有所有與你的經紀人相關的連結。 對於每個連線，您可以查看：
- 連線名稱
- 使用連接技術的工具和知識來源
- 連線狀態
![代理程式設定下的 [連線設定] 頁面](media/authoring-connections/connection-settings.png)
連線狀態定義
連線狀態顯示連線目前的狀態。 存在幾種可能的狀態：
- 連線：連線為有效，代理可利用連線存取相關工具或知識。
- 未連接：沒有活躍連線。 代理人無法存取相關工具或知識。 你需要建立連結。
- 停用：連線被停用，可能是管理員所為，且客服目前未使用該連線。
- 過期：連線的認證憑證已過期且不再有效。 你需要重新認證連線，讓代理才能存取相關的工具或知識。
- 過時：連線不再有效或可用，通常是因為被中斷或逾時。你需要審查並更新或替換連線，讓客服人員才能存取相關工具或知識。
過濾連線
如果你的代理程式上有多個連線，請篩選清單，找出你想要使用的連線。 根據連線狀態，請使用不同篩選條件查看連線，例如 已啟用、 停用、 已連接、 未連接、 過期或 過時。
選擇或建立一個個別連結
在列表中的「 狀態 」連結條目中，選擇狀態旁的超連結以開啟 「建立」或選擇連接 面板。
選擇 ...... 以開啟 連線 設定。
從列表中選擇一個現有連線，或選擇 建立新連線 以建立新連線。
如果您選取 [ 建立新的連線]，就會開啟連線設定窗格。 如有需要，可能會提示您登入服務或提供更多資訊以完成連線設定。
完成後，選取 提交 以儲存變更。
你已設定連線，並將其與你的代理程式建立關聯。 你的經紀人可以利用這個連線來取得工具和知識。
查看詳細資訊並設定連線參數
在清單中的 [ 管理 ] 下，選取 [ 查看詳細數據 ] 以檢視連線的詳細數據。
資訊顯示於兩個分頁：
- 詳細數據：顯示連線名稱、描述、狀態和建立詳細數據。
- 線上參數：顯示連線參數，例如驗證詳細數據、API 金鑰或其他必要資訊，並可讓您設定詳細數據。
分享 On-Behalf-Of （OBO） 驗證的連線參數
若連線支援單一登入（SSO），你可以將連線設定為使用On-Behalf-Of（OBO）認證。 在 OBO 流程中，使用者委派代理代表使用者使用使用者與服務的連線參數。 當代理需要存取需要特定使用者權限的資源，或在使用者身份情境下執行動作時，此認證方法非常有用。
啟用 On-Behalf-Of（OBO）參數共享
在清單中的連線項 [ 連線參數 ] 下，您可以允許使用者授權共用特定的連線參數。
在 [ 聯機參數] 下，開啟 [ 允許共用參數的許可權]。
選擇您想讓使用者分享的參數的勾選框。
當代理程式使用 OBO 驗證時，系統會提示使用者授與這些參數的許可權。
On-Behalf-Of（OBO）認證的使用者體驗
當代理使用On-Behalf-Of（OBO）認證時，會提示使用者授權代理使用其連線參數。 用戶可以選擇允許或拒絕此許可權。 如果使用者允許，代理程式就可以存取資源，並代表使用者執行動作。 代理程式會使用共用連接參數，以透明方式連線到服務。
使用 OAuth 2.0 搭配 Microsoft 圖形 API 工具時，重複出現連線提示
Note
你可以分別為代理使用的不同認證連線請求使用者同意。 針對同一個有效連線反覆出現的提示，應另行調查。
使用 OAuth 2.0 認證時，每位使用者都必須登入並授權同意。 當你分享或架設代理時，其他使用者還沒同意，所以 Connect 卡片會顯示。
為避免重複提示，請嘗試以下驗證選項之一：
啟用 Microsoft Teams 單一登入 (SSO)，使用代理者 (OBO) 流程：使用者僅需在 Teams 中登入一次即可。 聊天室中不需要額外同意。
使用應用程式權限（服務主體）：後端透過應用程式憑證呼叫 Microsoft Graph。 不需要用戶同意。
使用通用的 OAuth SSO 給網路託管代理：你的應用程式負責登入並將憑證傳給代理。
授予管理員同意以委派範圍：移除每位使用者的權限提示。 仍需首次登入。
Note
- 如果你的通話需要使用者 專屬資料，請使用 SSO。
- 如果通話是 租戶全域，請使用應用程式權限。