Summary

Cloudflare AI Searchにカスタムメタデータフィルタリング機能が追加されました。この機能により、独自のメタデータフィールドを定義し、カテゴリ、バージョン、その他のカスタム属性に基づいて検索結果をフィルタリングできるようになります。

Key Points

カスタムメタデータスキーマの定義: AI Searchインスタンスごとに最大5つのカスタムメタデータフィールドを定義可能
データ型のサポート: text、number、booleanの3つのデータ型に対応
データソース別のメタデータ設定:
- R2バケット: S3互換のカスタムヘッダー（x-amz-meta-*）を使用
- ウェブサイト: HTMLページに<meta>タグを追加
検索クエリでのフィルタリング: カスタムフィールドと組み込み属性（folder、timestampなど）を組み合わせて使用可能
API経由での設定: REST APIを使用してメタデータスキーマの定義と検索フィルタリングを実行

claudejamodel: claude-sonnet-4-20250514

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

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)をご覧ください。

AI Search - Custom metadata filtering for AI Search