Skip to main content
Salsify 組織を接続すると、Profound Agents で以下のノードが利用可能になります。これらのノードを使用して、Salsify の Product List から商品コンテンツを読み取り、他の Agent ノードで改善し、書き戻して、完了した商品を記録できます。 すべてのノードは Salsify Organization で選択した組織に対して実行され、API キーを所有する Salsify ユーザーの権限を使用します。
Agents を初めてお使いの場合は、Profound Help Center の Getting started with Agents をご覧ください。

​
利用可能なノード

​
List Products

1 つ以上の Salsify Product Lists から商品を 1 ページ分読み取ります。Product List の範囲指定は常に必須で、Profound が Salsify 組織全体を読み取ることはありません。

​
必須の入力

  • Salsify Organization — ドロップダウンから接続済みの組織を選択します
  • Product Lists — 読み取り元の Product Lists の ID

​
オプションの入力

​
出力

商品の data 配列と、ページネーションの詳細および一致する商品の総数を含むメタデータオブジェクトを持つ JSON オブジェクト。
Product Lists と Excluded Lists を組み合わせて、作業キューを構築できます。ソースリストを読み取り、宛先リストを除外することで、各実行ではまだ完了していない商品のみが返されます。

​
作業キューを構築する

Salsify ノードはループとして実行するように設計されています。各実行では、ソースリストから商品のバッチを取得し、コンテンツを改善して Salsify に書き戻し、完了した商品を宛先リストに移動します。この作業キューにより、1 つの Agent で商品カタログ全体をバッチごとに改善できます。 以下は作業キューの例です。
1

ソースリストと宛先リストを作成する

Salsify で 2 つの Product Lists を作成します(例: Profound: to optimize と Profound: optimized)。作業対象の商品を to optimize リストに追加し、optimized リストは空のままにします。
2

List Products でソースリストを読み取る

List Products ノードを追加します。Product Lists に to optimize リストの ID を、Excluded Lists に optimized リストの ID を入力します。これにより、完了済みの商品が再度読み取られることはありません。
3

コンテンツを改善する

商品をコンテンツノード(Prompt LLM など)に渡し、各商品レコードのマーケティングコピーを書き直します。
4

Update Products でコンテンツを書き戻す

Update Products ノードを追加します。各商品について、Product ID と、新しいコピーで更新するプロパティを設定します。
5

Add Products to List で完了した商品を記録する

optimized リストの ID と今回の実行の商品 ID を指定して、Add Products to List ノードを追加します。これで、Salsify のこの Product List が進捗レポートになります。
6

Remove Products from List でキューから商品を削除する

to optimize リストの ID と同じ商品 ID を指定して、Remove Products from List ノードを追加します。商品はキューから外れますが、Salsify には残ります。

​
トラブルシューティング

  • まず Salsify Organization を選択してください。選択するまでピッカーは無効のままです。
  • Sample product ID を入力してください。ピッカーにはその 1 つの商品のプロパティが一覧表示されるため、書き込みたいプロパティを持つ商品を使用してください。
  • ピッカーに Available when the payload below is a list of products と表示される場合、Products のペイロードがテキストまたは変数になっています。編集するには、Data format を Raw JSON に切り替えてください。
  • Product List ID が、URL の product_lists/ の後、クエリパラメーター(?)の前にある部分であることを確認してください。
  • そのリストが Salsify にまだ存在することを確認してください。
  • Advanced Filter を使用している場合は、有効な Salsify フィルター式であることを確認してください。
  • Product List ID を確認してください。似た名前のリストが 2 つある場合があります。
  • Property Equality の条件や Advanced Filter によって、すべての商品が除外されていないことを確認してください。
  • 商品をリストに追加したばかりの場合は、しばらく待ってからノードを再度実行してください。Salsify は変更を非同期で適用するため、List Products ノードにまだ変更が反映されていない可能性があります。
プロパティ ID は大文字と小文字が区別されます。プロパティピッカーまたは Get Product ノードの出力から正確な ID をコピーしてください。新しいプロパティの場合は、先に Salsify で作成してください。
バッチ内の商品に、組織の商品 ID を保持するプロパティが欠けています。バッチ内のすべての商品に、一意の値でそのプロパティを追加してください。
Salsify にそれらの商品 ID のレコードがありません。List Products ノードで ID を読み取り、正しいことを確認してください。
Page または Results per Page を減らすか、読み取り範囲をより小さな Product List に絞ってください。あるいは、常に最初のページのみを読み取る作業キューを構築してください。
Salsify はリストのメンバーシップを非同期で更新します。しばらく待ってから、ノードを再度実行してください。
エラーには、制限がリセットされるまでの残り秒数が表示されます。しばらく待ってから、Agent を再度実行してください。レート制限に達しないようにするには、1 ページあたりに読み取る商品数を増やし、同時に実行する Salsify ノードの数を減らしてください。