Skip to content

非公式 / UnofficialCloudflare, Inc. 非提携。アカウント情報は入力しないでください。Not affiliated with Cloudflare, Inc. Do not enter Cloudflare credentials here.Official docsこのサイトについてプライバシー

公開エンドポイント

最終更新 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 — エンドポイントに到達する前に呼び出し元の認証を要求します。

役に立ちましたか?