マルチエージェントオーケストレーションのトラブルシューティング

マルチエージェントオーケストレーションソリューションで遅延を減らす方法は?

• まず、マルチエージェントオーケストレーションの「マルチエージェントソリューションの遅延を最小限に抑える方法」の推奨事項を実装します。
• Agentforce ソリューションで高遅延とタイムアウトが発生している場所を分離します。「リソースのトラブルシューティング」で説明されているデバッグツールを使用します。次に例を示します。
  • Agent Analytics で、ソリューションの「期間」総計値とスコアを監視します。エージェント状態監視で、関連する総計値とスコアのアラートしきい値を設定し、遅延がしきい値レベルを超えた場合に通知をトリガーします。
  • タイムアウトエラーのトレースとログを調査します。オーケストレーターエージェントのタイムアウト制限は 120 秒です。これには、オーケストレーターエージェントが代理や (スーパーバイザーモードで) 結果の合成などのオーバーヘッドタスクを実行するために費やした経過時間も含まれます。スーパーバイザーモードでは、オーケストレーターエージェントがタイムアウトエラーを合成します。接続済みサブエージェントのタイムアウト制限は 30 秒です。
  これらの症状を使用して、AI ソリューションで解決可能な遅延の根本原因を明らかにします。

変数を渡すときの問題を解決する方法は?

次の点に注意してください。

• カスタム (可変) 変数はセッション中に指定できます。
• コンテキスト (リンク済み) 変数は不変であり、セッションの開始後に更新することはできません。

『 Agentforce Developer Guide 』の「 Agent Script Reference: Variables (Custom and Linked) 」を参照してください。

マルチエージェントオーケストレーションでは、変数を渡す方法が 2 つあります。

• オーケストレーターエージェントから接続済みサブエージェント。接続済みサブエージェントの場合、入力変数を対応付けることができます。ハンドオフモードとスーパーバイザーモードの両方で、これらの入力変数をコンテキスト変数またはカスタム変数に対応付けることができます。「マルチエージェントオーケストレーションのハンドオフおよびスーパーバイザモード」を参照してください。
  

  メモ このリリースでは、変数は一方向にのみ渡されます。つまり、オーケストレーターエージェントから接続済みサブエージェントに渡されます。変数は、接続されたサブエージェントからオーケストレーターエージェントには渡されません。
• 接続されたサブエージェント間。ハンドオフモードでは、接続済みサブエージェントに [応答後] セクションがある場合、別の接続済みサブエージェントに移行する前に変数を設定できます。次に接続されたサブエージェントは、そのinputsブロックを介してのみこれらの値を受信するため、設定する変数には、対象接続されたサブエージェントの inputs ブロックでの対応付けが必要です。コンテキストは自動的に流れません。

Salesforce ヘルプの「Connect an Agent as a Subagent」および『Agentforce Developer Guide』の「Connected Subagent Block」を参照してください。

認証の問題を解決する方法は?

認証方法は、エージェント種別や、オーケストレーターエージェントと接続済みサブエージェントの組み合わせによって異なります。

• Agentforce サービスエージェント (ASA) 接続サブエージェントは、自身のエージェントユーザーではなく、オーケストレーターエージェントのセッションユーザー (デジタルユーザー) として実行されます。ASA では、認証されていないゲストユーザーもサポートされます。
• Agentforce Employee Agent（AEA； 従業員エージェント）接続サブエージェントは、ログイン ユーザのコンテキストで実行されます。接続済みサブエージェントが要求する操作に必要な権限をログインユーザーに割り当てます。

マルチエージェントオーケストレーションの「マルチエージェントソリューションでのユーザーレベルの認証」を参照してください。

マルチエージェントオーケストレーションソリューションで考慮できる制限事項は?

• マルチエージェントオーケストレーションの「考慮事項と制限事項」で、サポートされている機能とサポートされていない機能を確認します。
• マルチエージェントオーケストレーションでは、接続されたサブエージェントの数に制限はありません。さまざまな組み合わせを試して、使用事例や環境に合わせて拡張できる最適な設計を考えます。
• 設計の推奨事項については、マルチエージェントオーケストレーションの「エージェント間ソリューションの設計のヒント」を参照してください。

トラブルシューティングリソース

Agentforce には、パターンの特定、根本原因の調査、および是正措置の実行に役立つツールと機能があります。

• エージェントビルダーの会話プレビューパネルのプラントレーサーを使用して、マルチエージェントソリューションの問題を調査します。会話またはワークフローテスト中にオーケストレーターエージェントと接続済みサブエージェントが実行する詳細な決定とアクションをステップごとに確認します。
• 拡張イベントログを使用して、エージェントの会話に関する詳細な詳細を提供します。
• Agent Analytics を使用して、エージェントのパフォーマンスを監視し、エラーのトレンドを検出します。セッションレベルでパターンと根本原因を調査する (「Analyze Data with Agent Optimization (エージェント最適化を使用したデータの分析)」を参照)。
• エージェント状態監視で、エージェントのパフォーマンスがしきい値レベルを超えた場合に通知をトリガーするアラートしきい値を設定します。