AI Search用カスタムメタデータフィルタリング

2026年3月23日

AI Searchでカスタムメタデータフィルタリングがサポートされ、独自のメタデータフィールドを定義し、カテゴリ、バージョン、または定義したカスタムフィールドなどの属性に基づいて検索結果をフィルタリングできるようになりました。

カスタムメタデータスキーマの定義

AI Searchインスタンスごとに最大5つのカスタムメタデータフィールドを定義できます。各フィールドには名前とデータ型（text、number、またはboolean）があります：

curl -X POST https://api.cloudflare.com/client/v4/accounts/{ACCOUNT_ID}/ai-search/instances \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -d '{
    "id": "my-instance",
    "type": "r2",
    "source": "my-bucket",
    "custom_metadata": [
      {
        "field_name": "category",
        "data_type": "text"
      },
      {
        "field_name": "version",
        "data_type": "number"
      },
      {
        "field_name": "is_public",
        "data_type": "boolean"
      }
    ]
  }'

ドキュメントへのメタデータの追加

メタデータの添付方法はデータソースによって異なります：

• R2 bucket: オブジェクトをアップロードする際にS3互換のカスタムヘッダー（x-amz-meta-*）を使用してメタデータを設定します。例については[R2 custom metadata](R2 custom metadata)を参照してください。
• Website: HTMLページに<meta>タグを追加します。詳細については[Website custom metadata](Website custom metadata)を参照してください。

検索結果のフィルタリング

検索クエリでカスタムメタデータフィールドを、folderやtimestampなどの組み込み属性と併用できます：

curl https://api.cloudflare.com/client/v4/accounts/{ACCOUNT_ID}/ai-search/instances/{NAME}/search \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -d '{
    "messages": [
      {
        "content": "How do I configure authentication?",
        "role": "user"
      }
    ],
    "ai_search_options": {
      "retrieval": {
        "filters": {
          "category": "documentation",
          "version": {
            "$gte": 2.0
          }
        }
      }
    }
  }'

詳細については[metadata filtering documentation](metadata filtering documentation)をご覧ください。