使用 Select AI 建立主管專員團隊

建立由主管主導的 Select AI 代理團隊，將多步驟要求遞送給專業工作人員，並傳回一個協調回應。

Select AI supervisor 代理程式是 Select AI agent 物件，可在執行時期控制由主管主導的代理程式團隊。主管專員物件會收到使用者提示、選取應處理每個子任務的職工專員任務組、傳遞必要內容、等待該職工結果，並繼續選取下一個專員任務組，直到可傳回最終答案為止。

下圖說明 Select AI supervisor 代理程式樣式。 select-ai-supervisor-agent-pattern.png 的描述

何時使用主管代理人

當團隊必須在執行時期決定適當的員工或執行順序時，請使用主管模式。主管領導團隊可以根據使用者的意圖和中間結果，在不同順序要求不同的員工時提供協助。主管決定接下來要打電話給哪一個職工專員任務組、傳送獨立的子任務、等待結果，並繼續直到產生一個協調的最終答案為止。

主管代理程式適合：

跨不同業務或技術領域的工作流程。
需要不同代理程式、工具或資料來源的要求。
需要單一進入點以進行遞送與協調要求的專員團隊。
主管必須管理接洽序號並合併子代理回應的工作流程。

關於 Select AI 主管專員團隊

瞭解 Select AI 主管專員團隊如何協調職工專員、控制任務遞送、保留內容，以及傳回一個最終回應。

主管專員團隊是 Select AI 專員團隊的協調模式。在該團隊中，透過將其 supervisor 屬性設為 true，以及將該物件設為 supervisor_agent 屬性的團隊名稱，將一個 Select AI 代理程式物件識別為 supervisor。職工服務人員會保有重點職責，例如帳戶查尋、付款擷取、報表產生或通知遞送。主管服務人員物件會決定要呼叫的職工、準備該職工的獨立要求，並將職工結果加回主管內容。

子任務處理依序進行：主管委派下一個子任務之前，必須先完成一個職工子任務。主管會等候員工結果，將結果新增至主管環境定義，然後決定是否打電話給其他員工、要求更多資訊、解釋員工失敗，或回覆最終答案。職工專員使用個別的對話執行緒，因此主管必須在每個委派要求中包含足夠的內容。

此功能會將主管相關的屬性新增至現有的 DBMS_CLOUD_AI_AGENT API。使用 supervisor 代理程式屬性將 Select AI 代理程式物件標示為監督者。使用 supervisor_agent 群組屬性來命名團隊的監督代理程式物件。受監督的團隊包含一個主管代理人物件，以及一或多個職工代理人任務配對。agents 團隊屬性會列出可供委派的職工代理任務配對。每個工作者工作都可以使用其設定的工具。主管專員物件委派給職工專員 - 任務配對；Oracle 維護的委派工具無法由使用者設定。

如需使用 supervisor 代理程式的端對端範例，請參閱 Example：Build and Run a Customer Support Supervisor Team 。

選取 AI 主管代理程式架構

受監督的 Select AI 代理團隊是以單一團隊的形式執行，其中包含一個主管代理物件和一或多個職工代理任務組。團隊定義會命名 supervisor_agent 中的主管代理人物件；職工清單會命名主管可委派的代理人與任務配對。工具是在職工任務上設定，而不是在團隊上設定。

在主管領導團隊中，處理仍設為循序，但設定的職工順序不是工作流程計畫。主管一次可動態選取一個員工代理人任務組、等待結果，然後決定是否需要其他員工。

主管代理人物件在內部使用 Oracle 維護的委派工具，以委派給職工的代理人任務配對。委派工具為主管執行模型的一部分，且未列為使用者可配置的團隊屬性。

主管擁有整體要求，並在自己的對話繫線中執行。每個職工專員都會在個別的對話執行緒中執行。職工不會繼承完整的主管內容。主管必須為每位員工建立獨立的子任務要求。職工只會將其最終結果傳回主管。supervisor 會將傳回的結果新增至其本身的相關資訊環境，並決定下一個動作。

影像的描述如下

階段	輸入	處理中	輸出
要求提交	已將使用者自然語言要求提交給團隊	監督的團隊會先啟動監督者代理程式。	要求的主管對話繫線已開始。
主管推理迴圈	使用者請求與目前主管內容	主管決定是否有足夠的資訊可以回答，或必須委派子任務。	最終答案或一個委派員工要求。
任務委派	選取的職工代理任務配對與獨立子任務內容	主管會呼叫 Oracle 維護的委派工具，以進行選取的職工專員與任務配對並等待。	職工任務會在自己的對話執行緒中開始。
任務處理	委派子任務與職工任務組態	職工會使用其任務上設定的工具。如果需要使用者輸入，則團隊會等待使用者回應。	職工結果、職工失敗結果或人力輸入要求。
主管延續	傳回的工作程式結果、失敗結果或使用者回應	supervisor 會將傳回的結果新增至其相關資訊環境，然後繼續推理。失敗遵循與成功的相同傳回路徑；主管可決定是要重試、呼叫其他職工、要求更多資訊、說明失敗，還是傳回最終答案。

主管領導團隊中的執行時間行為

瞭解主管領導的團隊如何暫停使用者輸入、處理員工失敗，以及在主管與職工對話之間傳遞獨立的內容。

人力輸入處理

當職工要求人工輸入時，整個主管領導的團隊會在等待使用者回應時暫停。使用者會繼續在相同的對話中提供要求的資訊。

使用者回應後，員工履歷，完成任務，並將結果傳回主管。主管接著決定要委派其他子任務或傳回最終答案。

失敗處理

工作程式失敗與成功結果遵循相同的傳回路徑。主管會收到失敗結果並決定下一個動作，例如重試任務、呼叫其他職工專員任務組、要求其他輸入，或傳回最終答案。

內容傳遞模型

每個職工在自己的對話執行緒中作業，且不會繼承完整的主管內容。主管必須提供包含所有必要資訊的獨立子任務要求，以供職工完成任務。

主管專員的使用案例

當一個要求可能需要數個專業專員、條件式路由或暫存回應時，套用主管引導式的 Select AI 團隊。

回答需要帳戶明細、付款歷史記錄及最終合併回應的客戶支援要求。
根據資料來源將資料分析提示傳送給正確的工作者，然後將工作者結果合併成一個答案。
在傳送通知或完成業務動作前，要求職工暫停人類確認。
針對有時需要一位員工，有時需要數名員工的要求，請使用一個主管團隊。
追蹤員工的交接，並傳回審核、測試與疑難排解的結果。

福利

使用主管領導的團隊來遞送多步驟要求、讓工作人員專注於工作，以及記錄 Select AI 服務人員架構活動的委派路徑。

動態工作路由：主管會根據目前的要求和傳回的相關資訊環境選取下一個工作節點。
專注於員工的設計：每個員工都會處理有界限的工作區域，讓提示和工具對應更容易維護。
內容控制：主管只會傳遞每個職工子任務所需的內容。
可追溯性：團隊與任務歷史記錄檢視可顯示委派路徑與傳回的職工結果。
團隊成長增量：為新任務新增職工專員，無須重新設計每個現有職工。

如何使用 Select AI 主管專員團隊

建立要擔任主管的代理人，並將其指定為主管、建立職工代理人、將主管新增至團隊屬性，以及對團隊執行使用者提示。

授予必要的權限。資料庫使用者必須具備 DBMS_CLOUD_AI_AGENT 的 EXECUTE 權限、必要證明資料的存取權，以及外部提供者呼叫所需的網路 ACL。如需詳細資訊，請參閱使用 Select AI 代理程式的先決條件。
建立職工服務人員使用的工具，如查尋、更新、通知或報表任務的 PL/SQL 功能。如需詳細資訊，請參閱 DBMS_CLOUD_AI_AGENT 套裝軟體和使用 Select AI 代理程式的範例。
建立職工服務人員與任務。請將每個職工角色保持為特定狀態，讓主管可為每個子任務選取正確的職工。請參閱 CREATE_TASK Procedure 和 CREATE_AGENT Procedure 。
建立 supervisor 屬性設為 true 的監督器代理程式。請參閱 CREATE_AGENT 屬性。
建立將 supervisor_agent 設為主管代理程式名稱，並將 agents 設為職工代理程式任務配對的團隊。請參閱 CREATE_TEAM 程序。
使用「選取 AI 代理程式」架構設定階段作業的團隊，並提交自然語言提示。請參閱 SET_TEAM 函數。
複查歷史記錄檢視以確認職工轉接、傳回結果、職工失敗及人力輸入等待狀態。如果職工任務要求人工輸入，則團隊會暫停直到使用者回應為止。整個主管領導的團隊在此期間暫停。繼續相同的對話以提供要求的輸入。使用者回應後，員工履歷，完成任務，並將結果傳回主管。主管接著決定下一個動作。請參閱 DBMS_CLOUD_AI_AGENT 檢視。

請勿將選取的主管納入工作程式 agents 的陣列中。主管控制團隊，而陣列僅列出可用於委派的員工代理人與任務配對。職工任務可以使用自己的設定工具；團隊屬性不會列出工具名稱。

備註：主管領導的團隊會依序處理職工子任務。主管在委派其他子任務前，等候每個員工結果。平行工作執行不屬於此版本。

允許的主管專員團隊組態

複查支援的組態與指引，以定義 Select AI 代理團隊中的主管、職工專員任務組、工具及處理。

組態	允許?	指引
`supervisor_agent` 會將使用 `supervisor` 建立的代理程式命名為 `true`	是	對監督的團隊使用此模式。
選取的主管也會列在工作程式 `agents` 陣列中	否	指定為主管的專員無法包含在工作程式陣列中。設計驗證會拒絕 `agents` 陣列中啟用 supervisor 的代理程式。
相同的職工專員已指派給多個任務	是	同一個代理程式可以透過將同一個代理程式指派給不同的工作名稱來執行多個工作。
工具列在團隊 `agents` 陣列中	否	使用 `CREATE_TASK` 定義工作的工具。團隊屬性會列出職工專員與任務配對，而不是工具名稱。
`supervisor_agent` 會命名沒有 `"supervisor": true` 的代理程式	否	選取 `supervisor` 設為 `true` 的代理程式。如果指定的專員不是主管，則團隊建立或驗證會失敗；請檢查傳回的資料庫錯誤詳細資料。
已為團隊定義多個主管	否	團隊僅支援一位主管。使用 `"supervisor": true` 定義單一代理程式，並在 `supervisor_agent` 中參照該代理程式。
主管委派給其他主管領導的團隊	否	此版本不支援主管對主管委派。主管只能委派給相同團隊中的職工服務人員。
在一個團隊中指定為主管的專員可作為另一個團隊中的職工	是	您可以在具有不同角色 (主管或職工) 的多個團隊中重複使用相同的主管專員。透過團隊組態定義角色。

注意：

架構不會強制執行對話週轉次數上限。對於任務執行，架構會將失敗的工具呼叫重試次數限制為每項任務 10 次嘗試次數。
此架構不會引入新的檢視以進行監視。您可以使用現有的 Select AI Agent 架構歷史記錄檢視，檢閱團隊、任務和工具執行歷史記錄。如需詳細資訊，請參閱 DBMS_CLOUD_AI_AGENT 歷史記錄檢視。

主管領導的團隊疑難排解

識別一般 Select AI 主管領導團隊組態、委派、內容、通知和人力輸入問題的可能原因和修正。

團隊建立失敗

問題：團隊建立失敗。

可能原因：supervisor_agent 不會命名含有 "supervisor": true 的代理程式。

修正：使用 supervisor 屬性重新建立代理程式，然後再次建立團隊。

主管呼叫錯誤的職工

問題：主管呼叫錯誤的職工。

可能原因：職工任務描述太模糊或重疊。

修正：讓工作指示更具體且互斥。主管會根據代理程式名稱、作業名稱、描述以及作業指示，選取工作代理程式作業組。

定義員工任務時，請使用下列指導方針：

為每位員工定義明確的領域界限。
使用特定工作名稱，例如 ACCOUNT_MANAGEMENT_TASK 或 PAYMENT_LOOKUP_TASK。
避免職工之間的指示重疊。
在任務指示中包含預期的輸入參數。
指定員工應何時要求人力輸入。
定義傳回給主管的結果格式。

職工缺少內容

問題：職工缺少內容。

可能原因：主管未在委派子作業中傳送足夠的明細。

修正：新增指示，告知主管傳送獨立的子任務。定義指引委派行為的明確主管角色。

範例：

{
  "profile_name": "<AI_PROFILE_NAME>",
  "supervisor": true,
  "role": "You orchestrate requests. Choose the appropriate worker agent-task pair for each subtask. Send self-contained requests with all required context. Return one concise final answer."
}

電子郵件未傳送

問題：電子郵件不會傳送。

可能原因：證明資料、網路 ACL、寄件者或收件者組態遺漏或不正確。

修正：驗證 SMTP 證明資料、ACL、寄件者以及收件者設定值。

使用者輸入的提示等待

問題：提示會等待使用者輸入。

可能原因：主管或職工要求人為確認。

修正：繼續與要求的資訊進行相同的對話。

比較循序工作流程和主管模式

根據團隊必須選取職工的方式和協調任務，選取適當的 Select AI 代理團隊模式。

當團隊必須依已知順序執行已設定的專員任務配對時，選取循序工作流程模式。當團隊必須根據要求、中繼結果、失敗或要求更多資訊，在執行時期選取員工時，請選取主管模式。

特性	循序工作流程模式	主管模式
執行計畫	固定。`agents` 陣列會定義工作流程順序。	變數。主管會在執行時期選取下一個員工。
進入階段	第一個設定的代理程式作業組。	主管代理人。
任務選取	團隊會依序執行已設定的專員任務配對。	主管會視需要呼叫一或多個員工。
傳遞相關資訊環境	作業相依性會將先前作業輸出傳送至下游作業。	主管傳送獨立的子任務給每位員工。
最適合	具有已知階段的可預測管線。	需要條件式路由或協調的變數要求。
平行執行	不支援。任務一次執行一個。	不支援。職工子任務一次執行一個。

下表提供「循序」模式與「主管」模式之間的差異，可協助您決定工作流程。

循序模式	主管模式
固定工作流程	動態協調
每個步驟的執行順序	僅執行所需的步驟
適用於線性管線	適用於分支企業要求
減少決策邏輯	減少手動路由邏輯，執行時期判斷更多