什么是 Agentbase
Agentbase 是从应用后端出发、面向 Agent 场景的基础设施平台:先提供标准应用后端(认证、数据库、存储、函数),再提供 Agent 所需的模型接入、知识库、记忆、可观测与运行时能力。本手册对应 Agentbase 2.6.0。
截图未公开:原图可能包含账号或资源标识。
服务稳定版本通过 GET /v1/health/version 查询,当前为 2.6.0。
能力地图
| 领域 | 能力 |
|---|---|
| 应用后端 | Auth 认证(含自定义 OAuth2)、Database、Storage、Functions(含 Java 17 运行时) |
| 消息与站点 | Messaging(Email / SMS / Push)、Sites 站点托管 |
| Agent 基础设施 | Knowledge Base(富文档 RAG)、Models 与 LLM Gateway、AI Gateway(统一 AI 数据面)、AI Memory、Moderation、Agent Runtime |
| 治理与观测 | Observability、三级用量(账号 / 组织 / 项目,最近 30 个 UTC 日)、Quota / Ratelimit、组织与项目治理 |
| 接入 | REST、GraphQL、Realtime;Web / Node / Console 等多语言 SDK(见官方 SDK 文档) |
2.6.0 值得关注的能力
- 自定义 OAuth2:项目可配置标准 Authorization Code 流程的自定义登录提供方,无需新增服务端 Provider 类。
- OAuth 登录测试:Console 可测试当前项目已启用的公共 OAuth Provider,测试会话与 Console 会话相互隔离。
- 三级用量:账号、组织、项目均提供最近 30 个 UTC 日的用量聚合,并区分 0、缺失与不完整数据。
- 富文档 RAG:知识库支持 PDF、Office、表格、MinerU 文档与图片资产,并可选图片理解。
- Schema 激活前校验:数据库结构变更在激活前校验物理结构,失败时保留当前生效版本继续服务。
- Memory 强化:Memory 初始化有界重试、范围删除与写入串行、quota 条件更新,身份与 revision 绑定更严格。
- AI Gateway:新的统一 AI 数据面,与既有 LLM Gateway(Models 页)并存,不提供旧路由别名。
- Agent Runtime:托管 Agent 版本、ReAct / Workflow、Tool / MCP、Memory / Knowledge 挂载与运行事实。
- 安全默认值收紧:外部 URL 拒绝本机 / 私网 / 元数据地址;远程 Avatar / Favicon / Screenshot 默认收紧;Function / Site 以受限身份运行;Function API Key 不再接受 query string 传递。
产品边界(先读一遍)
- 能力可用性由部署决定:知识库可选索引能力、统一 AI 网关等属于部署级能力,部署未提供时接口返回稳定的
412,不会伪装成「已关闭」;版本升级本身不会打开默认关闭的能力。 - Console 可见 ≠ 数据面可用:侧栏出现入口、设置页能打开,只说明 Console 路由存在;实际调用仍受实例环境变量、项目 Services、资源
enabled、Provider 健康与外部凭据共同约束。 - Console ≠ Client:Console 登录账号管理组织与项目;Auth 用户是你应用的终端用户;两套身份与密钥不可混用。
- 版本与兼容:官方 Appwrite SDK 的最高响应 SemVer 上限(默认 1.9.0)不随 Agentbase 稳定版本自动提高;Agentbase 自研 SDK 通过
X-AppBase-SDK标识协商响应格式。