共有セッションのタスクが期待どおりに進行していない場合、このガイドは原因を特定して対処するのに役立ちます。 ほとんどの問題は、いくつかのカテゴリに分類されます。
- スタックしているタスク
- 厳密すぎる、または緩すぎる検証
- エージェントまたはツールのエラー
- 予期しないと思われる認知動作
タスクが新しい状態でスタックする
タスクは新しい状態のままです。 一般的な原因:
未解決の依存関係
タスクは、ターミナルステータスにない別のタスクに依存します。
確認方法: タスクを開き、[ 依存 ] フィールドを確認します。 各依存関係の状態を確認します。
修正方法:
- 依存関係がスタックしている場合は、最初にそのタスクをデバッグします。
- 依存関係が関連しなくなった場合は、[ 依存 ] フィールドから削除します。
- 依存関係が完了してもタスクに [新規] と表示されている場合、認識はまだタスクに対して機能していません。 1 ~ 2 分待ちます。
認知が実行されていない
検出エンジンが停止している可能性があります。
確認方法: 共有セッションで探索エンジンが実行されていることを確認します。
修正方法: 検出エンジンを起動します。 認知は推論ループを開始し、準備ができているタスクを選択します。
注
探索エンジンは、サービスのアップグレード中に停止する可能性があります。 これは予期されることです。 共有セッション データ、タスクの結果、実行履歴は保持されます。 探索エンジンをもう一度起動して再開します。
検出エンジンが起動しない
タスク検証に必要なチャット モデルがデプロイされない場合があります。
確認方法: ワークスペースに gpt-5-4 (モデル: gpt-5.4) という名前のチャット モデルデプロイがあることを確認します。
修正方法: モデルをデプロイし ( チャット モデルのデプロイの作成を参照)、探索エンジンを起動します。
認知能力が他のタスクで忙しい
多くのタスクが実行中または検証中の場合、認識は新しいタスクを開始する前に容量を待機している可能性があります。
確認方法: 現在実行中の状態にあるタスクの数を確認します。 共有セッション アクティビティを調べて、認識が待機サイクル内にあるかどうかを確認します。
修正方法: 一部のタスクが完了するまで待ちます。 Cognition は、優先度と依存関係の準備状況に基づいてタスクに優先順位を付けます。
実行中の状態でタスクがスタックする
エージェントがタスクに対して作業している間、タスクは実行中のままです。 異常に長い時間持続する場合は、何かが間違っている可能性があります。
通常の実行時間
タスクが停止していると想定する前に、何が起こっているかを検討します。
- エージェントのみのタスク (ツール呼び出しなし): 通常は 1 分以内に完了します。
- ツール呼び出しを含むタスク: スーパーコンピューターのコールド スタートにより、セッションの最初のツール呼び出しに 2 ~ 4 分かかることがあります。 後続の呼び出しは高速です (1 分未満)。
- 計算が多いタスク: 一部のツールでは、5 ~ 15 分かかるシミュレーションまたは大規模な分析が実行されます。
エージェントの応答が停滞している
タスクがツール アクティビティなしで 15 分以上実行されている場合、基になるモデルの応答がスタックしている可能性があります。
確認方法: 現在の実行のタスクの実行履歴を確認します。 応答に"進行中" と表示され、長期間新しい出力がない場合、応答はモデル レイヤーでストールしている可能性があります。
修正方法:
- 探索エンジンを停止して再起動します。 これにより、システムはすべてのタスクを再評価し、停止したタスクを再実行します。
- 問題が解決しない場合は、ワークスペース内のモデルのデプロイが正常かどうかを確認します。
ツールの実行に失敗しました
エージェントはツールを呼び出しましたが、ツールからエラーが返されました。
確認方法: ツール呼び出し結果の実行履歴を確認します。 通常、ツールからのエラー メッセージには、問題の詳細が含まれます。
ツールの一般的なエラーと修正:
| エラー | 想定される原因 | 修正 |
|---|---|---|
| ログのない "ツールの実行に失敗しました" | スーパーコンピューター ノードを起動できませんでした (VM SKU が制限され、クォータを超えました) | ノード プールの構成と VM SKU の可用性を確認する |
| 外部 API への接続タイムアウト | スーパーコンピューター サブネットのネットワーク制限 | 必要なエンドポイントがノード プールからアクセス可能であることを確認します。 「スーパーコンピューターとノード プールの管理」を参照してください |
| 認証エラー (403) | ワークスペースまたはスーパーコンピューター ID のロールの割り当てが見つかりません | マネージド ID に、ストレージ アカウント、コンテナー レジストリ、およびその他のリソースに必要なロールがあることを確認します |
| コンテナー イメージの取得エラー | スーパーコンピューターから ACR にアクセスできない、またはイメージが存在しない | ACR ネットワーク規則を確認し、イメージがプッシュされていることを確認する |
実行中と不完全の間のタスクの循環
タスクが [実行中] から [不完全] に繰り返し移動すると、結果が検証要件を満たしていないため、認識が再試行されます。
検証要件が厳しすぎます
エージェントは妥当な結果を生成しますが、検証基準の要求と正確には一致しません。
確認方法: タスクの検証コメントを読み取ります。 各試行には、合格した要件と失敗した要件を説明するコメントが含まれています。
修正方法:
- 使用可能なエージェントとツールで達成できるように検証要件を調整します。
- 徹底的な詳細を必要とするのではなく、最も重要なことに焦点を当てる要件を言い換えます。
- 検証の調整に関するガイダンスについては、 信頼関係と基本的な共有セッション パターン を参照してください。
エージェントがタスクに対応していない
割り当てられたエージェントには、タスクに必要な作業の種類に適したツールや指示がない可能性があります。
確認方法: 割り当てられているエージェント認識を確認します。 エージェントにタスクに必要なツールがあるかどうかを確認します。 エージェントの機能の概要とタスクの要件を比較します。
修正方法:
- 別のエージェントの方が適切な場合は、使用するエージェントとその理由を指定するコメントをタスクに追加します (たとえば、このタスクに molToolkit を使用します。SMILES 検証用の RDKit が必要です")。 Cognition は、エージェントを選択するときにコメントを読み取ります。
- 適切なエージェントが存在しない場合は、エージェントを作成または構成する必要があります。 探索エージェントの概念を参照してください。
タスクの説明があいまいである
タスクの説明でエージェントに十分なコンテキストが提供されない場合、エージェントは技術的には有効だがポイントを逃した結果を生成する可能性があります。
確認方法: エージェントの結果を読み取り、実際に必要なものと比較します。 結果が文字どおり説明に対応しているが意図を満たさなければ、説明にはより多くのコンテキストが必要です。
修正方法: 探しているものに関するより具体的な詳細でタスクの説明を更新し、状態を [新規] に戻します。
ユーザーの注意が必要としてフラグが設定されたタスク
認識がタスクにフラグを付けると、認知は複数のアプローチを試み、検証に合格する結果を生成できなかったことを意味します。
診断方法:
- 実行履歴を確認する: 試行された実行の数 どのようなアプローチが試みられましたか?
- 検証コメントの読み取り: 各試行で失敗した特定の要件は何ですか?
- 最新の結果を確認する: 必要なものか、それともオフですか?
解決するためのオプション:
- 結果を受け入れる: 最新の結果が十分な場合は、検証要件を更新し、タスクを完了としてマークします。
- ガイダンスを提供する: 不足している内容や試してみる方法を説明するコメントを追加します。 状態を [新規] に戻します。
- タスクを分割する: 1 つのエージェントに対してタスクが複雑すぎる場合は、小さな子タスクに分解します。
- ガイド エージェントの選択: 現在のエージェントに適切な機能がない場合は、使用するエージェントとその理由を指定するコメントを追加し、状態を [新規] に戻します。
- タスクを削除する: タスクが関連しなくなった場合は、その状態を [削除済み] に設定して、認識を移動します。
認知動作の問題
認知ウォームアップに時間がかかる
検出エンジンを初めて起動すると、認知はウォームアップ期間を経て、すべてのタスクを確認し、そのアプローチを計画することでコンテキストを構築します。 ウォームアップには通常 30 ~ 90 秒かかり、最初のタスクが開始される前にいくつかの内部推論サイクルが含まれます。
これは通常の動作です。 各再起動によって新しいウォームアップ期間がトリガーされるため、ウォームアップ中に探索エンジンを停止して再度起動しないでください。
認知が機能する代わりに待機し続ける
認識が待機ループ内にあるように見える場合 (新しい作業を開始せずにタスクの状態を繰り返しチェック)、アクティブな状態の他のタスクがブロックされる可能性があります。
確認方法: [実行中] または [検証中] の状態に長時間存在するタスクを探します。 タスクの状態が、認知の前進を妨げている可能性があります。
修正方法: 最初にスタックしているタスクを解決します。 ブロッカーがクリアされると、認知は通常の操作を再開します。
認識が間違ったエージェントを割り当てる
Cognition は、エージェントの機能とタスク要件の評価に基づいてエージェントを選択します。 場合によっては、ジョブに適したツールがないエージェントを選択することがあります。
確認方法: タスクの割り当てられたエージェントを確認し、その機能の概要とタスクに必要なものを比較します。
修正方法:
- 使用するエージェントを指定するコメントをタスクに追加します (例: "このタスクには paperAnalyzer が必要です。文献検索機能が必要です")。 次の試行でエージェントを選択すると、Cognition がコメントを読み取ります。
- これが繰り返し発生する場合は、エージェントが明確でわかりやすい機能の概要を持っていることを確認して、認識がより適切に選択できるようにします。
認識によって作成されるサブタスクが多すぎます
認知は、広範な目標を必要以上に多くのサブタスクに分解する可能性があります。
修正方法:
- ステータスを [削除済み] に設定すると役に立たないサブタスクを削除します。
- 特定の領域に焦点を当てる認識を導くコメントを親タスクに追加します。
- 認知境界を与えるために、完全な自律性の代わりに ガイド付き探索パターン を使用します。
出力ファイルを表示できない
タスクは完了として表示され、結果はファイル出力をメンションしますが、ファイル リンクをクリックするとアクセス エラーが表示されます。
これが発生する理由: エージェントは、プラットフォームのマネージド ID を使用してファイルを作成します。 VS Code でファイルを表示すると、 ブラウザーは ID を使用して BLOB ストレージに直接アクセスします。 これらは 2 つの独立したアクセス パスです。
ファイルを表示するには、次の 3 つのことが必要です。
| 検査 | 必要なもの | 誰が修正しますか |
|---|---|---|
| Network | ストレージ アカウントファイアウォールで IP (または VPN) を許可する必要がある | 管理者 |
| CORS | ストレージ アカウントは、 vscode.dev からの要求を許可する必要があります。 *.vscode-cdn.net |
管理者 |
| アクセス許可 | アカウントにストレージ アカウントの ストレージ BLOB データ リーダー が必要です | 管理者 |
これらのいずれかが見つからない場合は、ファイルが正常に作成された場合でも、ファイル リンクをクリックするとエラーが表示されます。
解決方法: ストレージ アカウント名 (ストレージ コンテナーのプロパティに表示されます) を管理者に問い合わせて、3 つの項目すべてを確認するように依頼します。 完全な構成要件については、「Microsoft Discovery の
注
共有セッションは、ファイル アクセスに関係なく、引き続き正しく動作します。 エージェントは、ファイルの読み取りと書き込みを行い、認識によってファイルの内容を検証し、タスクの結果でテキスト出力をキャプチャできます。 アクセスの問題は、ファイルを直接表示する機能にのみ影響します。
共有セッションの正常性の確認
共有セッションの状態を簡単に評価するには:
- 状態別にタスクをカウントする: 完了数と新規タスクと実行中タスクとユーザーの注意が必要なタスクの数。
- 阻害要因を特定する: 他の作業を停滞させている「実行中」または「ユーザーの注意が必要な」タスクはありますか?
- 認知状態を確認: Discovery Engine は実行中ですか? 認知は積極的に循環していますか?
- 最近のアクティビティを確認する: 過去 30 分間に何か変更はありますか? そうでない場合は、何かが停止している可能性があります。
共有セッションの状態の解釈に関するヘルプが必要な場合は、個々のタスクの実行履歴に、発生した内容とその理由に関する最も詳細な情報が提供されます。