プロンプトビルダーのトラブルシューティング

プレビューまたはテストがエラーで失敗する。

[プレビュー] をクリックしてエラー (Internal Server Error など) が表示される場合は、Salesforce カスタマーサポートに連絡する前に次の項目を確認してください。

• Salesforce のエディションとアドオンにプロンプトビルダーが含まれていることを確認します。サポートされているエディションがこのページの上部に表示されます。
• Einstein が有効になっていることを確認します。[設定] から、[クイック検索] ボックスに「Einstein 設定」と入力し、[Einstein 設定] を選択します。プロンプトビルダーの有効化について説明します。
• 「プロンプトテンプレートマネージャー」または「プロンプトテンプレートユーザー」権限セットが割り当てられていること、およびこの権限セットに「Execute Prompt Templates」が含まれていることを確認します。プロンプトビルダーの有効化について説明します。
• Einstein、ライセンス、および権限を確認したがエラーが続く場合は、数分待ってからもう一度お試しください。多くの場合、この問題は一時的なサービスの中断です。サポートケースを作成する前にSalesforce Trustを確認してください。

プロンプトテンプレートはプレビューでは機能しますが、エージェントで使用すると失敗します。

プロンプトテンプレートは、プロンプトビルダーで応答を生成し、同じテンプレートが Agentforce Builder からコールされたときやエージェントの会話で実行されたときにも失敗する可能性があります。エージェントは、[プレビュー] で選択した値とは異なる入力値を渡すことができます。

• テンプレートで取得者を使用している場合は、取得者のデータソースが有効であり、取得者が自分で結果を返すことを確認します。個々の取得者について説明します。
• Agentforce データライブラリまたは非構造化ファイルでテンプレートをグラウンディングする場合は、インデックス付けが完了していることを確認します。Agentforce データライブラリのトラブルシューティングについて説明します。
• 実行時にエージェントが渡す値と同じ入力値を使用して、テンプレートを再度プレビューします。生成された応答のプレビューについて説明します。

Einstein Trust Layer が有効になっている場合、構造化された応答に項目がないか空白になっています。

Einstein Trust Layer が有効になっていて、構造化出力を使用して JSON 応答を生成すると、一部のフィールドが空またはnullになることがあります。Einstein Trust Layerは、AIモデルにプロンプトを送信する前に、名前やメール アドレスなどの個人情報をマスキングします。応答が返された後に項目が復元されない場合、空白として表示される可能性があります。

[応答] セクションで、[マスキングの詳細] を開き、マスキングされた項目と、その項目に個人識別情報が含まれているかどうかをメモします。最も一般的な原因は、個人情報をマスクすることです。構造化出力についての詳細を確認してください。マスキング設定を確認するには、「Einstein Trust Layer Settings」を参照してください。

プロンプトテンプレートで実行ユーザーのデータアクセスが使用されない。

テンプレートでユーザーに表示されるべきではないデータが返された場合や、ユーザーに表示される必要があるデータが省略された場合は、プロンプトテンプレートでデータがグラウンディングされる前にレコードを絞り込む Apex またはフローアクションを追加します。アクションの追加について説明します。

ファイルが大きすぎてグラウンディングに使用できません。

グラウンディングに使用されるファイルは 1 要求あたり 15 MB に制限され、ほとんどのモデルで 1 つ以上のファイルの種類がサポートされています。ファイルが制限を超える場合は、グラウンディングソースとしてアップロードする前に、ファイルを小さなファイルに分割するか、コンテンツを要約します。サポートされないファイルは要求から除外され、[解決] パネルに表示されます。プロンプトビルダーの制限について説明します。ファイル入力によるグラウンディングについての詳細を確認します。

[オブジェクト] 項目がありません。

[オブジェクト] フィールドが表示されるかどうかは、プロンプトテンプレートの種類によって異なります。

• Field Generation テンプレートの場合、ワークスペースを開く前に、テンプレートの作成時に Object と Object Field を選択します。項目生成プロンプトテンプレートの作成について説明します。
• Flex テンプレートの場合、オブジェクトリソースは省略可能です。後で [リソース] タブから追加します。[オブジェクト] フィールドは、初期設定画面には表示されません。Flex プロンプトテンプレートの作成について説明します。

すぐに [オブジェクト] が表示されることを期待していて、すぐに表示されない場合は、作成するテンプレートの種類を確認します。

同じプロンプトテンプレートから結果が一致しない。

プロンプトテンプレートでは、大規模言語モデル (LLM) が使用されます。AI モデルは同じ入力に対して同じ応答を返すとは限らないため、結果は実行ごとに異なる可能性があります。分類スタイルの ToDo で取得者を使用するテンプレートでも、応答を有効な JSON として解析できない場合があります。

• 同じ入力を複数回プレビューして、問題が断続的かどうかを確認します。生成された応答のプレビューについて説明します。
• 命令を具体的にし、空または予期しない値に対する明示的な処理を追加します。プロンプトテンプレートの調整について説明します。
• 同じ差し込み項目を複数回繰り返さないでください。差し込み項目を繰り返すと、結果が一貫しなくなる可能性があります。複雑なプロンプトの整理について説明します。
• 失敗が頻繁に発生する場合 (2 回の実行に 1 回など)、サポートケースを作成し、入力例を含めます。

データプロバイダーの解決中にエラーが発生しました。

Error occurred while resolving data providers; cannot describe data provider などのエラーが表示される場合は、[リソース] タブのアクションが欠落しているか、正しく設定されていないか、使用できません。プロンプトビルダーでは、これらのリソースはアクションと呼ばれます。これには、フロー、Apex、取得アクションが含まれます。

• [リソース] タブを開き、各アクションを確認します。参照されるフロー、Apex クラス、または取得者がまだ存在し、アクセス権があることを確認します。アクションの追加について説明します。
• 最近フローまたはクラスの名前を変更、削除、または無効化した場合は、プロンプトテンプレートでアクションを更新または置き換えて、保存してもう一度プレビューします。

入力を削除できない。

アクションによってまだ参照されている入力は削除できません。[リソース] タブで、入力を使用するフロー、Apex、または取得アクションを削除または更新します。次に、入力を削除します。入力の追加について説明します。

保存して有効化した後にリソースまたはフローが見つからない。

保存して有効化したら、リソースが含まれるバージョンを表示していることを確認します。テンプレートバージョンを有効化すると、そのバージョンが不変になるため、編集できなくなります。

• ページを更新し、プロンプトテンプレートワークスペースの上部にあるバージョンドロップダウンを使用して、有効化したバージョンを開きます。複数のバージョンの使用についての詳細を確認してください。
• リソースが現在有効なバージョンで保存されていることを確認します。有効化後にフローまたは Apex アクションを追加した場合は、作業を新しいバージョンとして保存し、そのバージョンを有効化します。プロンプトテンプレートの有効化と無効化について説明します。

プロンプトテンプレートを保存できない。

差し込み項目、アクション、または必須入力が有効でない場合、保存時の検証は失敗します。

• 差し込み項目の構文を確認します。たとえば、Winter '24 構文{!$account.Id}ではなく {!$Input:Account.Id} を使用します。リソースの差し込み項目構文について説明します。
• 必要なすべての入力に値があり、リソースの各アクションがまだ解決されていることを確認します。入力の追加について説明します。
• テンプレートでプロンプトビルダーパイロットのフローまたは Apex クラスを使用している場合は、現在の構文でそれらのリソースを再作成します。パイロット後のフローの変更について説明します。パイロット後の Apex クラスの変更について説明します。

応答がマスクされるか、有害なコンテンツにフラグが付けられるか、切り捨てられる。

Einstein Trust Layer は、プロンプトテンプレート応答で有害な表現がないかスキャンします。有害な言語が検出されると、[応答] セクションに有害なコンテンツバッジと警告が表示されます。プロンプトテンプレートを修正し、警告数が 0 に戻るまでもう一度プレビューします。 有害なコンテンツ通知の詳細。

応答が切断された場合、解決されたプロンプトが AI モデルで受け入れられる応答を超える可能性があります。プロンプトが大きすぎる場合、プロンプトビルダーで [解決] パネルに概要を生成できます。要約プロンプトを使用するか、テンプレートを短縮します。大きなプロンプトの操作について説明します。

応答のマスクされた値は、Einstein Trust Layer で機密データがプレースホルダーで置き換えられ、復元されるときに想定されます。[応答] セクションで [マスキングの詳細] を開き、対応付けを調べます。Data Trustとマスキングについて説明します。

プロンプトテンプレートを文書化してデバッグする必要がある。

プロンプトビルダーでは、テンプレート本文のインラインコメントはサポートされていません。バージョンを使用して変更を比較し、各バージョンで何を変更したかを簡単に記録します。

• 応答を並べて比較できるように、大幅な編集を行う前に [別名で保存] | 新しいバージョンとして保存] をクリックします。複数のバージョンの使用についての詳細を確認してください。
• 毎回同じテストレコードでプレビューし、変更した命令またはリソースをメモします。
• 複雑なロジックの場合、命令テキストを単独で [プレビュー] でテストしてから、リソースを追加してもう一度プレビューします。複雑なプロンプトの整理について説明します。