邊緣函式

伺服器端程式碼執行

邊緣函式是在 Deno 執行環境上執行的 JavaScript/TypeScript 函式,讓你實作不該或無法在瀏覽器中執行的邏輯。當你描述的功能需要伺服器端處理、串接外部 API 或更高的安全性時,AI 就會建立這些函式。

邊緣函式能做到的事:

  • 處理表單,包含驗證與外部 API 呼叫
  • 整合服務,例如寄送電子郵件、處理付款或呼叫 AI API
  • 保護敏感邏輯,避免暴露在瀏覽器端的程式碼中
  • 安全地存取密鑰,不會讓使用者看到
  • 執行複雜的運算,這類工作在瀏覽器中太慢或太耗資源

函式如何運作

AI 為你建立邊緣函式時,會:

  1. 撰寫 JavaScript 程式碼,完成你所描述的任務
  2. 設定存取控制,決定誰可以呼叫這個函式
  3. 設定密鑰存取(如果函式需要外部 API 憑證)
  4. 測試函式,確保運作正常
  5. 提供一個 URL,讓你的應用程式呼叫以執行該函式

函式在彼此隔離的安全環境中執行。每次執行都會記錄耗時、任何錯誤,以及是由哪位使用者觸發。你可以在「設定 > 網站設定 > 監控 > 記錄」查看這些記錄,了解函式的執行狀況並排除問題。

函式的存取控制

和資料庫資料表一樣,邊緣函式也有安全政策來控管誰能執行。AI 會依據你要建置的內容來設定:

公開函式

任何人都能呼叫,不需登入。用於 webhook 處理程式(例如 Stripe 付款通知)、公開 API 或健康檢查端點。

需驗證的函式

只有已登入的使用者能呼叫。大多數函式採用這個政策,適合面向使用者的功能、表單提交,或為你的應用程式擷取資料。

依群組授權

只有特定群組(例如「admin」)的使用者能呼叫該函式。適合管理操作、內容審核工具或團隊專用的功能。

依中繼資料授權

依據自訂的使用者屬性授權。例如只有 department = "engineering" 的使用者才能呼叫某些函式。這讓你能設計彈性的自訂權限方案。

函式能做什麼

資料庫存取

函式可以查詢與修改你的資料庫,且同樣套用所有安全規則。

呼叫外部 API

函式可以使用你儲存的密鑰與外部服務通訊。

複雜邏輯

函式可以執行計算、資料轉換、驗證,或多步驟的工作流程。

電子郵件與通知

回應使用者的操作,寄送交易類電子郵件、簡訊或推播通知。

付款處理

透過 Stripe 等服務處理付款流程、webhook 或訂閱管理。

AI 整合

呼叫 OpenAI 或 Anthropic 等 AI API,用來產生內容、分析資料或提供智慧功能。

監控與記錄

每次函式執行都會自動記錄:

  • 何時被呼叫,以及由誰呼叫
  • 執行花了多久
  • 成功或發生錯誤
  • 任何主控台輸出或錯誤訊息
  • 它回傳的回應

最佳實務

✅ 描述清楚 - 請 AI 建立函式時,具體說明它該做什麼,以及誰可以呼叫。

✅ 留意記錄 - 查看函式的執行記錄,了解效能並及早發現錯誤。

✅ 將密鑰放在密鑰管理中 - AI 會使用已儲存的密鑰,而不是把它們寫死在函式裡。

❌ 不要公開敏感操作 - 讓 AI 設定適當的存取控制。管理類函式絕不該設為公開。


相關文件: