AI 助理
文档备案控制台
官方文档
输入文档关键字查找
首页

RDS ContextDB快速入门

更新时间：
复制为 MD 格式
产品详情
我的收藏

RDS ContextDB是一款面向Agent的数据存储与管理基础设施，支持Qoder、Claude Code、Codex和OpenClaw快速接入。其不再仅仅关注数据的静态保存，而是将存储的核心重构为Agent提供高效、结构化、可理解的上下文供给。

功能简介

上下文管理难题

随着 Agent 从"对话工具"逐步演进为真正能够持续执行任务的智能体，传统依赖本地会话和短期上下文的方式，已经无法满足企业级场景需求。

在真实业务中，Agent 不仅需要理解当前问题，更需要持续记住历史任务进度、关键决策过程、多 Agent 协作状态、长周期项目经验、企业知识与运行上下文等信息。这些上下文往往分散在不同设备、不同系统和不同 Agent 之间，缺乏统一沉淀、共享与治理能力，导致 Agent 无法形成真正的长期记忆与持续进化能力。

RDS ContextDB核心优势

RDS ContextDB是阿里云推出的一站式上下文服务，支持主流平台（Qoder、Claude Code、Codex和OpenClaw）快速接入。其将记忆与知识管理重构为可被Agent直接消费的上下文供给，通过统一的上下文存储、协同共享、生命周期管理与智能检索能力，让 Agent 从"单次会话记忆"，进化为"具备长期记忆、持续协作与经验沉淀能力"的系统服务。

RDS ContextDB具备以下核心能力：

  • 即开即用：支持短期记忆、长期记忆与知识库等能力，通过API Key丝滑对接各类Agent，实现按需调用，架构更轻、更灵活。

  • 智能上下文管理：上下文以图谱形式进行结构化存储，支持实时增量更新与复杂关系推理；通过“夜间服务”完成上下文演进，解决上下文的冗余与冲突问题。

  • 跨Agent共享与企业级权限：不同Agent可在企业级权限管理下，按"Workspace - Group - Member"三层结构访问组织静态知识与项目动态信息。

  • 统一管理：继承RDS企业级高可用、高可靠与权限隔离能力；完备的事务与锁机制可有效缓解记忆处理过程中的"幻觉"问题，轻松运维。

使用限制

说明

RDS ContextDB当前为邀测阶段，如需体验请填写RDS ContextDB邀测申请表单。

  • 主流平台快速接入：支持Qoder、Claude Code、Codex和OpenClaw快速接入，其他平台需要手动配置。

  • 记忆共享：同一Agent下（含跨Session）的记忆可共享，记忆数据暂不支持导出。

  • 知识库：同一Workspace内成员可共享知识库内容（通过知识库内容共享，可以实现跨Agent的业务背景共享）。当前支持通过命令行或在Agent内通过对话的方式上传知识文件，暂不支持知识库导出。

计费说明

RDS ContextDB目前为邀测阶段，暂不收取相关费用。

步骤一：开通RDS ContextDB

  1. 登录RDS管理控制台。

  2. 在左侧导航栏中单击RDS ContextDB。

  3. 在RDS ContextDB页面，单击开通RDS ContextDB。未加白用户将自动跳转至RDS ContextDB邀测申请表单，提交申请且审核通过后可开通服务。

步骤二：创建与配置工作空间

RDS ContextDB开通成功后，您可以创建一个工作空间作为上下文、记忆与知识库的逻辑集合，并为 工作空间创建访问凭证API Key，用于客户端身份认证。

  1. 登录RDS管理控制台。

  2. 在左侧导航栏中单击RDS ContextDB进入管理页面。

  3. 单击新建按钮并在弹窗中填写工作空间名称与初始管理员名称并单击确定。

  4. API Key将会自动生成。请立即妥善保存 API Key，关闭后将无法再次查看，单击我已保存。

步骤三：连接ContextDB

RDS ContextDB支持Qoder、Claude Code、Codex和OpenClaw主流平台快速接入（其他平台需要手动配置）：

Qoder接入

# 安装CLI
npm install -g @aliyunrds/ctxdb

# 替换 <API_KEY>，命令会自动完成配置、SKILL 写入、Hooks 注册与连通性校验
ctxdb setup --agent qoder --api-key <API_KEY>

# 验证安装是否成功
ctxdb status --agent qoder --json

安装成功后，您需要重启Qoder Desktop或者Qoder CLI，使相关配置生效。

Claude Code接入

# 安装CLI
npm install -g @aliyunrds/ctxdb

# 替换 <API_KEY>，命令会自动完成配置、SKILL 写入、Hooks 注册与连通性校验
ctxdb setup --agent claude --api-key <API_KEY>

# 验证安装是否成功
ctxdb status --agent claude --json

安装成功后，您需要重启Claude Code使相关配置生效。

Codex接入

# 安装CLI
npm install -g @aliyunrds/ctxdb

# 替换 <API_KEY>，命令会自动完成配置、SKILL 写入、Hooks 注册与连通性校验
ctxdb setup --agent codex --api-key <API_KEY>

# 验证安装是否成功
ctxdb status --agent codex --json

安装成功后，您需要重启 Codex 对话，在弹出的 hooks 确认界面选择接收所有 hooks 选项

OpenClaw接入

# 安装插件
openclaw plugins install openclaw_memory_rds_ctxdb

# 启用插件
openclaw plugins enable openclaw_memory_rds_ctxdb

# 初始化连接（需要替换 API_KEY ）
openclaw ctxdb init --api-key <API_KEY>

# 重启网关生效
openclaw gateway restart

核心功能

RDS ContextDB工作空间内提供概览（含API Key管理）、记忆管理、知识库管理和配额管理等核心能力。

概览

概览页是RDS ContextDB工作空间的首页，集中展示当前工作空间下的基本信息和API Key管理。

  • API Key管理：用于集中管理工作空间成员及权限、API Key凭证等信息。

    • 成员管理：添加或删除工作空间成员

    • API Key管理：为各成员快速配置或吊销相应的API Key。

  • 工作空间概览：展示工作空间名称与ID、运行状态和Endpoint等核心指标的汇总信息，帮助您快速了解服务的整体使用情况。

  • 安装与连接：提供平台接入RDS ContextDB的引导信息，帮助您快速完成Agent对接。

记忆

RDS ContextDB通过结构化的方式（“原始文本 - 事实 - 实体”）存储与管理Agent记忆：

  • 原始文本：每条结论可回溯到对话内的原文切块（source_chunk），核查原文片段。

  • 事实：从上下文中拆解出的原子化的陈述（自洽短句），作为主要检索对象并向量化，召回时通常在这一层做语义命中。

  • 实体：高频出现的人、组织、项目、工具等，会沉淀为带属性、别名、重要性评分等内容的常驻画像（Entity Card），并与后续写入的结论条目绑定，使会话重启时不从零铺垫背景。

您可以在工作空间内高效、可视化地检视Agent记忆：

  • 实体关系图谱：通过可视化的方式展示实体之间的联系。

知识库

知识库模块用于管理工作空间内可被Agent检索的外部知识资源，您可以通过自然语言或CLI命令创建知识库、上传文件与召回知识（暂不支持控制台操作）：

通过自然语言管理

接入 ContextDB 后，您可以直接用自然语言让 Agent 完成知识库操作，无需手写API。

  1. 创建知识库

    帮我新建一个叫“Aliyun RDS MySQL 运维资料库”的知识库。

  2. 上传文件

    把 ~/docs/aliyun-rds-mysql-overview.pdf 上传到“Aliyun RDS MySQL 运维资料库”。

  3. 知识召回

    结合“Aliyun RDS MySQL 运维资料库”，回答：当业务读请求量明显升高时，RDS MySQL 可以通过哪些能力扩展读取能力？只读实例和读写分离分别适合解决什么问题？

通过命令行管理

  1. 创建知识库

    # 命令返回的id为kb_id，用于后续操作
curl -X POST "https://context-database.aliyuncs.com/v1/knowledge/knowledge_bases" \
  -H "Authorization: Token $API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "my-kb", "description": "测试知识库"}'

  2. 上传文本或本地文件

    # 上传文本
curl -X POST "https://context-database.aliyuncs.com/v1/knowledge/knowledge_bases/$KB_ID/documents" \
  -H "Authorization: Token $API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "intro.md", "text": "文档全文内容……", "mimeType": "text/plain"}'
  
# 上传本地文件
curl -X POST "https://context-database.aliyuncs.com/v1/knowledge/knowledge_bases/$KB_ID/files" \
  -H "Authorization: Token $API_KEY" \
  -F "file=@/path/to/your-doc.pdf"

  3. 知识召回

    # dataset_ids如果为空数组，则表示搜全部知识库
curl -X POST "https://context-database.aliyuncs.com/v1/knowledge/query" \
  -H "Authorization: Token $API_KEY" -H "Content-Type: application/json" \
  -d '{"question": "你想问的问题", "dataset_ids": [], "top_k": 6}'

配额

您可以在配额管理页面查看您的API调用量配额、存储配额及实际使用量。在邀测阶段内，RDS ContextDB提供以下免费额度供您使用：

  • API调用量配额：6000/月

  • 存储配额：

    • 知识库数量：10个

    • 文档数：2000个

    • 存储容量：20 GB