邊緣函式
伺服器端程式碼執行
邊緣函式是在 Deno 執行環境上執行的 JavaScript/TypeScript 函式,讓你實作不該或無法在瀏覽器中執行的邏輯。當你描述的功能需要伺服器端處理、串接外部 API 或更高的安全性時,AI 就會建立這些函式。
邊緣函式能做到的事:
- 處理表單,包含驗證與外部 API 呼叫
- 整合服務,例如寄送電子郵件、處理付款或呼叫 AI API
- 保護敏感邏輯,避免暴露在瀏覽器端的程式碼中
- 安全地存取密鑰,不會讓使用者看到
- 執行複雜的運算,這類工作在瀏覽器中太慢或太耗資源
函式如何運作
AI 為你建立邊緣函式時,會:
- 撰寫 JavaScript 程式碼,完成你所描述的任務
- 設定存取控制,決定誰可以呼叫這個函式
- 設定密鑰存取(如果函式需要外部 API 憑證)
- 測試函式,確保運作正常
- 提供一個 URL,讓你的應用程式呼叫以執行該函式
函式在彼此隔離的安全環境中執行。每次執行都會記錄耗時、任何錯誤,以及是由哪位使用者觸發。你可以在「設定 > 網站設定 > 監控 > 記錄」查看這些記錄,了解函式的執行狀況並排除問題。
函式的存取控制
和資料庫資料表一樣,邊緣函式也有安全政策來控管誰能執行。AI 會依據你要建置的內容來設定:
公開函式
任何人都能呼叫,不需登入。用於 webhook 處理程式(例如 Stripe 付款通知)、公開 API 或健康檢查端點。
需驗證的函式
只有已登入的使用者能呼叫。大多數函式採用這個政策,適合面向使用者的功能、表單提交,或為你的應用程式擷取資料。
依群組授權
只有特定群組(例如「admin」)的使用者能呼叫該函式。適合管理操作、內容審核工具或團隊專用的功能。
依中繼資料授權
依據自訂的使用者屬性授權。例如只有 department = "engineering" 的使用者才能呼叫某些函式。這讓你能設計彈性的自訂權限方案。
函式能做什麼
資料庫存取
函式可以查詢與修改你的資料庫,且同樣套用所有安全規則。
呼叫外部 API
函式可以使用你儲存的密鑰與外部服務通訊。
複雜邏輯
函式可以執行計算、資料轉換、驗證,或多步驟的工作流程。
電子郵件與通知
回應使用者的操作,寄送交易類電子郵件、簡訊或推播通知。
付款處理
透過 Stripe 等服務處理付款流程、webhook 或訂閱管理。
AI 整合
呼叫 OpenAI 或 Anthropic 等 AI API,用來產生內容、分析資料或提供智慧功能。
監控與記錄
每次函式執行都會自動記錄:
- 何時被呼叫,以及由誰呼叫
- 執行花了多久
- 成功或發生錯誤
- 任何主控台輸出或錯誤訊息
- 它回傳的回應
最佳實務
✅ 描述清楚 - 請 AI 建立函式時,具體說明它該做什麼,以及誰可以呼叫。
✅ 留意記錄 - 查看函式的執行記錄,了解效能並及早發現錯誤。
✅ 將密鑰放在密鑰管理中 - AI 會使用已儲存的密鑰,而不是把它們寫死在函式裡。
❌ 不要公開敏感操作 - 讓 AI 設定適當的存取控制。管理類函式絕不該設為公開。
相關文件: