从基础能力开始
为智能应用留出空间
先让应用运行起来,再按需要连接模型、知识和记忆。
不同能力在同一项目边界内组合,保留清晰的资源归属与访问权限。
构建应用后端
把身份、数据、文件和业务逻辑接入应用。
让数据更易管理
从组织与项目归属,到数据结构的持续演进。
连接 Agent 所需能力
把应用上下文与模型连接起来,按需扩展。
数据有结构
应用才有底气
在控制台中组织数据库、表与字段,通过 API 读写记录。数据结构和访问权限围绕项目管理,让应用从第一张表开始逐步演进。
- 用类型化字段与索引组织数据
- 用字段注释保留业务上下文
- 按需要使用 Schema 版本与聚合能力
把团队知识
带进你的应用
从文档管理到检索调用,把分散的信息整理成应用能够使用的知识。
持续维护内容、检查摄取状态,让问答有可追溯的依据。
组织内容
把应用需要的文档收集到知识库中,持续补充与更新。
检查摄取
查看文档和处理状态,确认内容就绪后再发起检索。
接入应用
通过接口查找相关内容,在应用中组织答案与来源引用。
能力不断扩展
边界始终清晰
从团队协作到应用请求,让资源归属、身份和权限都有明确的位置。
Organization
管理团队成员、角色与项目归属,让协作建立在明确的组织边界内。
Project
组织应用资源与服务配置,在同一个工作空间中管理数据与 AI 能力。
Scope 与 Permission
分别约束服务端调用范围与资源访问,按照请求身份逐层授权。
从文档到代码
连接你的项目
在控制台准备项目,再通过 REST API 或已发布的 SDK 接入应用。按实例版本选择兼容的 SDK,逐步验证调用链路。
- 准备项目在组织中创建或选择项目,查看实例地址与项目 ID。
- 配置访问身份客户端使用用户身份;API Key 仅用于服务端,并选择必要的 Scope。
- 接入一项能力从认证、数据或知识检索开始,确认请求与权限符合预期。
import { Client, Databases }
from 'agentbase-web-sdk';
const client = new Client()
.setEndpoint('https://api.example.com/v1')
.setProject('PROJECT_ID');
const databases = new Databases(client);
将示例地址与项目 ID 替换为控制台中的值。业务调用所需的会话与权限配置见接入文档。
常见问题
开始之前,先了解
这些使用边界。
Agentbase 适合构建什么?
可以从 Web、移动端或内部工具的应用后端开始,使用认证、数据库、存储、函数等能力;需要 AI 功能时,再连接模型、知识库和记忆。具体可用范围取决于实例已启用的服务与配置。
知识库和记忆有什么区别?
知识库侧重组织文档与检索内容,适合产品手册和业务知识。记忆侧重保存与检索用户或业务相关的上下文。两者可以按应用需要组合使用,但不应混淆内容归属与访问权限。
是否需要一次接入所有能力?
不需要。可以先验证一种能力的接入与权限,再逐步扩展。模型、知识库等功能需要配置相应的 Provider 或依赖服务,不能把控制台入口可见视为服务已就绪。
客户端和服务端如何选择访问身份?
客户端围绕用户会话或适用的身份令牌调用;API Key 仅保存在服务端,并设置必要的 Scope。资源 Permission 仍负责限制具体资源的访问范围,不能用前端隐藏代替授权。
Schema 版本回滚会恢复业务数据吗?
Schema 回滚不恢复业务数据。结构演进、业务数据备份和恢复属于不同的问题;变更前应核对相应能力的范围和限制,数据聚合也不代表无限数据量的分析能力。
应该从哪里确认版本与 SDK 的兼容性?
先确认实例版本,再查看对应的文档和已发布 SDK。SDK 源码、生成产物和正式发布是不同状态;选择版本时以实际发布与兼容性说明为准,不根据包名推断所有功能可用。