共用和管理 Agent Builder 內建的代理程式

您可以與組織中的使用者共用您在 Agent Builder 中建立的代理程式。 代理程式支援多個擁有者,因此您可以在整個團隊中共用擁有權。 任何擁有者都可以編輯、管理和維護代理程式。 共用代理程式可為一組指定的使用者直接存取代理程式。 雖然共用代理程式非常適合團隊共同作業,但無法在整個組織內部署或與其他管道整合。

本文說明如何共用和管理您在 Agent Builder 中建置的代理程式。 若要跨多個管道發佈代理程式,您必須使用 Copilot Studio。 如需詳細資訊,請參閱 發佈和部署您的代理程式。

共用代理程式

在 Microsoft 365 Copilot 中建立並測試代理程式之後,請選取 [建立]。 建立代理程式之後,系統會顯示一則確認訊息,指出該代理程式是私人的,只有您才能使用。 若要與其他人共用代理程式,請選取 [共用] 以開啟共用對話方塊。

從 [所有代理程式] 清單共用代理程式

[共用] 對話方塊會列出具有存取權的每個人、其角色、全組織共用切換開關,以及您可以隨時複製的連結。

注意

您的系統管理員可能會套用限制特定代理程式共用選項的原則。 這些變更不會自動撤銷現有的客服專員存取權限。 停用全組織共用並不會防止與特定個人直接共用。 發佈到您的組織目錄需要系統管理員核准。 如果治理政策變更,請在更新代理之前更新代理的共用選項以符合規範。

了解角色

[共用] 對話方塊使用兩個存取層級。

角色 描述 可以聊天 可以編輯和管理
可以編輯 擁有者 — 編輯、共用和管理代理程式的完整權限。 是 是
可以聊天 Chat 使用者 — 只能與代理程式互動。 是 否

擁有者是具有 [可以編輯 ] 存取權的任何人。 所有擁有者都擁有平等的權利,包括新增或移除人員、切換角色,以及開啟全組織共用。

注意

您無法將群組新增為擁有者。 當您新增群組時,它只能是聊天使用者 (可以聊天) 。 若要授與擁有者權限,請新增個別使用者。

新增擁有者和聊天使用者

  1. 開啟您要共用的代理程式,然後選取 [共用]。
  2. 在共用對話方塊中,在 [新增名稱、群組或電子郵件 ] 方塊中輸入名稱、群組或電子郵件。
  3. 在 [新增人員 ] 面板上,為您要新增的人員設定角色:
    • 選擇 [可以編輯 ] ,將他們新增為具有完整編輯和管理權限的擁有者。
    • 選擇可以 聊天 ,將他們新增為只能與客服專員互動的聊天使用者。
  4. 讓 [傳送通知 ] 核取方塊保持選取狀態,以傳送電子郵件給新使用者,讓他們知道他們擁有存取權。 如果您不想傳送電子郵件,請清除核取方塊。
  5. 選取 [新增]。

[新增人員] 面板

共用完成後,您會收到確認訊息,並可以複製聊天連結以直接共用。

注意

代理功能會根據使用者的授權而有所不同。 使用者只有在擁有存取該代理程式中設定的功能所需的 Microsoft 365 Copilot 授權類型時,才能新增與其共用的代理程式。 如果使用者沒有代理程式功能的適當授權,嘗試使用代理程式可能會導致錯誤。 如需詳細資料,請參閱 適用於 Microsoft 365 使用者的 Agent 功能。

切換使用者的角色

身為擁有者,您可以隨時變更任何共用使用者的角色。

  1. 開啟 [ 共用 ] 對話方塊。
  2. 選取使用者旁邊的角色下拉式清單。
  3. 選擇新的選項:
    • 可以編輯 - 將使用者升級為具有完整權限的擁有者。
    • 可以聊天 - 將使用者變更為聊天使用者。
    • 移除 - 撤銷使用者的存取權。

變更會立即生效。

[新增角色] 下拉式清單

[共用] 對話方塊會顯示連結,讓您可以共用存取權,而不需要離開:

  • Chat 連結 - 適用於只需要與代理程式互動的聊天使用者。
  • 編輯連結 - 適用於需要撰寫和管理代理程式的擁有者。

選取 複製聊天連結 或選取編輯 連結,然後將它貼到電子郵件、聊天或文件中。

啟用全組織共用

若要讓租用戶中的每個人都能使用代理程式,請開啟全組織共用以取得聊天存取權。

  1. 開啟 [ 共用 ] 對話方塊。
  2. 開啟 [在全組織共用聊天存取權 ] 切換開關。

若要在代理程式存放區中發行經過系統管理員審查的出版物, 請將您的代理程式提交至您的組織目錄。 共用和目錄提交是不同的路徑。

控管與系統管理控制項

啟用代理程式時,在代理程式產生器中建立代理程式是 Copilot 的核心功能。 系統管理員無法在保持代理程式啟用的同時,個別停用 Agent Builder 中的代理程式建立。

Agent Builder 內建的代理程式會針對特定工作,使用指示和選取的知識來源來自訂 Copilot。 它不會引進 Copilot 以外的新平台功能。 建立代理程式本身並不會授與額外的資料權限。 但是,所有者仍然需要查看他們共享的內容,包括任何上傳的知識。

系統管理員可以控制對代理程式的存取、全組織共用和目錄發佈的核准:

  • 代理程式存取:在 Microsoft 365 系統管理中心,移至 [代理程式>設定>] 使用者存取權。 選擇 所有使用者、 無使用者或 特定使用者或群組 ,以控制誰可以存取和安裝代理程式和外掛程式。 此設定會控制代理程式和外掛程式存取權,而不是獨立建立代理程式建置器。 如需詳細資料,請參閱 使用者存取。
  • 全組織共用:在代理程式>設定>共用中,控制誰可以與組織共用 Agent Builder 內建的代理程式。
  • 目錄發佈: 新的代理程式在共用或發佈之前,對其建立者來說是私人的。 將代理發佈到您的組織目錄需要管理員審查和核准。 如需詳細資料,請參閱 將代理程式提交至您的組織目錄。

針對全組織共用,系統管理員可以設定下列其中一個選項:

  • 所有使用者 (預設) : 每個人都可以與組織共用代理程式。
  • 特定使用者或群組: 將整個組織的共用權限限制為選取的使用者或群組。
  • 沒有使用者: 停用全組織共用。 使用者仍然可以直接與特定人員共用。

注意

共用設定的變更僅適用於新的共用動作。 除非您手動更新其共用設定,否則現有共用代理程式仍可存取。

停用全組織共用時, 聊天存取權的 [全組織共用 ] 切換會呈現灰色,並附有說明限制的工具提示。 如需詳細資料,請參閱 共用設定。 此設定僅適用 Agent Builder 內建的代理程式。

代理程式的存取權和知識來源的存取權是不同的:

  • SharePoint 和 OneDrive 來源: 現有的檔案權限和敏感度標籤適用。 僅共用代理程式並不會授予對其所有來源內容的存取權。 如果擁有者有權限,他們可以個別共用選取的 SharePoint 檔案和資料夾。 如需詳細資料,請參閱 自動共用 SharePoint 檔案和資料夾。
  • 上傳的檔案:從裝置上傳的 Files 成為嵌入式知識。 任何可以存取代理程式的人都可以收到以該內容為基礎的回應,但須遵守內嵌內容的敏感度標籤權限。 共用代理程式之前,請先檢閱上傳的內容。 如需詳細資料,請參閱 內嵌檔案內容。

下載 ZIP 套件以側載您的代理程式

Microsoft 365 Copilot 提供下載 ZIP 套件以進行手動側載的選項。 此 ZIP 套件包含將 代理程式側載到 Microsoft Teams 中所需的檔案。

若要下載 ZIP 套件並手動側載您的代理程式:

  1. 在 Microsoft 365 Copilot 的左側窗格中,選取 [新增代理程式]。
  2. 在 [New agent] 頁面的 [My agents] 底下,選擇 [View all agents] (檢視所有代理程式)。 [新增代理程式] 頁面上 [檢視所有代理程式] 選項的螢幕擷取畫面。
  3. 選取您要下載的代理程式,然後選擇省略符號 (...) 。
  4. 選擇 下載 .zip 檔案。 .zip 檔案包含代理程式資訊清單和應用程式圖示。 *下載 .zip 檔案* 選項的螢幕擷取畫面
  5. 將您的代理程式側載到 Microsoft Teams。

注意

  • ZIP 套件不能包含內嵌檔案。 從 ZIP 套件移除任何內嵌檔案內容。
  • macOS 不支援在 Teams 中側載代理程式。

自動共用 SharePoint 檔案和資料夾

當您共用代理程式時,Copilot 使用者可能無法存取所有基礎知識來源。 當您將其他人新增為聊天使用者或擁有者時,您可以與其他人共用 SharePoint 知識來源。 不過,代理程式會尊重使用者的資訊和敏感度權限。 因此,如果使用者無權存取知識來源,代理程式在產生回應時就不會包含知識來源所包含的內容。

您可以選取要共用的 SharePoint 資料夾和檔案。 只有當代理的擁有者已具有共用或更新共用權限的權限時,共用才能運作。 遵守套用至 SharePoint 或 OneDrive 中檔案的檔案敏感度標籤。 如果檔案或資料夾的共用失敗,代理程式仍會與使用者共用。 擁有者必須連絡檔案擁有者或 SharePoint 網站系統管理員,以直接從 SharePoint 授與檔案或資料夾的權限。

注意

只有您專門新增至代理程式的檔案和資料夾才能自動共用。 您共用 Agent 的人員不會自動擁有 SharePoint 網站的完整存取權。 網站管理員必須透過網站設定授與使用者權限。

移除使用者對代理程式的存取權時,不會影響他們對共用檔案或資料夾的存取權。 管理使用者權限,以直接透過 SharePoint 存取檔案和資料夾。

更新代理程式的 [關於] 資訊

使用 [關於此代理程式] 對話方塊來更新在 Microsoft 365 Copilot 中客服專員市集和客服專員的 [關於] 資訊中可見的中繼資料。 您可以為您擁有的任何代理程式開啟此對話方塊,無論它是否共用或發佈到您的組織目錄。

若要開啟對話方塊,請在代理程式撰寫標題中選取 [ 其他 省略號] ([ ...]) ,然後選取 [關於此代理程式]。

以下是可用欄位。

欄位 必要或選用 最大長度 描述
簡短描述 必要 80 個字元 客服專員工作的簡明摘要。 會顯示在代理程式存放區和代理程式的 [關於] 資訊中。 預設值:使用 Microsoft 365 Copilot Agent Builder 建立。
創作者網站 選擇性 2,048 個字元 可連至關於您或您的團隊的詳細資訊的連結,例如您的設定檔頁面、您團隊的 SharePoint 網站或內部支援頁面。 當使用者在代理程式詳細資料窗格中選取建立者名稱時開啟。 必須是有效的 HTTPS URL。
隱私權聲明 選擇性 2,048 個字元 貴組織隱私權聲明的連結。 必須是有效的 HTTPS URL。
使用規定 選擇性 2,048 個字元 貴組織使用條款的連結。 必須是有效的 HTTPS URL。

為 創作者網站、 隱私權聲明和 使用條款提供了預設預留位置 URL。 將每個預留位置取代為適合您客服專員的 URL;否則,Agent Builder 會在欄位上顯示警告。

注意

當您將代理程式提交至組織目錄時,您儲存在 [關於此代理程式 ] 中的值會預先填入 [ 提交至您的組織目錄 ] 對話方塊中的對應欄位。 如需詳細資訊,請參閱 Agent Builder 中代理程式的隱私權聲明和使用條款。

將代理程式提交至您的組織目錄

您的客服專員的共用版本和客服專員商店版本是分開管理的。 您可以管理共用版本,並可以隨時繼續反覆運算、變更共用版本的對象,或將其保留為私密以供測試。 在您發佈代理程式之後,您的系統管理員會管理代理程式存放區版本。

若要讓您的代理程式在組織中廣泛可探索,請將其發佈到您的組織目錄。 系統管理員會在 Microsoft 365 系統管理中心檢閱代理程式,如果核准,則會將代理程式部署到代理程式存放區的 [由您的組織建立] 區段。

如需提交步驟、必填欄位、核准狀態追蹤和核准後更新,請參閱將 代理程式從代理程式建立器提交到您的組織目錄。

管理代理程式

您可以存取 Microsoft 365 Copilot 中的代理程式管理功能:

若要管理您最近存取的代理程式,請在左側窗格中,選取您要管理的代理程式名稱旁的 [ 其他 省略號] (...) 。

若要管理您最近未存取的代理程式,請執行下列任一動作:

  • 在左窗格中選取 [所有代理程式 ]。
  • 在 客服專員商店的 [ 您的客服專員] 底下,選擇 [ 查看更多 ],然後選取您要管理的客服專員名稱旁 (...) 的省略號。

或:

  • 選取左側窗格中的 [新增代理程式],然後選擇 [檢視所有代理程式]。
  • 選取 [ 其他 省略號] (...) 位於您要管理之代理程式名稱旁。

注意

在客服專員建立器中, 「我的客服專員」 清單僅包含您擁有的客服專員或您具有「 可以編輯 」存取權的客服專員。 以聊天使用者身分與您共用的代理程式不會顯示在此清單中。

編輯代理程式

如果共用後需要變更,代理的任何擁有者都可以編輯它。

  • 使用管理 代理程式中所述的方法之一存取代理程式清單。
  • 從 [其他省略號 () ] 功能表中選擇 [編輯] (鉛筆圖示) 。

從那裡,您可以使用自然語言來描述您的變更。 您也可以使用 [設定 ] 索引標籤,對客服專員的功能和知識來源進行更微調的控制。

對代理所做的變更會自動儲存。 不過,除非您提供變更,否則使用者不會看到您的變更。 若要使現有代理程式的變更可用,請選擇右上角的 [更新 ]。 您的變更可能需要幾分鐘的時間才能提供給使用者。

注意

如果您更新先前共用的代理程式具有 SharePoint 檔案和資料夾知識來源,請將其重新與相同的使用者共用。 這樣做會自動再次與使用者共用檔案和資料夾,以確保一致的代理體驗。

刪除您的代理程式

代理的任何擁有者都可以刪除它。 刪除代理程式之後,您將無法使用它,其他擁有者或您與之共用代理程式的使用者也無法使用。

重要

刪除代理程式是永久性的,無法復原。

若要刪除代理程式:

  • 使用管理 代理程式中所述的方法之一存取代理程式清單。
  • 選取 [ 其他 省略號] () 功能表,然後選擇 [ 刪除 ] ([垃圾桶] 圖示) 。

重新指派代理程式的擁有權

您可以透過在共用對話方塊中新增具有可以 編輯 角色的使用者來直接共用客服專員的所有權。 所有擁有者都擁有編輯、共用和管理代理程式的平等權利。 如需詳細資訊,請參閱 新增擁有者和聊天使用者。

管理員也可以更新組織內共用代理程式的擁有者。 如需詳細資訊,請參閱 重新指派共用代理程式的擁有權。

疑難排解

共用代理程式及其知識來源時,您可能會遇到下表中列出的錯誤。

問題 描述
發生錯誤 發生內部服務錯誤。 如果此錯誤持續發生,請連絡支援人員。
無法共用 使用者的權限不足,無法更新特定檔案的共用權限。 錯誤會列出無法共用的檔案。 代理程式擁有者應該進入 SharePoint 以嘗試手動更新這些權限。 如需詳細資訊,請參閱:
代理程式共用失敗,未授與知識存取權 如果代理共用失敗,基礎知識來源可能無法與預期的使用者或群組共用。 因此,無法存取這些檔案的使用者不會收到根據這些檔案產生的回應。 若要解決此問題,請確定您要與之共用代理程式的所有個人和群組都存在於您的組織中,然後在共用設定中選取知識來源以授予使用者存取權,以重新共用知識來源。
無法再更新代理程式 當您客服專員目前的共用設定不再符合新的系統管理員原則時,就會發生此錯誤。 客服專員擁有者必須先將共用設定變更為符合規範的選項,才能進一步更新客服專員。 橫幅會引導您進行此變更。
由於發生錯誤,因此無法建立此代理程式。 當系統無法建立代理程式時發生。 請在幾分鐘後再試一次。
此代理程式至少包含一個檔案具有不支援的敏感度標籤。 檢查並移除上傳的檔案。 當您上傳的檔案具有不支援的敏感度標籤時發生。 檢查上傳檔案旁邊的盾牌圖示,並移除有紅色錯誤圖示的檔案。 如需詳細資訊,請參閱 不支援的敏感度標籤案例。
您的代理程式無法更新,因為它可能會鼓勵有害行為。 當系統偵測到有害內容時發生。 檢閱客服專員的名稱、描述和說明,並移除任何有害內容,然後再次嘗試更新您的客服專員。 以取得詳細資訊。 請參閱 負責任的 AI 驗證。