火山引擎 Supabase 及方舟 Agent Plan 概述火山引擎 Supabase是以 AI 原生数据库管理平台AI Native Database Platform简称 AIDAP推出的面向企业应用及 Agent 研发的 AI-Native BaaS 产品。它基于火山引擎 Serverless PostgreSQL不仅具备完善的企业级 BaaS 能力还提供了秒级 Serverless、全栈分支管理、瞬间回溯、AI 原生能力等高级特性非常适合作为企业级智能应用的 Harness 基座。Agent Plan是火山方舟推出的业界首个订阅式“Agent 套餐包”深度整合了多模态模型与Harness 服务。在模型层面内置字节 Seed 系列 SOTA 模型Doubao-Seed / Seedance / Seedream 等及优秀国产模型覆盖文本、代码、图像、视频等多模态场景。在 Harness 层面提供了包括 Supabase、联网搜索、专业数据集、Agent 记忆、ArkClaw 个人助手在内的多种开箱即用的 Agentic 能力助力开启 Agent 场景的全新体验。火山引擎 Supabase 是 Agent Plan 内置的 Harness 服务之一支持 Agent 燃料值AFP抵扣形式为 Agent 场景提供一站式的 AI-Native BaaS 底座。在 Agent Plan 套餐内个人用户 / 企业用户可以通过 Supabase 控制台、OpenAPI、CLI、Skills、MCP 等方式购买和管理 Supabase 实例。开通 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 及 Skillsnpx byted-supabase/clilatest install本地更新火山引擎 Supabase CLI 及 Skillsbyted-supabase-cli update方式二通过 Ark CLI 登录并安装 Harness 工具集参考 Ark CLI 帮助文档 (https://www.volcengine.com/docs/82379/2373740)一键安装 Ark CLI。然后运行arkcli helper并按提示安装 Harness 工具集就会自动安装 Supabase 的 CLI 和 Skills。# 1. 通过 NPM 安装npm install -g volcengine/ark-clilatest# 2. 验证安装arkcli --version# 3. 登录火山账号推荐浏览器 SSO 登录并按提示选择消费模式推荐 agent-planarkcli auth login# 4. 启动 arkcli helper并按提示依次选择模型、选择 Agent 类型、安装 Harness 工具arkcli helper# 5. 查看 Supabase CLI 的 profile会发现有一个 ark_login 的 profilebyted-supabase-cli configure list效果如下使用 CLISupabase CLI 的使用说明可以通过help命令查询 CLI 的使用说明或查阅火山引擎官网 Supabase CLI 文档 。登录认证方式一通过 Supabase CLI 登录3 种途径支持如下 3 种登录认证方式。登录一次后CLI 会自动将凭据写入~/.volcengine/config.json可长期复用。途径 1通过默认方式浏览器 OAuth进行登录推荐。命令如下其中profile 缺省为default示例中指定为dev地域region缺省为cn-beijing。执行后就会自动在浏览器中弹出火山引擎 OAuth 登录页输入账号信息登录即可。byted-supabase-cli login --profile dev --region cn-beijing效果如下途径 2采用火山 AK/SK 配置 profile。其中profile 缺省为default示例中指定为dev地域region缺省为cn-beijing。byted-supabase-cli configure set --profile dev --access-key AK --secret-key SK --region cn-beijing途径 3复用 volcengine-cli 的 profile。如果用户已经通过 volcengine-cli 登录过则可以直接复用其 profile无需再次配置。可以通过如下命令查看 profile 列表byted-supabase-cli configure list方式二通过 Ark CLI 登录如“通过 Ark CLI 登录并安装 Harness 工具集”小节所述如果已安装了 Harness 工具集则可以通过 Ark CLI 进行登录。命令如下# 登录火山账号推荐浏览器SSO登录并按提示选择消费模式推荐agent-planarkcli auth login# 查看 Supabase CLI 的 profile会发现有一个名为 ark_login 的 profilebyted-supabase-cli configure list效果如下配置 Agent Plan 信息针对独立使用 Supabase CLI 场景对于独立使用 Supabase CLI 的场景需要配置 Agent Plan 信息。如果是通过 Ark CLI 安装 Harness 工具集并登录的则无需再进行配置可跳过本小节。对于“Agent Plan 个人版”需要指定--is-agent-plantrue。byted-supabase-cli configure agent-plan --profile dev --is-agent-plantrue对于“Agent Plan 企业版”除了指定--is-agent-plantrue之外还需要通过--agent-plan-seat-id指定席位 ID。byted-supabase-cli configure agent-plan --profile dev --is-agent-plantrue --agent-plan-seat-id seat-20260620212706-sxz2k效果如下创建 Supabase 工作区通过projects子命令来管理 Supabase 工作区Workspace。示例命令如下可以通过两种方式来指定 Agent Plan 信息。方式 1指定上述已配置 Agent Plan 信息的 profile。同时可以通过--suspend-timeout-seconds来指定自动休眠时间秒数缺省值为-1关闭自动休眠。byted-supabase-cli --profile dev projects create my-project-1 --suspend-timeout-seconds 3600效果如下方式 2单独指定--is-agent-plantrue和--agent-plan-seat-id会覆盖 profile 中已配置的 Agent Plan 信息。byted-supabase-cli projects create my-project-2 --suspend-timeout-seconds -1 --is-agent-plantrue --agent-plan-seat-id seat-20260620212706-sxz2k效果如下使用 Skills结合 TraeSkills 的使用说明按照“安装 / 更新 Supabase CLI 及 Skills”小节执行安装命令后会自动将 Supabase 的 Skills 安装到全局目录下会被 Trae 自动识别。因此用户可以在 Trae 中通过自然语言来查阅和执行 Skills如下所示。登录认证2 种途径Supabase Skills 是基于 CLI 实现的因此也支持 2 种登录方式OAuth 方式、配置 AK / SK 方式。强烈建议在首次使用前先登录如果未登录执行操作时受限并会引导用户进行登录。途径 1通过默认方式浏览器 OAuth进行登录推荐。在 Trae 中输入如下文字就会自动在浏览器中弹出火山引擎 OAuth 登录页输入账号信息即可登录。使用火山supabase skill进行登录当然也可明确指定登录方式、profile 等可根据实际情况调整。创建火山引擎supabase的profile dev并通过OAuth方式进行登录。效果如下自动弹出的浏览器登录页如下途径 2采用火山 AK / SK 配置 profile。在 Trae 中输入如下文字可根据实际情况调整Trae 就会自动调用 CLI 命令进行配置。帮我配置supabase的profile并作为后续操作的默认profile。* 名称dev* AKtest-ak* SKtest-sk* regioncn-beijing效果如下配置 Agent Plan 信息对于“Agent Plan 个人版”指定默认采用 Agent Plan 模式。在 Trae 中输入如下文字请根据实际情况调整。设置 profile dev 默认采用 agent plan 模式效果如下对于“Agent Plan 企业版”指定默认采用 Agent Plan 模式并需要同时指定席位 ID请根据实际情况调整。设置 profile dev 采用 企业版 agent plan 模式席位ID 为 “seat-xxxx”效果如下创建 Supabase 工作区在 Trae 中输入如下文字来创建 Supabase 工作区Workspace。可选指定自动休眠时间默认关闭自动休眠。使用 profile dev创建一个 Supabase workspace名称为 my-project-3。或使用 profile dev创建一个 Supabase workspace名称为 my-project-4自动休眠时间为3600秒。效果如下开发 APP 示例可以基于 Supabase Skill通过自然语言从 0 到 1 快速开发 APP。以下展示开发一个“待办事项”APP 的过程总共分为四步创建 Supabase 并开发后端、部署后端、开发前端、测试 APP。1. 创建 Supabase 并开发后端在 Trae 中输入如下文字可根据实际情况调整请基于 Supabase skill开发一个待办事项 APP 的完整后端完成编码相关工作后续我会部署到 Supabase Edge Function 中具体包括创建新的Supabase工作区、数据库表设计todos 表、RESTful API 接口开发。代码请放到 ~/todo-app-backend。效果如下2. 部署后端Edge Function在 Trae 中输入如下文字可根据实际情况调整请将上述待办 APP 后端代码 (~/todo-app-backend) 部署到新创建的Supabase工作区中完成以下工作执行数据库初始化 SQL、部署服务到Supabase中、验证各接口可正常访问。效果如下3. 开发前端在 Trae 中输入如下文字可根据实际情况调整后端已就绪请开发配套的待办 APP 前端页面要求支持任务的增删改查、接入 Supabase 后端接口、界面简洁美观、并在本地直接部署运行。代码请放到 ~/todo-app-frontend。效果如下4. 测试 APP将第 3 步输出的地址复制到浏览器导航栏本示例中是http://localhost:5173/即可看到应用页面。后续申请域名并把前端部署后supabase skills 同样支持一键部署前端本示例中省略即可对外提供服务了。进入 Supabase Dashboard 控制台后可以看到 APP 用户数据已经在数据库中正确保存了。至此“待办事项 APP”就开发部署完成了。开发过程完全采用自然语言与 Trae 进行交互通过 Supabase Skills 自动完成了后端开发、后端部署、前端开发等步骤大幅提高了软件开发效率。
