Skip to content

非公式本サイトは非公式の日本語ドキュメントであり、Cloudflare 公式サイトではありません。最新情報はdevelopers.cloudflare.comをご確認ください。

公開エンドポイント

最終更新 Markdown で表示Agent セットアップ

AI Search の公開エンドポイントを使うと、認証なしで AI Search の機能を公開できます。公開向けアプリへの組み込みや、外部ユーザーとの共有に使えます。

公開エンドポイントを使ってサイトに埋め込める、あらかじめ用意された検索・チャットコンポーネントは UI スニペット を参照してください。

前提条件

AI Search インスタンスで公開エンドポイントを有効にします。

  1. Cloudflare ダッシュボードで AI Search に進みます。 AI Search を開く ↗
  2. AI Search インスタンスを選択します。
  3. Settings > Public Endpoint に進みます。
  4. Enable Public Endpoint をオンにします。
  5. 公開エンドポイントの URL をコピーします。

レート制限や CORS などの設定は 公開エンドポイントの設定 を参照してください。

エンドポイントのホスト名

公開エンドポイントは、単一インスタンスまたは namespace 全体に対して有効にできます。namespace エンドポイントは同じ 3 つのパスを提供し、許可したインスタンスを横断して検索し、結果をマージします。

エンドポイントを有効にすると、Cloudflare がホスト名を生成します。

ホスト名 説明
<PUBLIC_ENDPOINT_ID>.search.ai.cloudflare.com 単一インスタンスを提供します。
ns-<NAMESPACE_ENDPOINT_ID>.search.ai.cloudflare.com namespace を提供し、複数インスタンスを横断して検索します。

リクエストとレスポンスの形式はどちらも同じです。このページの例ではインスタンスのホスト名を使います。

独自ドメインを使う

生成されたホスト名の代わりに、search.example.com など所有するホスト名で同じエンドポイントを提供できます。

https://search.example.com/search
https://search.example.com/chat/completions
https://search.example.com/mcp

ホスト名は、同じ Cloudflare アカウント上のゾーンに属している必要があります。カスタムドメインを付ける手順は次のとおりです。

  1. Cloudflare ダッシュボードで AI Search に進みます。 AI Search を開く ↗
  2. インスタンスまたは namespace を選択します。
  3. Public Endpoints に進み、公開エンドポイントを有効にします。カスタムドメインには有効な公開エンドポイントが必要です。
  4. Custom Domains に進み、ホスト名を付けます。

カスタムドメインは自分のゾーン経由でリクエストをルーティングします。そのためエンドポイントの前に Cloudflare Access を置き、呼び出し元が AI Search に到達する前に認証を要求できます。Access が保護するのはカスタムホスト名だけなので、default_domain_enabled も false にしてください。そうしないと、デフォルトの <PUBLIC_ENDPOINT_ID>.search.ai.cloudflare.com ホスト名が、認証なしのリクエストに応答し続けます。

API 経由でドメインを付ける場合は カスタムドメイン を参照してください。

Chat completions

/chat/completions エンドポイントはデータソースを検索し、モデルと取得したコンテキストで応答を生成します。形式は REST API と同じ OpenAI 互換形式です。

curl https://<PUBLIC_ENDPOINT_ID>.search.ai.cloudflare.com/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "content": "How do I configure AI Search?",
        "role": "user"
      }
    ]
  }'

オプションの一覧は Chat Completions API リファレンス を参照してください。

/search エンドポイントは、応答を生成せず、データソースから関連するチャンクを返します。形式は REST API と同じです。

curl https://<PUBLIC_ENDPOINT_ID>.search.ai.cloudflare.com/search \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "content": "How do I configure AI Search?",
        "role": "user"
      }
    ]
  }'

オプションの一覧は Search API リファレンス を参照してください。

次のステップ

  • UI スニペット — あらかじめ用意された検索・チャットコンポーネントをサイトに追加します。
  • MCP — Model Context Protocol で AI エージェントを接続します。
  • 公開エンドポイントの設定 — レート制限、CORS、セキュリティを設定します。
  • カスタムドメイン — 所有するホスト名でこれらのエンドポイントを提供します。
  • Cloudflare Access — エンドポイントに到達する前に呼び出し元の認証を要求します。

役に立ちましたか？