AI 原生 BaaS 平台 Supabase 版
AI 原生 BaaS 平台 Supabase 版
文档指南
请输入
- 文档首页
AI 原生 BaaS 平台 Supabase 版最佳实践基于 Agent Plan 接入火山引擎 Supabase
复制全文
下载 pdf基于 Agent Plan 接入火山引擎 Supabase
文档反馈
问问助手火山引擎 Supabase 已作为 Agent Plan 的内置 Harness 能力之一，支持通过 Agent 燃料值抵扣使用。对希望快速搭建 Agent 应用、业务后台或轻量 SaaS 的团队来说，这意味着数据库、认证、对象存储、函数能力与开发工具可以放到一条路径里完成接入，而不需要分别采购和拼装。
本文从准备工作、开通服务、安装和使用 CLI 进行全流程的介绍，并给出一个基于 CLI 从 0 到 1 开发 APP 的示例。
前提条件
- 已确认要使用 Agent Plan 个人版或 Agent Plan 企业版。
- 本地开发环境可安装 Node.js；如果需要命令行操作，建议提前准备终端环境。
- 若计划使用企业版抵扣，需要提前获取席位 ID。您可在控制台查看或调用 Open API 进行获取，更多详细信息，请参见席位管理和 ListSeatInfos。
注意事项
- 仅支持在北京地域使用 Agent Plan 套餐的 AFP 额度抵扣火山引擎 Supabase 资源的使用费用。
- 如您是首次使用火山引擎 Supabase，请注意：
- 如您是主账号：请为账号授权 ServiceRoleForAlDAP 角色。
- 如您是子账号：请联系主账号授权 ServiceRoleForAlDAP 角色，并为您再授予 IAM 的 AIDAPFullAccess 预设策略或包含 AIDAP 权限点的自定义策略。
开通 Agent Plan 及 Supabase 抵扣
- 在方舟控制台，开通Agent Plan 个人版或 Agent Plan 企业版，按需选择套餐。
- 在 Harness 页面，找到火山引擎 Supabase卡片，开启抵扣并开启超额后付费（强烈建议）后，单击配置使用进行授权。
- 开通后，通过 Agent Plan 购买 Supabase，即可在 Agent Plan 的用量统计页面查看 Supabase 消耗的 AFP，如下所示。
安装/更新 Supabase CLI 及 Skills
方式一：直接安装/更新 Supabase CLI 及 Skills
- 本地安装 node.js（含 npm 和 npx）
- 参考 node.js 官方网站，按照网站指引安装 node.js 包（含 npm 管理器和 npx 工具）。
- 本地安装火山引擎 Supabase CLI 及 Skills：
- 本地更新火山引擎 Supabase CLI 及 Skills：
方式二：通过 Ark CLI 登录并安装 Harness 工具集
效果如下：
使用 CLI
Supabase CLI 的使用说明
登录认证
方式一：通过 Supabase CLI 登录（3 种途径）
支持如下 3 种登录认证方式。登录一次后，CLI 会自动将凭据写入 ~/.volcengine/config.json，可长期复用。
- 途径 1：通过默认方式（浏览器 OAuth）进行登录（推荐）。命令如下，其中，profile 缺省为 default，示例中指定为dev；地域（region）缺省为 cn-beijing。执行后，就会自动在浏览器中弹出火山引擎 OAuth 登录页，输入账号信息登录即可。
效果如下：
- 途径 2：采用火山 AK/SK 配置 profile。其中，profile 缺省为 default，示例中指定为dev；地域（region）缺省为 cn-beijing。
- 途径 3：复用 volcengine-cli 的 profile。如果用户已经通过 volcengine-cli 登录过，则可以直接复用其 profile，无需再次配置。可以通过如下命令查看 profile 列表：
方式二：通过 Ark CLI 登录
效果如下：
配置 Agent Plan 信息（针对独立使用 Supabase CLI 场景）
对于独立使用 Supabase CLI 的场景，需要配置 Agent Plan 信息。如果是通过 Ark CLI 安装 Harness 工具集并登录的，则无需再进行配置，可跳过本小节。
- 对于 Agent Plan 个人版，需要指定 --is-agent-plan=true。
效果如下：
- 对于 Agent Plan 企业版，除了指定 --is-agent-plan=true 之外，还需要通过 --agent-plan-seat-id 指定席位 ID。
效果如下：
创建 Supabase 工作区
通过 projects 子命令来管理 Supabase 工作区（Workspace）。示例命令如下，可以通过两种方式来指定 Agent Plan 信息。
- 方式 1：指定上述已配置 Agent Plan 信息的 profile。同时可以通过 --suspend-timeout-seconds 来指定自动休眠时间（秒数），缺省值为 -1（关闭自动休眠）。
效果如下：
- 方式 2：单独指定 --is-agent-plan=true 和 --agent-plan-seat-id，会覆盖 profile 中已配置的 Agent Plan 信息。
效果如下：
示例
以下是基于 Supabase Skill，在 Trae 中通过自然语言从 0 到 1 快速开发一个“待办事项”APP 的过程示例。该过程总共分为四步：创建 Supabase 并开发后端、部署后端、开发前端、测试 APP。
- 创建 Supabase 并开发后端
在 Trae 中输入如下文字（可根据实际情况调整）：
效果如下：
- 部署后端（Edge Function）
在 Trae 中输入如下文字（可根据实际情况调整）：
效果如下：
- 开发前端
在 Trae 中输入如下文字（可根据实际情况调整）：
效果如下：
- 测试 APP
将第 3 步输出的地址复制到浏览器导航栏（本示例中是 http://localhost:5173/），即可看到应用页面。后续申请域名并把前端部署后（supabase skills 同样支持一键部署前端，本示例中省略），即可对外提供服务了。
进入 Supabase Dashboard 控制台后，可以看到 APP 用户数据已经在数据库中正确保存了。
至此，“待办事项 APP”就开发部署完成了。开发过程完全采用自然语言与 Trae 进行交互，通过 Supabase Skills 自动完成了后端开发、后端部署、前端开发等步骤，大幅提高了软件开发效率。
最近更新时间：2026.10.26 10:56:49
这个页面对您有帮助吗？
有用
有用
无用
无用