Edge Functions

サーバー側コードの実行

Edge functions は、Deno runtime 上で動く JavaScript/TypeScript function です。ブラウザーで実行すべきでない、または実行できないロジックを実装できます。AI は、サーバー側処理、外部 API 連携、強化されたセキュリティが必要な機能を説明したときに、これらの function を作成します。

edge functions でできること:

  • 検証と外部 API 呼び出しを含むフォーム処理
  • メール送信、支払い処理、AI API 呼び出しなどのサービス連携
  • ブラウザーコードから見えるべきでない機密ロジックの保護
  • ユーザーに露出させずに安全にシークレットへアクセス
  • ブラウザーには遅すぎる、またはリソース負荷が高すぎる複雑な操作の実行

Functions の仕組み

AI が edge function を作成するとき、次を行います。

  1. 説明したタスクを実行する JavaScript コードを書く
  2. 誰が function を呼び出せるかを決めるアクセス制御を設定
  3. function が外部 API 認証情報を必要とする場合、シークレットアクセスを構成
  4. 正しく動作することを確認するために function をテスト
  5. アプリケーションが function を実行するために呼び出せる URL を提供

Functions は、分離された安全な環境で実行されます。各実行は、タイミング情報、エラー、どのユーザーが起動したかとともにログに記録されます。これらのログは Settings > Site configuration > Monitoring > Logs で表示でき、function の動作状況を監視し、問題をデバッグできます。

Functions のアクセス制御

データベーステーブルと同じように、edge functions には誰が実行できるかを制御するセキュリティポリシーがあります。AI は、構築している内容に基づいてこれを設定します。

公開 Functions

ログインしていなくても誰でも呼び出せます。Stripe 支払い通知のような webhook ハンドラー、公開 API、ヘルスチェック用エンドポイント に使います。

認証済み Functions

ログイン済みユーザーだけが呼び出せます。ほとんどの function はこのポリシーを使います。ユーザー向け機能、フォーム送信、アプリケーション向けデータ取得に適しています。

グループベースのアクセス

「admin」のような特定グループのユーザーだけが function を呼び出せます。管理操作、モデレーションツール、チーム固有機能に適しています。

メタデータベースのアクセス

カスタムユーザー属性に基づくアクセスです。たとえば、department = "engineering" を持つユーザーだけが特定の function を呼び出せます。柔軟なカスタム許可スキームを可能にします。

Functions でできること

データベースアクセス

Functions は、同じセキュリティルールをすべて適用したうえで、データベースをクエリし変更できます。

外部 API 呼び出し

Functions は、保存済みシークレットを使って外部サービスと通信できます。

複雑なロジック

Functions は、計算、データ変換、検証、複数ステップのワークフローを実行できます。

メールと通知

ユーザー操作に応じて、トランザクションメール、SMS メッセージ、push 通知を送信します。

支払い処理

Stripe のようなサービスで、支払いフロー、webhook 処理、サブスクリプション管理を扱います。

AI 連携

OpenAI や Anthropic のような AI API を呼び出し、コンテンツ生成、データ分析、知的機能の提供を行います。

監視とログ

すべての function 実行は、次の情報付きで自動的にログに記録されます。

  • 呼び出された日時と呼び出した人
  • 実行にかかった時間
  • 成功したか、エラーに遭遇したか
  • コンソール出力またはエラーメッセージ
  • 返したレスポンス

ベストプラクティス

✅ 明確に説明する - AI に function 作成を依頼するときは、何をすべきか、誰が呼び出せるべきかを具体的にします。

✅ ログを監視する - function 実行ログを確認し、パフォーマンスを理解し、早めにエラーを捕まえます。

✅ シークレットは secrets manager に保管する - AI は function にハードコードするのではなく、保存済みシークレットを使います。

❌ 機密操作を露出させない - 適切なアクセス制御を AI に構成させてください。管理 function は決して公開すべきではありません。


関連ドキュメント: