設定とデータの問題を修正する
学習の目的
この単元を完了すると、次のことができるようになります。
- Agentforce の設定エラーの一般的な原因を特定する。
- エージェント応答に影響するデータの問題を解決する。
- ナレッジ引用がエージェント応答に表示されるよう設定する。
設定エラーを解決する
設定とデータの問題は、Agentforce エージェントのパフォーマンスが低下する最も一般的な原因の 2 つです。どちらも、アクションやプロンプトに手を加えることなく修正できる場合がほとんどです。
症状としては、設定されたワークフローをエージェントが実行しない、「Access Denied (アクセスが拒否されました)」または「Insufficient Privileges (アクセス権がありません)」といったエラーが発生する、UI に AI アクションが表示されない、などが挙げられます。一般的な原因としては、ユーザー権限またはインテグレーション権限の不足、フローオーケストレーションまたは Agentforce の機能が有効になっていない、オブジェクトレベルのアクセス権が正しくない、などが考えられます。
- まず権限を確認します。エージェントユーザーのプロファイルまたは権限セットに、フロー、Apex、またはプロンプトテンプレートを通じてエージェントが操作する各オブジェクトに対して最低レベルのオブジェクト権限が含まれていることを確認します。フローをデバッグするときは、必ずエージェントユーザーとして実行し、見落としている可能性のある権限の問題を確認します。Apex については、エージェントが使用する Apex クラスのセキュリティをエージェントユーザーのプロファイルに拡張します。考慮すべきアクセス権と制御についての詳細は、「Configure Service Agent Access (サービスエージェントアクセスの設定)」を参照してください。
- 次に、Salesforce の [Setup (設定)] で、ワークフローに必要な Agentforce の機能が実際に有効になっているかどうかを確認します。
ベストプラクティスとして、Agentforce と AI に関連するすべてのユーザーを、一元管理用の 1 つの権限セットグループに割り当てることをお勧めします。これにより、アクセス権の一貫性が保たれ、将来の監査も大幅に効率化されます。
データエラーをトラブルシューティングする
Agentforce の問題がすべてプロンプト作文やルーティングに関するものとは限りません。エージェントの設定は正しくても、エージェントに供給されるデータや連携しているシステムが実際の問題であることがあります。
データエラーは、不完全または無関係な応答、AI が生成した不正確なインサイト、または必要な値が欠落しているために自動化処理が失敗するといった形で現れます。よくある原因としては、Data 360 の同期の遅延や一時停止されたデータストリーム、null または古い項目の値、レコード間のリレーションの不整合などが挙げられます。
- まず、Data 360 のデータストリームを確認し、ソースが有効で同期されていることを確認します。
- 次に、ソースシステムと Data 360 データモデル間の項目の対応付けを確認します。対応付けが壊れていると、データが気づかないうちに欠落したり変更されたりすることがあります。
- 最後に、SOQL クエリやレポートを実行して、欠落しているレコード、null のレコード、古いレコードを直接確認します。
ベストプラクティスとして、問題がエージェントに到達する前に検出できるよう、データ品質ルールとアラートを設定してください。
ナレッジ引用が表示されない問題を修正する
エージェント応答に引用元が表示されない場合は、コンテンツが利用できないと判断する前に、次の設定を確認してください。
- [Answer Questions with Knowledge (ナレッジを使用して質問に回答)] アクションの設定を開き、引用が有効になっていることを確認します。
- アクションを単独でテストし、引用元が返されることを確認します。
- フローの後続の処理で応答が上書きされていないことを確認します。
- 参照元のナレッジ記事が公開され、インデックス付けされていて、エージェントからアクセス可能な状態であることを確認します。
だんだんコツをつかんできましたね。次は、ルーティング、アクション、プロンプト作文に関する問題です。
リソース
- Salesforce ヘルプ: Agentforce: Common Agentforce Behavior Issues and How to Resolve Them (Agentforce: Agentforce のよくある動作の問題とその解決方法)
- Salesforce ヘルプ: Agentforce: How to Troubleshoot Common Agentforce Errors (Agentforce: Agentforce のよくあるエラーのトラブルシューティング方法)
- Salesforce ヘルプ: Answer Questions with Knowledge (ナレッジを使用して質問に回答)
- Salesforce ヘルプ: Show Sources When Using Answer Questions with Knowledge Standard Action ([ナレッジを使用して質問に回答] 標準アクションの使用時にソースを表示)
- Salesforce ヘルプ: Build Trust in AI Responses with Citations (引用を使用して AI の応答に信頼性を持たせる)
- Salesforce ヘルプ: Configure Citation Mode for Custom Actions (カスタムアクションの引用モードの設定)