跳至主要内容

委派任務與驗證結果

委派是把任務交給單獨的子任務,由 Main Agent 協調對話。在主會話中選擇 Specialist 發言,與真正產生子任務,是兩種不同操作。

準備明確的交接

資訊本例
角色RNA-seq QC Reviewer,儲存 ID rna-seq-qc-reviewer
輸入完整 GSE60450 樣本 QC CSV,或當前有效不可變檔案版本
任務檢查 12 個完整、非空且唯一的樣本 ID,以及每個樣本的計數約束
輸出檢查表及每個樣本的算式
範圍只讀、不安裝新包、不做差異表達解釋
  1. 建立並配置角色,確認啟用。
  2. 在當前對話 Agent controls 開啟 Delegation,核對模型和認證可用。
  3. 明確要求 Main Agent 委派,說明角色和完整任務。交接檔案時由應用解析當前版本,不猜 ID,不把檔名當版本引用。
  4. 檢視真實委派活動及子任務狀態;Main Agent 的進度描述不能代替子任務記錄。
  5. 點選子任務入口開啟 Subagents,在 Subagent Frame 選擇任務,讀取對話、工具結果及最終狀態。
  6. 子任務請求權限時,在父對話檢查請求範圍並響應;完成後逐項驗收。

核對交接和返回結果

核對直接提供的小表格

案例演示 委派十二個樣本的表格核對

下載完整的 樣本 QC CSV,將表頭和十二行資料全部貼上到下方請求後,保留所有列與完整樣本標識。本例使用建立角色中的已啟用角色,並要求 Python 可用以執行算術檢查。此項小範圍檢查不需要額外 Skill。

Delegate to RNA-seq QC Reviewer. Use only the complete inline CSV below. Execute the arithmetic in Python, verify twelve distinct full sample identifiers, and check zero_count_genes + detected_genes_count_gt_0 = 27179 for every row. Return each result and state that this checks supplied summary data, not independent access to the original count matrix.

完成的 Specialist 子任務及逐樣本檢查

本例結果:子任務實際執行 Python Notebook,得到 12 行、12 個唯一且非空的完整 ID,12/12 個求和均為 27,179。首個樣本為 8,664 + 18,515 = 27,179,數值欄位完整且非負。

這些結果只驗證彙總表內部一致性,不能獨立重算原始矩陣的總量/中位數、確認樣本條件或建立生物學質量閾值。

選擇獨立模型

Settings → Model → Subagent 選擇固定模型後,再啟動委派。開啟子任務記錄核對實際模型;不要用主會話的模型標籤判斷子任務。獨立模型示例中,Main 使用 gpt-5.6-sol,子任務記錄顯示 gpt-5.6-luna,兩者均透過 Codex 訂閱執行。

把檔案交給子任務

示例 把樣本 QC 檔案交給子任務

  1. 透過會話附件選單新增原始檔,等待上傳完成。
  2. 要求 Main 把這個準確的上傳版本交給子任務,說明檢查項與輸出要求;不要用檔名或猜測的版本 ID 代替檔案。
  3. 開啟 Subagents 並選擇子任務。在 NotebookAgent 篩選中選擇該子任務,檢視實際檔案讀取。
  4. 將子任務返回的行數、列名和校驗和與原始檔比較,再開啟儲存的輸出核對計算。

對於公開樣本指標 CSV,預期是 12 行資料total_counts 總和為 269,027,617,輸入校驗和保持不變。這些檢查針對提供的樣本彙總表,不會重新計算原始基因計數矩陣。

檢查應看到什麼
版本已接受應用在所屬會話中解析了當前不可變上傳/產物版本
子任務能讀取子任務工具返回檔案內容;僅出現檔名或暫存路徑不夠
檢查已執行子任務執行了計算,儲存的結果與原始檔一致

出現輸入不可用錯誤時,重新附加檔案並使用當前版本重試。若子任務返回 PermissionError: [Errno 1] Operation not permitted,保留準確錯誤;重新附加後仍無法讀取時,按故障排查反饋。不要把檔案移入應用內部資料夾來繞過錯誤。

讓子任務使用 Skill

先匯入或建立 Skill。使用 Specialist 時,在角色的 Skills 與 Connectors 中分配方法,然後啟動新的委派任務,明確指定方法名稱,並要求子任務先讀取已安裝的指令。

檢視子任務工具活動中的 Skill 標識與讀取內容。例如,rnaseq-count-qc 要求原始基因計數矩陣,用於描述性質控;十二行樣本彙總表不能替代該輸入。成功讀取安裝包不代表已執行分析,還需單獨檢查執行與儲存結果。

正確理解失敗狀態

狀態含義和處理
Delegation 關閉在目標會話開啟後重試
角色禁用 / 設定未完成完成本地設定並啟用準確角色
Input unavailable in this Session獲取當前準確 artifact version 或不可變 upload-version;路徑、artifact ID、version ID 不同
Waiting for permission檢查對應子任務的操作;父任務可能是在等待而非計算
Child completed讀取輸出和工具證據;完成不保證科學正確性
Cancelled / failed保留部分結果與真實錯誤,不能把 Main Agent 替代回答寫成委派成功

完整小表可以採用內聯交接,但必須註明證據範圍,不能把它當成通用的檔案溯源替代方案。

實現依據: ComposerAgentControlsMenu.tsx, SpecialistSubmenu.tsx