项目设置
项目设置位于项目侧栏 Settings,承载项目级治理:服务开关、表模式、域名、Webhooks、SMTP、数据迁移、变量与高风险操作。页签:Overview / Custom domains / Webhooks / Migrations / SMTP / Usage(Usage 页签在云端部署显示)。多数操作需要项目写权限(projects.write)。
Overview
截图未公开:上游原图包含真实账号或资源标识。
| 卡片 | 说明 |
|---|---|
| Column deletion | 列删除开关:允许项目 Owner 通过版本化 Schema 管理删除表列;删除列会永久移除其数据。仅项目 Owner 与平台管理员可修改 |
| Name / Labels | 更新项目名称;标签仅允许字母数字字符 |
| 项目表模式 | 决定业务数据使用共享表还是独占表承载(共享表 / 独占表 / 深度独占表)。共享表与独占表可互相转换;深度独占表不支持转换。转换前选择目标类型与 tag(具体目标资源按创建项目的规则自动轮询选择);项目内存在 relationship 类型集合时会阻止转换并明确提示。转换进行中会在卡片上显示进度提示;转换任务历史在账号中心查看(见限额与配额) |
| Services | 对客户端 API 启用 / 停用各服务(Account、Avatars、Databases、TablesDB、Health、Functions、Memory、Locale、Messaging、Storage、Sites、Teams、Users、GraphQL、Knowledge Bases、AI Gateway、统一 AI Gateway 等),支持 Enable all / Disable all(需确认)。关闭只影响客户端 API 可达性,服务端访问不受影响,不删除已有数据 |
| Git | 管理 Git 安装(连接 / 更新);安装本身不触发部署 |
| Global variables | 项目级环境变量:编辑器、Import .env、逐条创建;变量可标记为 Secret(保存后不以明文展示),删除需确认。变量注入到项目内全部 Functions 与 Sites |
| Change organization | 把项目移动到你拥有的其他组织 |
| Delete project | 永久删除项目及其元数据、资源与统计,不可撤销;需输入项目名确认 |
Custom domains
- Add domain → 输入自有域名,按提示配置 DNS。
- 域名表显示证书状态:Generating certificate / Certificate generation failed;失败可 Retry 或 View logs。
- 生效后可经自有 URL 访问 API,而非默认端点。
Webhooks
- 列表 + 创建 / 详情子页;创建流程含事件选择与 Security 配置(Certificate verification (SSL/TLS) 开关;关闭证书校验有明确警示)。
- 详情页可更新事件、安全设置、URL 与签名密钥(可重新生成)。Webhook URL 必须从 Agentbase 出站可达;建议 HTTPS 并在接收端验证签名。
SMTP
- Custom SMTP server 开关:启用后使用自有邮件通道(用于验证 / 找回 / 邀请等平台邮件)。
- 字段:Sender name、Sender email、Reply to、Server host、Server port、Username、Password、Secure protocol(TLS / SSL / None)。
- 云端部署的自定义 SMTP 属付费计划能力(未包含时显示升级提示)。
- 邮件模板在项目 Auth 的 Templates 页维护(见认证与用户)。
Migrations
- 数据导入 / 导出向导(导入来源、导出目标按页面选项为准)。导入通常不包含项目设置本身;大量数据导入会消耗带宽与存储配额。
使用提示与边界
- 关闭服务 ≠ 删除数据;只影响客户端 API 可达性。
- 表模式转换是项目级重负载操作:转换进行中避免叠加其他结构变更,历史与结果在账号中心的转换记录中追踪。
- Global variables 中的 Secret 与 SMTP 密码按密钥保管,不入库、不截图。
- 删除项目、关闭证书校验、Disable all services 属高风险操作,确认弹窗即最终防线。