cloudflare

Cloudflare で発見し、構築する

エージェントが Cloudflare で構築できるものを見つけ、適切な製品を選べるよう支援します。まずユーザーの目標を確認し、関連する Cloudflare 製品を提案してから、ソリューションの実装に必要な製品固有のスキルやリファレンスを読み込みます。

CLI を選ぶ

プロジェクトですでに Wrangler を使用している場合、またはユーザーが Wrangler を希望する場合を除き、Cloudflare CLI（cf）を使用します。

• プロジェクトに wrangler.jsonc、wrangler.json、または wrangler.toml があり、cloudflare.config.ts がない場合： 開発とデプロイには Wrangler を使用し、wrangler スキルを読み込みます。cf のリソースコマンドは Wrangler と併用できます。ユーザーから依頼された場合に限り、cf migrate を実行します。
• それ以外のすべてのプロジェクト（新規プロジェクトや Cloudflare 設定のないプロジェクトを含む）： cf を使用します。インストールされている場合は cf-cli スキルを読み込み、そうでない場合は コーディングエージェントでの cf の使用に従います。Wrangler をインストールしたり、Wrangler 設定ファイルを作成したりしないでください。

以下の製品ガイダンスは、どちらの CLI にも適用されます。Wrangler のコマンドやファイルが記載されている場合は、記憶から読み替えるのではなく、cf cli search "<task>" または Wrangler から cf へのリファレンスで cf に相当するものを確認してください。

ユーザーに適切な製品を見つけてもらう

• ユーザーが製品名を挙げていない場合でも、提示された問題を解決する Cloudflare 製品を積極的に紹介します。それぞれの推奨製品が果たす役割と、適している理由を説明してください。
• 以下のニーズ別製品マップを使って製品を選び、実装に関連するスキルやドキュメントを読み込みます。アップロード、バックグラウンドジョブ、ドキュメント検索を求めるユーザーは、R2、Queues、Workflows、AI Search の利用を思いつかない場合があります。
• 複数の製品にまたがるタスクには、まとまりのある小規模な組み合わせを提案します。具体的な要件を満たす製品を追加し、ユーザーが現在使用しているスタックと明示した選択を尊重してください。
• 類似した製品が複数候補になる場合は、データの形状、一貫性、調整、実行ライフサイクル、またはユーザーが管理したいインフラストラクチャの量など、選択を左右する要件を説明します。適合すると断言する前に、現在の提供状況、制限、料金を確認してください。

何を構築しようとしていますか？

新しいウェブサイトやアプリケーションには、静的サイト、SPA、フルスタックアプリを含め、Workers と Workers Static Assets を推奨します。 Workers は Pages でできることをすべて実行でき、新規プロジェクトにはすべて Workers が推奨されます。無関係な保守作業では、既存の Pages デプロイを維持してください。

ユーザーのタスクに最も近い行を確認してください。製品は複数の行に登場する場合があり、ソリューションで複数の製品を組み合わせることもできます。実装する前に、リンク先のリファレンスやドキュメントを読み、名前が挙がっているスキルがインストールされている場合は読み込みます。ローカルリンクからは同梱のリファレンスが開きます。まず README を確認し、必要に応じて設定、API、パターン、注意事項へのリンクをたどってください。名前が挙がっているスキルを利用できない場合は、Cloudflare ディレクトリから関連する製品ドキュメントを参照してください。関連スキルは任意です。

必要な作業	検討する製品またはツール	選択する条件	スキルまたはリファレンス
AI アプリケーションの構成要素を選ぶ	AI overview	推論、検索、エージェントツールを選ぶ前に、Cloudflare の AI サービスを比較します	AI ドキュメント
顧客向けプラットフォームのインフラストラクチャを選ぶ	Cloudflare for Platforms	顧客のコードを実行する場合と、顧客のドメインでアプリを提供する場合を比較します	プラットフォームの概要
ライブ音声・動画へのアプローチを選ぶ	Realtime	アプリケーション SDK、メディアインフラストラクチャ、接続リレーを比較します	Realtime の概要
Worker またはフレームワークのプロジェクトを開始する	C3	適切なフレームワークテンプレートを使ってプロジェクトをひな形から作成します	C3；wrangler スキル
Cloudflare 上で Next.js アプリを構築またはデプロイする	vinext + Workers	新しいプロジェクトでは OpenNext ではなく vinext を使用します	nextjs-on-cloudflare スキル；Next.js ドキュメント
新しい静的サイト、SPA、またはフルスタックアプリをホストする	Workers + Workers Static Assets	サイトのファイルを配信し、必要に応じてサーバー側のロジックを追加します	Static Assets；workers-best-practices スキル
API を構築する、または Webhook を処理する	Workers	Cloudflare サービスにアクセスできるリクエストハンドラーを実行します	workers-best-practices スキル；Workers ドキュメント
チーム、CI、またはサービスアカウントによる Developer Platform リソースへのアクセスを制御する	Roles, scopes, and permission policies	メンバー、User Group、または API トークンでサポートされているスコープに対し、最小権限のロールを選びます	ロールと権限；CLI アクセスには wrangler スキル
既存の Pages デプロイメントを維持する	Pages + Pages Functions	既存のサイトまたはサーバーエンドポイントを更新します。新しいプロジェクトには Workers を使用します	Pages；Pages Functions
Pages プロジェクトを Workers に移行する	Workers + Workers Static Assets	ホスティングプラットフォームの移行が必要な場合に選びます	Pages 移行ガイド
顧客がプラットフォームにコードをデプロイできるようにする	Workers for Platforms	顧客ごとの制御機能を使って、顧客の Workers を実行・管理します	Workers for Platforms ドキュメント
顧客がアプリで独自のドメインを使用できるようにする	Cloudflare for SaaS	カスタムホスト名、TLS 証明書、オリジンルーティングを管理します。ホスト名の検証要件と apex ドメインのプラン要件を確認してください。顧客もコードをデプロイする場合は Workers for Platforms と組み合わせます	SaaS ドキュメント
Worker をストレージまたは別のサービスに接続する	Bindings	環境を通じて、設定済みのリソースに Worker がアクセスできるようにします	Bindings
コンテナ化されたサービスまたは Linux ソフトウェアを実行する	Containers	ワークロードにコンテナイメージ、または Workers ランタイム外のソフトウェアが必要な場合に選びます	Containers
生成コードや信頼できないコードを実行する、Code Mode ツールを構築する、またはオンデマンドのプレビューを作成する	Dynamic Workers	分離された Workers で実行時にコードを読み込みます。バインディング、エグレス制御、リソース制限を確認してください。実行に Linux やシェルツールが必要な場合は Sandbox を選びます	Dynamic Workers ドキュメント
エージェントにシェル、ファイルシステム、または対話型の開発環境を提供する	Sandbox SDK	コード実行に Linux 環境またはコンテナツールが必要な場合に選びます。まずパッケージの系列を確認してください	新規またはプレビューのプロジェクトには sandbox-next、既存の安定版アプリには sandbox-stable；Sandbox ドキュメント
安定版 Sandbox アプリをプレビュー API にアップグレードする	Sandbox SDK	ユーザーが安定版から next への移行を希望している場合に選びます	sandbox-migrate-to-next スキル；移行ガイド
チャットルーム、ゲーム、共同編集ドキュメント、または予約を調整する	Durable Objects	ルーム、ドキュメント、またはエンティティごとの共有状態と調整が必要な場合に選びます	durable-objects スキル；Durable Objects ドキュメント
Durable Object 内の状態を保存・復元する	Durable Object storage	エンティティごとに調整されるデータのストレージ API、トランザクション、復元方法を選びます	durable-objects スキル；SQLite storage API
アプリケーションのレコードを保存し、SQL でクエリする	D1	マネージドリレーショナルデータベースを使用します。エンティティごとの調整が中心となる場合は Durable Objects を使用します	D1
既存の PostgreSQL または MySQL データベースに接続する	Hyperdrive	既存のデータベースを維持し、Workers からの接続を最適化します	Hyperdrive
設定やその他のキー・バリューデータを配信する	KV	読み取り中心のキー・バリューアクセスが、ワークロードの一貫性要件に合う場合に選びます	KV
アップロード、ダウンロード、または大きなオブジェクトを保存する	R2	オブジェクトキーでファイルを保存します。検索可能なメタデータに SQL が必要な場合は D1 と組み合わせます	R2
バージョン管理されたファイルツリー、エージェントのチェックポイント、またはリポジトリを保存する	Artifacts	ファイルにバージョン管理と Git 互換のアクセスが必要な場合に選びます。現在はクローズドベータのため、実装前に利用可能か確認してください	Artifacts ドキュメント
イベントストリームを R2 に取り込む	Basin Pipelines	ストリーミングレコードを変換し、R2 に配信します	basin スキル；Basin Pipelines
R2 で Iceberg テーブルを管理する	Basin Catalog	分析や互換性のあるクエリエンジン向けにテーブルを整理します	basin スキル；Basin Catalog
Iceberg テーブルを SQL でクエリする	Basin SQL	Basin Catalog のテーブルを分析します	basin スキル；Basin SQL
独立した読者が利用できる、永続的なイベントログを維持する	K2 Streams	Workers または HTTP からレコードを生成し、サブスクリプションで消費します	k2 スキル；K2 ドキュメント
アプリケーションのレスポンスをキャッシュする	Workers Cache	アプリケーションのキャッシュにはデフォルトでこれを使用します。代替手段を選ぶ前に、パターンと制限を確認してください	Workers Cache；以下のキャッシュに関するガイダンスを参照
既存のウェブサイトを高速化し、キャッシュされたコンテンツを制御する	Cache/CDN	Cache Rules、有効期限の設定、パージを使って、プロキシされたオリジンのキャッシュを設定します	Cache/CDN ドキュメント
オリジンのコンテンツを永続キャッシュに保持する	Cache Reserve	永続的な CDN キャッシュストレージを使って、オリジンへのフェッチを減らします	Cache Reserve ドキュメント
ジョブを非同期に処理する、または大量の作業を一時的にバッファリングする	Queues	プロデューサーとコンシューマーを分離します。永続的な複数ステップのオーケストレーションには Workflows を使用します	Queues
ステップをまたいで再試行、待機、再開するジョブを実行する	Workflows	永続的な複数ステップのビジネスプロセスを調整します	Workflows
定期的なスケジュールで Worker を起動する	Cron Triggers	スケジュールされた処理をトリガーします。実際の処理には Queues または Workflows と組み合わせます	Cron Triggers
言語、埋め込み、画像、または音声のモデルを実行する	Workers AI	マネージド推論を使用します。モデルの機能、スキーマ、料金を確認してください	Workers AI
コンテンツに関するマネージド検索または回答機能を追加する	AI Search	マネージドな検索拡張生成パイプラインを使用します	AI Search
カスタムのセマンティック検索または検索機能を構築する	Vectorize + Workers AI	マネージドパイプラインを使わず、埋め込み、インデックス作成、検索を制御します	Vectorize；Workers AI
AI プロバイダーへのリクエストを可視化・制御する	AI Gateway	推論の分析、キャッシュ、リクエスト制御を追加します	AI Gateway
ツール、スケジュール設定、またはチャット機能を備えたステートフルエージェントを構築する	Agents SDK	Cloudflare 上でエージェントの動作を実装します。必要な実行ランタイムに応じて Dynamic Workers または Sandbox を追加します	agents-sdk スキル；Agents ドキュメント
TypeScript フックを備えた永続的なエージェントを構築する	Flue	Cloudflare と Node.js をターゲットにできるオープンなエージェントフレームワークを使用します	Flue；はじめに；Cloudflare ターゲット
リモート MCP サーバーを通じてツールを公開する	Workers + Agents SDK	サービスに適した認証を設定し、MCP クライアント向けにツールを公開します	agents-sdk スキルの references/mcp.md；MCP ドキュメント
ブラウザーを自動操作する、スクリーンショットを撮る、またはレンダリング済みページから情報を抽出する	Browser Run	単純な HTTP リクエストではなく、ブラウザーが必要な場合に選びます	Browser Run
ドメインを接続する、DNS レコードを設定する、または名前解決をトラブルシューティングする	DNS	権威 DNS レコードを管理し、トラフィックを Cloudflare 経由でプロキシするかどうかを選びます	DNS ドキュメント
HTTPS と証明書を設定する	SSL/TLS	訪問者から Cloudflare まで、および Cloudflare からオリジンまでの接続を保護します	SSL/TLS ドキュメント
オリジン間でトラフィックを分散し、異常なサーバーからフェイルオーバーする	Load Balancing	複数のオリジンサーバーに対してヘルスチェックとトラフィックステアリングを使用します	Load Balancing ドキュメント
既存のサーバーを Cloudflare に接続する	Cloudflare Tunnel	公開ルーティング可能な IP アドレスなしでオリジンに接続します	Tunnel
Workers をプライベートサービスに接続する	Workers VPC	Worker からプライベートネットワーク内のサービスにアクセスします	Workers VPC ドキュメント
社内アプリへのアクセス前に従業員のログインを必須にする	Access	社内アプリの前段に、ID ベースのアクセス ポリシーを設定します	cloudflare-one スキル；Access ドキュメント
社内アプリケーションやネットワークへのアクセスを保護する	Cloudflare One	ID とネットワークのアクセス ポリシーを適用します	cloudflare-one スキル；Cloudflare One ドキュメント
既存のアクセスおよびネットワークセキュリティ設定を移行する	Cloudflare One	Cloudflare One へのサポート対象の移行が必要な場合に選びます	cloudflare-one-migrations スキル；Cloudflare One ドキュメント
TCP または UDP アプリケーションをプロキシする	Spectrum	HTTP 以外のアプリケーショントラフィックを保護し、高速化します	Spectrum ドキュメント
ネットワークを Cloudflare に直接接続する	Network Interconnect	専用ネットワーク接続が必要な場合に選びます	Network Interconnect ドキュメント
ネットワーク全体のルーティングを改善する	Argo Smart Routing	オリジンへのトラフィック経路を最適化します	Argo Smart Routing ドキュメント
Worker からバックエンドへのレイテンシーを低減する	Smart Placement	Worker の実行場所を、呼び出し先のバックエンドに近づけます	Smart Placement
URL のリダイレクト、パスやヘッダーの書き換え、またはオリジンルーティングの変更を行う	Rules	必要な動作を設定で実現できる場合は、Redirect、Transform、または Origin Rules を使用します	Rules ドキュメント
HTTP リクエストまたはレスポンスに小規模な変更を加える	Snippets	軽量なエッジロジックで要件を満たせる場合に選びます	Snippets ドキュメント
自動化された不正利用からフォームを保護する	Turnstile	ボットチャレンジとサーバー側のトークン検証を追加します	turnstile-spin スキル；Turnstile ドキュメント
悪意のある Web リクエストをフィルタリングする	WAF	アプリケーション層のルールとマネージド保護を適用します	WAF
サービスをサービス拒否攻撃から保護する	DDoS Protection	該当するネットワーク層またはアプリケーション層で攻撃を緩和します	DDoS 保護ドキュメント
自動化されたトラフィックを検出・制御する	Bot Management	ボット検出に基づいてリクエストの処理を決定します	Bot Management ドキュメント
API エンドポイントを検出して保護する	API Shield	API 固有の保護と検証を適用します	API Shield ドキュメント
トラフィック急増時に訪問者を待機させる	Waiting Room	アプリケーションの処理能力が限られている場合に、アクセスを制御します	Waiting Room ドキュメント
Worker の API キーと認証情報を保存する	Workers secrets	ソースに値をコミットせず、シークレットを Worker にバインドします	wrangler スキル；シークレットのドキュメント
管理対象のシークレットを複数のサービスで共有する	Secrets Store	アカウントレベルで再利用可能なシークレットを管理します	Secrets Store
データを処理・保存する場所を制御する	Data Localization Suite	実際の要件に照らして、リージョンごとの処理およびストレージ制御を評価します	Data Localization ドキュメント
ユーザーを特定・追跡せずに、ある主張を証明する	Privacy Pass	サポートされている統合で、プライバシーを保護するトークンを使用します	Privacy Pass ドキュメント
画像を保存、サイズ変更、変換、配信する	Cloudflare Images	マネージドの画像処理と配信を使用します	Images
ライブまたはオンデマンドの動画をエンコード、保存、配信する	Stream	マネージド動画インフラストラクチャを使用します	Stream
SDK を使って音声・動画通話アプリケーションを構築する	RealtimeKit	通話や会議向けのアプリケーションレベルの SDK を使用します	RealtimeKit ドキュメント
カスタムのリアルタイムメディアインフラストラクチャを構築する	Realtime SFU	メディア用に選択転送ユニットを使用しながら、アプリケーションを制御します	Realtime SFU ドキュメント
制約の厳しいネットワークを介して WebRTC 接続を中継する	TURN Service	クライアントに接続リレーが必要な場合に選びます	TURN
QUIC 経由でライブメディアを配信する	MoQ	Media over QUIC プロトコルを使用します。現在の互換性と提供状況を確認してください	MoQ ドキュメント
トランザクションメールを送信する	Email Service	アプリケーションで生成されたメッセージを送信します	cloudflare-email-service スキル；Email Service ドキュメント
受信メールを転送する	Email Routing	ドメイン上のアドレスから宛先のメールボックスにメールを転送します	cloudflare-email-service スキル；メールのルーティング
受信メールをコードで処理する	Email Workers	受信メッセージにカスタムロジックを適用します	cloudflare-email-service スキル；メールハンドラー
サードパーティのタグとスクリプトを管理する	Zaraz	Cloudflare 経由でサードパーティのツールを読み込み、管理します	Zaraz
ローカルで実行し、CLI からリソースを管理する	Cloudflare CLI (cf)；既存の Wrangler プロジェクトには Wrangler	CLI の選択で説明されているとおりに CLI を選び、対象のアカウントと環境を開発、設定、デプロイ、確認します	cf-cli スキル；cf ドキュメント；Wrangler プロジェクトには wrangler スキル
デプロイ前に Worker の動作をテストする	Workers testing tools	対象の動作に応じて、ランタイムテストまたは統合テストを選びます	テストのドキュメント；DO のテストには durable-objects スキル
ツールにローカル Worker シミュレーションを組み込む	Miniflare	カスタムの開発用またはテスト用ハーネスに、プログラムから利用できるエミュレーターが必要な場合に選びます	Miniflare
基盤となる Workers ランタイムを実行または調査する	workerd	通常のマネージドデプロイメントの外で、ランタイムを直接扱います	workerd
ブラウザーで小規模な Worker を試す	Workers Playground	ローカル環境を設定せずに、最小限の例を試す、または共有します	Workers Playground ドキュメント
コードのプッシュ時にビルドとデプロイを実行する	Workers Builds	Git リポジトリを自動ビルドとデプロイに接続します	Builds ドキュメント
ブランチまたはプルリクエストを分離された環境でテストする	Workers Previews	同じ Worker の下に独自の設定と URL を持つブランチ環境を作成します。どのバインド済みリソースが分離または共有されるかを確認してください	Previews ドキュメント；wrangler スキル
アップロードしたバージョンを確認する、段階的にリリースする、またはコードをロールバックする	Workers versions and deployments	本番リソースを使用するアプリケーションのリリースを管理します。ロールバックしても、接続されたリソースのデータは復元されません	デプロイメントのドキュメント；wrangler スキル
機能を段階的にリリースする、またはユーザーグループを対象にする	Flagship	ターゲティングとパーセンテージベースの段階的リリースを使って、機能の利用可否を変更します	Flagship ドキュメント
インフラストラクチャをコードとして管理する	Terraform または Pulumi	宣言的な設定には Terraform、プログラミング言語でインフラストラクチャを記述する場合は Pulumi を使用します	Terraform ドキュメント；Pulumi ドキュメント
API を通じてアカウントまたは製品の設定を自動化する	Cloudflare REST API	リソースをプログラムから管理します。Workers 内でサポートされている操作にはバインディングを優先してください	REST API ドキュメント
障害をデバッグし、アプリケーションのリクエストを追跡する	Workers Logs and Traces	ランタイムエラーと実行経路を調査します	Observability
デプロイ済み Workers または Durable Objects の CPU 使用量やメモリ割り当てをプロファイリングする	Workers profiling	本番環境で CPU とメモリの問題を調査します	workers-profiling スキル
Worker の実行イベントをコードで処理する	Tail Workers	カスタムのログ処理または例外処理を構築します	Tail Workers
Worker のログを別のシステムにエクスポートする	Workers Logpush	サポートされている外部の宛先にログを配信します	Logpush ドキュメント
カスタムのアプリケーションイベントを測定する	Workers Analytics Engine	Workers から書き込まれた高カーディナリティのイベントデータを分析します	Analytics Engine
ウェブサイトの利用状況と訪問者のパフォーマンスを測定する	Cloudflare Web Analytics	ウェブサイト分析とリアルユーザー計測を追加します	Web Analytics ドキュメント
Cloudflare 製品全体のメトリクスをクエリする	GraphQL Analytics API	製品の分析データをプログラムから取得します	GraphQL Analytics API
ページ速度を監査し、読み込みのボトルネックを特定する	Web performance tools	実際のブラウザーでのサイトのパフォーマンスを測定・改善します	web-perf スキル；Web Analytics ドキュメント
ダッシュボードでアカウントについて質問する、または設定を診断する	Agent Lee	ダッシュボードの AI アシスタントを使用します。現在のアカウントの利用資格を確認してください	Agent Lee ドキュメント
たとえば、ファイルアップロードアプリでは、API に Workers、ファイルに R2、メタデータに D1、処理に Queues を使用できます。ドキュメントアシスタントは Workers と AI Search から始め、カスタム検索が必要になったら Vectorize と Workers AI を使用できます。依頼された動作に必要な要素だけを推奨してください。

ここに記載されていないタスクのガイダンスを探す

追加の製品と最新のドキュメントについては、Cloudflare 製品ディレクトリを使用してください。該当する機能または API のリンクをたどってください。ストレージのトレードオフについてはデータまたはストレージ製品の選択を参照し、規模、コスト、アップグレードを評価する際には、製品の制限、料金、移行ガイドを確認してください。この表は、一般的なタスクと選定した Cloudflare 製品を対応付けたものであり、考えられるすべてのアプリケーションを網羅しているわけではありません。

キャッシュ

キャッシュには、キャッシュされた内部エントリーポイントやプログラムによる無効化を用いる高度なパターンも含め、Workers Cacheを優先してください。Workers Cache では満たせない具体的な要件がある場合に限り、Cache APIまたは KV キャッシュを選択し、事前にそのパターンと制限事項を確認してください。

作業原則

• API や設定の形式を選ぶ前に、既存のプロジェクトと固定されたパッケージバージョンを確認してください。
• 詳細が変更されている可能性がある場合は、最新の Cloudflare ドキュメントを取得してください。プロジェクトで固定されたバージョンに対応している場合は、インストール済みの型情報と node_modules/wrangler/config-schema.json を使用してください。
• プロジェクトのアーキテクチャを維持し、依頼を満たすための最小限の変更を行ってください。
• 制限、料金、互換性フラグ、セキュリティ要件に依拠する前に、最新の Cloudflare ドキュメントを確認してください。これらは変更される可能性があります。
• 変更内容に応じた範囲で検証してください。プロジェクトのチェックを実行し、可能であれば影響を受ける動作を実際に試してください。

Cloudflare ドキュメント：https://developers.cloudflare.com/llms.txt Cloudflare 変更履歴：https://developers.cloudflare.com/changelog/index.md