边缘函数
服务端代码执行
边缘函数是在 Deno 运行时上运行的 JavaScript/TypeScript 函数,让你能够实现不应或不能在浏览器中运行的逻辑。当你描述需要服务端处理、外部 API 集成或更强安全性的功能时,AI 会创建这些函数。
边缘函数能做什么:
- 处理表单,包含验证和外部 API 调用
- 集成服务,例如发送邮件、处理付款或调用 AI API
- 保护敏感逻辑,避免其出现在浏览器代码中
- 安全访问密钥,而不向用户暴露
- 执行复杂操作,处理对浏览器来说太慢或资源消耗太高的工作
函数如何工作
当 AI 为你创建边缘函数时,它会:
- 编写 JavaScript 代码,执行你描述的任务
- 设置访问控制,确定谁可以调用该函数
- 配置密钥访问,如果函数需要外部 API 凭据
- 测试函数,确保它正确工作
- 提供一个 URL,你的应用可调用该 URL 来执行函数
函数会在隔离、安全的环境中运行。每次执行都会记录耗时信息、任何错误,以及由哪个用户触发。你可以在设置 > 站点配置 > 监控 > 日志中查看这些日志,以监控函数表现并调试问题。
函数访问控制
与数据库表一样,边缘函数也有安全策略,用于控制谁可以执行它们。AI 会根据你正在构建的内容进行设置:
公开函数
任何人都可以调用,即使没有登录也可以。用于 webhook 处理器(例如 Stripe 付款通知)、公开 API 或健康检查端点。
已认证函数
只有已登录用户可以调用。大多数函数使用此策略;它适合面向用户的功能、表单提交,或为你的应用获取数据。
基于群组的访问
只有特定群组(例如“admin”)中的用户可以调用该函数。非常适合管理操作、内容审核工具或团队专属功能。
基于元数据的访问
根据自定义用户属性授予访问。例如,只有 department = "engineering" 的用户可以调用某些函数。这支持灵活的自定义权限方案。
函数可以做什么
数据库访问
函数可以查询和修改你的数据库,并应用所有相同的安全规则。
外部 API 调用
函数可以使用你存储的密钥与外部服务通信。
复杂逻辑
函数可以执行计算、数据转换、验证或多步骤工作流。
邮件和通知
响应用户操作,发送事务性邮件、短信或推送通知。
付款处理
使用 Stripe 等服务处理付款流程、webhook 处理或订阅管理。
AI 集成
调用 OpenAI 或 Anthropic 等 AI API,以生成内容、分析数据或提供智能功能。
监控和日志
每次函数执行都会自动记录:
- 调用时间和调用者
- 执行耗时
- 是否成功或遇到错误
- 任何控制台输出或错误消息
- 返回的响应
最佳实践
✅ 描述清楚 - 请求 AI 创建函数时,请具体说明它应当做什么,以及谁应当能够调用它。
✅ 监控日志 - 检查函数执行日志,了解性能并尽早发现错误。
✅ 把密钥放在密钥管理器中 - AI 会使用已存储的密钥,而不是把它们硬编码到函数里。
❌ 不要暴露敏感操作 - 让 AI 配置合适的访问控制。管理函数绝不应公开。
相关文档: