グラウンディング、制限、一般的なエラーをトラブルシューティングする
学習の目的
この単元を完了すると、次のことができるようになります。
- 引用の欠落とナレッジのグラウンディングの問題を解決する。
- システム制限によって発生する応答の切り捨てやストリーミングエラーを軽減する。
- Agentforce の一般的なエラーコードとその修正方法を確認する。
引用が表示されない問題を修正する
引用は、ナレッジアクションが引用を返し、そのアクションで引用が有効になっている場合にのみ表示されます。アクションの設定を見直し、単独でテストして、後続の処理で応答が上書きされていないことを確認し、参照元の記事が公開され、インデックス付けされていて、エージェントからアクセス可能な状態であることを確認してください。
引用が表示されない場合:
- ナレッジアクションの設定を開き、引用が有効になっていることを確認します。
- アクションを単独でテストし、引用元が返されることを確認します。
- 引用が添付された後、フロー内の後続の処理が応答を上書きしないことを確認してください。
- 参照元のナレッジ記事が公開され、インデックス付けされていて、エージェントからアクセス可能な状態であることを確認します。
セキュリティ上の理由から、一部の URL は非表示になることがあります。この問題を解決するには、[Setup (設定)] で信頼済み URL を追加し、その URL がアクションによって返されるか、明示的に許可されていることを確認してください。
応答の切り捨てを軽減する
Agentforce には明確な制限があります。LLM 応答は約 2,048 トークン、アクション出力は約 65,000 文字までです。この制限に達すると、応答が文の途中で切れたり、アクションの結果が不完全な状態で返されたりします。
応答の切り捨てを減らすには、次の方法を試してください。
- 大きな出力を直接埋め込む代わりに、[Show in Conversation (会話に表示)] を使用します。
- アクションで不要な項目を返さないようにします。
- 複雑な要求は複数のステップに分割します。
- 大量のデータはオブジェクトに保存し、アクションを通じて参照します。
ストリーミングと応答の書き換えの問題を解決する
いったん表示された応答が変化したり消えたりする場合は、グラウンディングチェックがトリガーされた可能性があります。指示は正確かつ具体的に記述します。範囲が広すぎるプロンプトやあいまいなプロンプトは避けます。ナレッジまたは構造化データで応答をグラウンディングします。
一般的なストリーミングエラーの場合は、プロンプトテンプレートに JSON を多用した出力などの厳格な形式がないかを見直し、ネストされた指示を簡略化して、アクションの大きな出力を減らします。
一般的なエラーコードを確認する
エラーコード | 説明 | 解決のヒント |
|---|---|---|
401 | Unauthorized (許可されていません) | OAuth トークンを更新します。 |
403 | Forbidden (禁止) | ユーザー権限またはインテグレーション権限を更新します。 |
404 | Not Found (見つかりません) | エンドポイント URL またはレコード ID を検証します。 |
429 | Too Many Requests (要求が多すぎます) | 再試行とバックオフのロジックを追加します。 |
500 | Internal Server Error (内部サーバーエラー) | ログを確認するか、Salesforce サポートにお問い合わせください。 |
また、エージェントはユーザーのターンごとに最大 8 回の LLM コールを実行できます。この上限に達した場合は、アクションが繰り返し失敗していないか、検証がループしていないか、ワークフローが複雑になりすぎていないかを確認します。サブエージェントの処理の流れを簡素化して、問題を解決します。