Edge Functions
サーバー側コードの実行
Edge functions は、Deno runtime 上で動く JavaScript/TypeScript function です。ブラウザーで実行すべきでない、または実行できないロジックを実装できます。AI は、サーバー側処理、外部 API 連携、強化されたセキュリティが必要な機能を説明したときに、これらの function を作成します。
edge functions でできること:
- 検証と外部 API 呼び出しを含むフォーム処理
- メール送信、支払い処理、AI API 呼び出しなどのサービス連携
- ブラウザーコードから見えるべきでない機密ロジックの保護
- ユーザーに露出させずに安全にシークレットへアクセス
- ブラウザーには遅すぎる、またはリソース負荷が高すぎる複雑な操作の実行
Functions の仕組み
AI が edge function を作成するとき、次を行います。
- 説明したタスクを実行する JavaScript コードを書く
- 誰が function を呼び出せるかを決めるアクセス制御を設定
- function が外部 API 認証情報を必要とする場合、シークレットアクセスを構成
- 正しく動作することを確認するために function をテスト
- アプリケーションが 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 は決して公開すべきではありません。
関連ドキュメント: