レコメンデーションをフィルタリングする

構造化データを使用しているレコメンデーションアプリがある場合は、ドキュメントフィールドを使用してレコメンデーション結果をフィルタできます。このページでは、ドキュメントフィールドを使用して、特定のドキュメントセットにレコメンデーションをフィルタする方法について説明します。このページの例はメディアレコメンデーション用ですが、ここで説明する原則は汎用レコメンデーションでも同じです。メディアレコメンデーション機能の詳細については、メディア向け Vertex AI Search の概要をご覧ください。

レコメンデーションとデータストアの更新をフィルタする

データストアが更新された後、モデルが再トレーニングされるまで最大 8 時間ほどかかります。これは、モデルがドキュメントメタデータの現在の値と、フィルタ可能として構成されているフィールドを知る必要があるためです。ドキュメントの変更とスキーマの変更が反映されるまで待つ必要があります。レコメンデーションの場合（検索とは異なり）、フィルタリングはリアルタイムで行われません。

フィルタと多様化の設定（メディアレコメンデーションのみ）

フィルタに加えて、アプリの多様化設定も、メディアレコメンデーションレスポンスで返される結果に影響します。フィルタと多様化の効果が組み合わされます。多様化が最初に行われ、次にフィルタリングが行われます。

ルールベースの多様性とカテゴリベースの属性フィルタリングを組み合わせると、空の出力になることが多いです。これは、多様性が高いと、アプリがカテゴリごとに 1 つの結果しか返せなくなるためです。

たとえば、トイストーリーに基づいて映画をおすすめするとします。ルールベースの多様性レベルを高に設定します。多様性レベルが高いため、多くの映画がおすすめとして表示される場合でも、子供向け映画のカテゴリでは 1 本の映画（WALL·E など）のみが返されます。子供向け映画のフィルタを適用すると、おすすめとして返される映画は WALL·E のみになります。

多様性の一般的な情報については、メディアレコメンデーションの多様化をご覧ください。

始める前に

レコメンデーションアプリとデータストアが作成されていることを確認します。詳細については、メディアアプリを作成するまたは汎用レコメンデーションデータストアを作成するをご覧ください。

ドキュメントの例

以下のメディアドキュメントの例をご確認ください。このページを読む際にこれらのサンプルドキュメントを参照できます。

{"id":"1","schemaId":"default_schema","structData":{"title":"Toy Story (1995)","categories":["Adventure","Animation","Children","Comedy","Fantasy"],"uri":"http://mytestdomain.movie/content/1","available_time":"2023-01-01T00:00:00Z","media_type":"movie"}}
{"id":"88125","schemaId":"default_schema","structData":{"title":"Harry Potter and the Deathly Hallows: Part 2 (2011)","categories":["Action","Adventure","Drama","Fantasy","Mystery","IMAX"],"uri":"http://mytestdomain.movie/content/88125","available_time":"2023-01-01T00:00:00Z","media_type":"movie"}}
{"id":"2857","schemaId":"default_schema","structData":{"title":"Yellow Submarine (1968)","categories":["Adventure","Animation","Comedy","Fantasy","Musical"],"uri":"http://mytestdomain.movie/content/2857","available_time":"2023-01-01T00:00:00Z","media_type":"movie"}}
{"id":"60069","schemaId":"default_schema","structData":{"title":"WALL·E (2008)","categories":["Adventure","Animation","Children","Romance","Sci-Fi"],"uri":"http://mytestdomain.movie/content/60069","available_time":"2023-01-01T00:00:00Z","media_type":"movie"}}

フィルタ式

フィルタ式を使用して、レコメンデーションフィルタを定義します。

フィルタ式の構文

次のExtended Backus-Naur form は、レコメンデーションフィルタの定義に使用できるフィルタ式の構文をまとめたものです。

  # A single expression or multiple expressions that are joined by "AND" or "OR".
  filter = expression, { " AND " | "OR", expression };
  # An expression can be prefixed with "-" or "NOT" to express a negation.
  expression = [ "-" | "NOT " ],
    # A parenthesized expression
    | "(", expression, ")"
    # A simple expression applying to a textual field.
    # Function "ANY" returns true if the field contains any of the literals.
    textual_field, ":", "ANY", "(", literal, { ",", literal }, ")"
    # OR filter by "available"
    available, ":", "true",
  # A literal is any double-quoted string. You must escape backslash (\) and
  # quote (") characters.
  literal = double-quoted string;
  textual_field = see the tables below;

フィルタ式の制限

レコメンデーションのフィルタ式には、次の制限が適用されます。

AND 演算子と OR 演算子をかっこに埋め込む深さには制限があります。フィルタの論理式は連言標準形（CNF）にする必要があります。サポートされる論理式で最も複雑なものは、OR 演算子のみを含む AND 句の連結リストです（例: (... OR ... OR ...) AND (... OR ...) AND (... OR ...)）。
式は NOT キーワードまたは - で否定できます。これは、1 つの引数を持つ ANY() 式でのみ機能します。
available 制限は最上位にする必要があります。OR 句または否定（NOT）の一部として使用することはできません。使用できるのは available: true のみです。
最上位の AND 句の用語の最大数は 20 です。
OR 句には、ANY() 式に含める引数を最大 100 個まで指定できます。OR 句に複数の ANY() 式がある場合、その引数はすべてこの上限にカウントされます。たとえば、categories: ANY("drama", "comedy") OR categories: ANY("adventure") には 3 つの引数があります。

フィルタ式の例

次の表に、有効なフィルタ式と無効なフィルタ式の例を示します。無効な例が無効である理由も示します。

式	有効	メモ
`language_code: ANY("en", "fr")`	○
`NOT language_code: ANY("en")`	○
`NOT language_code: ANY("en", "fr")`	×	複数の引数を使用して `ANY()` を否定します。
`language_code: ANY("en", "fr") OR categories: ANY("drama")`	○
`(language_code: ANY("en") OR language_code: ANY("fr")) AND categories: ANY("drama")`	○
`(language_code: ANY("en") AND language_code: ANY("fr")) OR categories: ANY("drama")`	×	連言標準形ではありません。
`(language_code: ANY("en")) AND (available: true)`	○
`(language_code: ANY("en")) OR (available: true)`	×	`OR` 式の `available` を他の条件と結合します。

次のフィルタ式は、ドラマまたはアクションのカテゴリに属し、英語ではなく、利用可能なドキュメントをフィルタします。

categories: ANY("drama", "action") AND NOT language_code: ANY("en") AND available: true

フィルタリングの上限

フィルタリング可能なドキュメントフィールドごと、モデルごとにメモリが消費されます。次の上限は、サービス提供のパフォーマンスに対する悪影響を防ぐのに役立ちます。

スキーマ内で最大 10 個のカスタムフィールドをフィルタ可能に設定できます。

アプリのトレーニング中に 10 個を超えるカスタムフィールドが見つかった場合は、10 個のみが使用されます。
スキーマには、最大 100,000,000 個のフィルタ可能なフィールド値を含めることができます。

スキーマ内のドキュメント数にフィルタ可能なフィールドの数を掛けることで、スキーマ内のフィルタ可能なフィールド値の合計数を見積もることができます。これらの上限を超えると、以下が発生します。
- フィルタ可能として追加のフィールドを設定することはできません。
- アプリのトレーニングが失敗します。