エージェントのアップグレードエラーのトラブルシューティング

データライブラリ ID に必要な形式が従来のビルダーと Agentforce Builder で異なるため、無効なデータライブラリエラーが発生する可能性があります。

knowledge.rag_feature_config_idが無効であるというエラーが表示された場合は、Agentforce Builder のエクスプローラから、アップグレードされたバージョンのエージェントにデータライブラリを手動で追加します。

エージェントスクリプトでは、ソース項目はエージェントアクションの API 参照名です。エージェントアクションに含めると、対象項目と連携して、実行するアクションとコールする参照アクション (Apex クラス、フロー、プロンプトテンプレートなどの基本機能) をエージェントに指示します。メタデータの不一致、または従来のビルダーで Agentforce Builder で不要なエージェントアクションソースに ID サフィックスが追加されたために、無効なソースエラーが発生する可能性があります。

Agentforce でエージェントアクションのソースが見つからないというエラーが表示された場合、スクリプトビューで次の手順を実行します。

• 取得元から英数字 ID サフィックスを削除します。たとえば、My_Action_1792ce20299b41c は My_Action になります。
• カスタムエージェントアクションの場合、アクションが管理パッケージから取得されていない限り、取得元項目をアクションから完全に削除することもできます。カスタムエージェントアクションでは、通常、対象項目のみを使用できます。管理パッケージのアクションでは、ソース項目の名前空間が必要になる場合があります。

アセットライブラリでアクションを使用できる場合は、エージェントからアクションを削除してから再度追加できます。または、エージェントに固有のカスタムアクションの場合は、アクションを削除して、同じ参照アクションに基づいて再作成できます。

コンテキスト変数 (リンクされた変数とも呼ばれる) は、Agentforce Builder および Agent Script で変数のソースとして識別されるオブジェクト フィールドにマッピングされます。たとえば、RoutableId 変数のソースがメッセージングセッションオブジェクトの ID 項目であるとします。コンテキスト変数を含むエージェントをアップグレードすると、エージェントスクリプトでソース項目が欠落する可能性があります。

アップグレードしたエージェントを保存または確定するときに変数のソース項目が無効または欠落していることを示すエラーが表示された場合、スクリプトビューでソースを手動で追加します。変数を使用していない場合は削除しても問題ありません。次の表に、一般的なコンテキスト変数とそのソースを示します。