當共享會議中的任務進展不如預期時,本指南能幫助你找出原因並採取行動。 大多數議題可分為幾類:
- 卡住的任務
- 過度嚴格或過於寬鬆的認可
- 代理或工具錯誤
- 看似出乎意料的認知行為
停滯在新增狀態的工作
一項工作保持在新增狀態中。 常見原因:
未滿足的依賴
這個任務依賴於另一個未處於終端狀態的任務。
如何檢查:打開任務並檢視 Depends on 欄位。 檢查每個扶養關係的狀態。
如何修復:
- 如果依賴卡住了,先進行除錯該任務。
- 如果依賴性不再相關,請從 依賴 欄位中移除。
- 如果相依性完成了,但工作仍顯示「新增」,表示認知尚未處理該工作。 等1到2分鐘。
Cognition 系統未啟動
探索引擎可能會被停擺。
如何檢查:確認 Discovery Engine 是否在你的共享工作階段中運行。
如何修復:啟動 Discovery 引擎。 認知開始推理迴圈,接手準備好的任務。
備註
Discovery 引擎可能會在服務升級時停止運作。 這是預期的。 你共享的會話資料、任務結果和執行歷史都會被保留。 重新啟動 Discovery Engine 以繼續。
探索引擎無法啟動
任務驗證所需的聊天模式可能不會被部署。
如何檢查:確認你的工作區是否有名為 gpt-5-4 (model: gpt-5.4) 的聊天模型部署。
解決方法:部署模型(參見 建立聊天模型部署),然後啟動發現引擎。
認知正忙於其他任務
如果許多任務同時執行或驗證,認知可能正在等待容量達到,才開始新的任務。
如何檢查:查看目前有多少任務處於執行狀態。 透過查看共用工作階段活動,檢查認知功能是否處於等待週期。
如何修正:等某些任務完成。 認知根據優先順序和依賴準備度來優先排序任務。
卡在執行狀態的任務
當代理程式正在執行任務時,任務會保持在執行中。 如果持續異常長的時間,可能有問題。
正常執行時間
在假設某項任務卡住之前,請考慮發生了什麼:
- 僅限客服人員完成的任務 (無工具呼叫):通常在1分鐘內完成。
- 工具呼叫任務:一場會議中的第一次工具呼叫可能因超級電腦冷啟動而需 2-4 分鐘。 後續通話速度較快(不到1分鐘)。
- 計算量大的任務:有些工具執行模擬或大規模分析,需花費5至15分鐘。
特工的回應被拖延了
如果一個任務已經執行超過 15 分鐘且沒有任何工具活動,底層模型的回應可能會卡住。
如何檢查:查看該任務目前執行的歷史。 如果回應顯示「進行中」且長時間沒有新輸出,則該回應很可能在模型層停滯。
如何修復:
- 停止並重新啟動探索引擎。 這會讓認知重新評估所有任務,並重新嘗試停滯的任務。
- 如果問題持續存在,請檢查你工作空間中的模型部署是否健康。
工具執行失敗
客服呼叫工具,但工具回傳錯誤。
如何檢查:查看工具呼叫結果的執行歷史。 工具的錯誤訊息通常會包含錯誤原因的詳細資訊。
常見工具錯誤與修正:
| 錯誤 | 可能的原因 | 修正 |
|---|---|---|
| 「工具執行失敗」且沒有日誌 | 超級電腦節點無法啟動(虛擬機 SKU 限制,配額超過) | 檢查你的節點池設定和虛擬機 SKU 可用性 |
| 外部 API 連線逾時 | 超級電腦子網的網路限制 | 確認所需的端點是否能從節點池中存取。 參見 管理超級電腦與節點池 |
| 認證錯誤(403) | 工作區或超級電腦身分識別缺少角色指派 | 確認受管理身份在儲存帳號、容器登錄及其他資源中擁有所需的角色 |
| 容器映像拉取失敗 | 超級電腦無法存取 ACR,或者影像不存在 | 請檢查 ACR 網路規則並確認映像檔是否被推送 |
任務在執行中與未完成間循環
當任務反覆從執行中(Executeing)到未完成(Incomplete)再回到原位時,認知系統正在重試,因為結果未符合驗證要求。
驗證要求過於嚴格
代理人產生的結果合理,但並不完全符合驗證標準的要求。
如何檢查:閱讀任務上的驗證評論。 每次嘗試都會附上說明,指出哪些要求是通過的,哪些是未通過的。
如何修復:
- 調整驗證要求,使其能在現有代理與工具下達成。
- 重新表述要求,聚焦於最重要的部分,而非要求詳盡細節。
- 請參閱 信任關係及基本共享會話模式 ,以獲得校準驗證的指引。
代理人無法勝任這項任務
被指派的代理人可能沒有適合該任務所需的工具或指示。
如何檢查:查看認知指派了哪個 Agent。 檢查經紀人是否擁有執行該任務所需的工具。 將代理人的能力摘要與任務需求進行比較。
如何修復:
- 如果換個代理會更合適,可以在任務中加入註解說明要使用哪個代理及其原因(例如:「此任務使用 molToolkit。它需要 RDKit 來驗證 SMILES」)。 認知在選擇代理人時會讀取評論。
- 如果沒有合適的代理程式,你可能需要建立或設定一個。 詳見 發現代理概念。
任務描述含糊不清
如果任務描述沒有給代理足夠的脈絡,代理可能會產生技術上有效但卻忽略重點的結果。
如何檢查:閱讀經紀人的結果,並與你實際想要的結果做比較。 如果結果字面上回應了描述,卻錯過了你的意圖,那描述就需要更多上下文。
解決方法:更新任務描述,加入更具體的細節,說明你想要什麼,然後將狀態設回「新」。
標記為需要使用者關注的任務
當認知標記任務時,代表認知嘗試了多種方法,卻無法產生通過驗證的結果。
診斷方法:
- 查看執行紀錄:嘗試了多少次執行? 嘗試了哪些方法?
- 閱讀驗證評論:每次嘗試中有哪些具體要求未通過?
- 檢閱最新結果:這是您所要的嗎?還是不是?
解決選項:
- 接受結果:若最新結果足夠良好,更新驗證要求並標記任務完成。
- 提供指導:附上留言說明缺少什麼或該嘗試什麼方法。 將狀態設回「新」。
- 拆解任務:如果任務對單一代理來說過於複雜,則將其拆解為較小的子任務。
- Guide agent 選擇:如果目前的代理沒有合適的功能,請新增註解說明要使用哪個代理及其原因,然後將狀態設回「新」。
- 移除任務:如果任務不再相關,將狀態設為已移除,讓認知繼續前進。
認知行為問題
認知熱身需要很長時間
當你剛啟動發現引擎時,認知會經歷一個熱身期,透過檢視所有任務並規劃其方法來建立上下文。 暖身通常需要30到90秒,並包含多個內部推理循環,然後才開始第一個任務。
這是正常的行為。 熱身時不要再停停再啟動 Discovery 引擎,因為每次重啟都會觸發新的熱身期。
認知一直在等待,而不是工作
如果認知似乎處於等待迴圈(不斷檢查任務狀態卻不開始新工作),它可能會阻擋其他處於活躍狀態的任務。
如何檢查:尋找處於執行中或驗證狀態且存在時間較長的任務。 任務狀態可能阻礙了認知的前進。
如何解決:先解決卡住的任務。 一旦阻隔物清除,認知功能就會恢復正常運作。
認知指派錯誤的代理人
Cognition 根據對代理能力與任務需求的評估來選擇代理人。 有時候,它可能會選擇一個沒有合適工具來完成該工作的 Agent。
如何檢查:查看任務所指派的代理,並將其能力摘要與任務需求進行比較。
如何修復:
- 在任務中加入註解,指定使用哪個代理程式(例如:「此任務需要 paperAnalyzer。它需要文獻搜尋功能」)。 認知在下一次嘗試選擇代理人時會讀取評論。
- 如果這種情況反覆發生,請檢查你的代理人是否有清晰且具描述性的能力摘要,讓認知能做出更好的選擇。
認知會產生太多子任務
認知可能會將廣泛的目標分解成比必要的更多子任務。
如何修復:
- 移除那些沒用的子任務,將狀態設為已移除。
- 在家長任務中加入一條評論,引導認知專注於特定領域。
- 用 引導式探索模式 取代完全自主,來設定認知界線。
無法查看輸出檔案
任務顯示為完成,結果會提到檔案輸出,但點擊檔案連結時會看到存取錯誤。
為什麼會這樣:代理會使用平台的管理身份來建立檔案。 當你在 VS Code 中查看檔案時,瀏覽器會直接使用 你的 身份來存取 blob 儲存空間。 這是兩條獨立的進出路徑。
您必須具備三項條件才能查看檔案:
| 勾選 | 需要的項目 | 誰來修理 |
|---|---|---|
| Network | 你的 IP(或 VPN)必須被儲存帳號防火牆允許 | 系統管理員 |
| CORS | 儲存帳號必須允許來自 vscode.dev 和 *.vscode-cdn.net 的請求 |
系統管理員 |
| 許可 | 您的帳戶在儲存體帳戶上需要儲存體 Blob 資料讀者 | 系統管理員 |
如果缺少任何這些資料,點擊檔案連結時仍會看到錯誤,儘管檔案已成功建立。
如何修復:聯絡你的管理員,提供儲存帳號名稱(儲存容器屬性中可見),請他們驗證這三個項目。 完整配置要求請參見 Microsoft Discovery 中的
備註
無論您的檔案存取權如何,共用工作階段都會持續正常運作。 代理能讀寫檔案,認知系統能驗證檔案內容,任務結果則捕捉文字輸出。 存取問題只影響你直接查看檔案的能力。
檢查共用工作階段健全狀態
若要快速評估共用工作階段的狀態:
- 依狀態計算任務:完成、新任務、執行中、需要使用者關注的任務數量是多少?
- 辨識阻礙因素:執行或需要使用者注意的工作是否阻礙了其他工作?
- 檢查認知狀態:發現引擎是否在運行? 認知是否在積極循環?
- 檢視近期活動:過去30分鐘內有什麼變化嗎? 如果沒有,可能有項目延滯了。
如果你需要協助解讀共享會話狀態,個別任務的執行歷史會提供最詳細的事件與原因資訊。