边缘函数

服务端代码执行

边缘函数是在 Deno 运行时上运行的 JavaScript/TypeScript 函数,让你能够实现不应或不能在浏览器中运行的逻辑。当你描述需要服务端处理、外部 API 集成或更强安全性的功能时,AI 会创建这些函数。

边缘函数能做什么:

  • 处理表单,包含验证和外部 API 调用
  • 集成服务,例如发送邮件、处理付款或调用 AI API
  • 保护敏感逻辑,避免其出现在浏览器代码中
  • 安全访问密钥,而不向用户暴露
  • 执行复杂操作,处理对浏览器来说太慢或资源消耗太高的工作

函数如何工作

当 AI 为你创建边缘函数时,它会:

  1. 编写 JavaScript 代码,执行你描述的任务
  2. 设置访问控制,确定谁可以调用该函数
  3. 配置密钥访问,如果函数需要外部 API 凭据
  4. 测试函数,确保它正确工作
  5. 提供一个 URL,你的应用可调用该 URL 来执行函数

函数会在隔离、安全的环境中运行。每次执行都会记录耗时信息、任何错误,以及由哪个用户触发。你可以在设置 > 站点配置 > 监控 > 日志中查看这些日志,以监控函数表现并调试问题。

函数访问控制

与数据库表一样,边缘函数也有安全策略,用于控制谁可以执行它们。AI 会根据你正在构建的内容进行设置:

公开函数

任何人都可以调用,即使没有登录也可以。用于 webhook 处理器(例如 Stripe 付款通知)、公开 API 或健康检查端点。

已认证函数

只有已登录用户可以调用。大多数函数使用此策略;它适合面向用户的功能、表单提交,或为你的应用获取数据。

基于群组的访问

只有特定群组(例如“admin”)中的用户可以调用该函数。非常适合管理操作、内容审核工具或团队专属功能。

基于元数据的访问

根据自定义用户属性授予访问。例如,只有 department = "engineering" 的用户可以调用某些函数。这支持灵活的自定义权限方案。

函数可以做什么

数据库访问

函数可以查询和修改你的数据库,并应用所有相同的安全规则。

外部 API 调用

函数可以使用你存储的密钥与外部服务通信。

复杂逻辑

函数可以执行计算、数据转换、验证或多步骤工作流。

邮件和通知

响应用户操作,发送事务性邮件、短信或推送通知。

付款处理

使用 Stripe 等服务处理付款流程、webhook 处理或订阅管理。

AI 集成

调用 OpenAI 或 Anthropic 等 AI API,以生成内容、分析数据或提供智能功能。

监控和日志

每次函数执行都会自动记录:

  • 调用时间和调用者
  • 执行耗时
  • 是否成功或遇到错误
  • 任何控制台输出或错误消息
  • 返回的响应

最佳实践

✅ 描述清楚 - 请求 AI 创建函数时,请具体说明它应当做什么,以及谁应当能够调用它。

✅ 监控日志 - 检查函数执行日志,了解性能并尽早发现错误。

✅ 把密钥放在密钥管理器中 - AI 会使用已存储的密钥,而不是把它们硬编码到函数里。

❌ 不要暴露敏感操作 - 让 AI 配置合适的访问控制。管理函数绝不应公开。


相关文档: