RDS ContextDB快速入门-云数据库 RDS(RDS)-阿里云帮助中心

RDS ContextDB是一款面向Agent的企业级上下文数据库服务，支持Qoder、QoderWork、Claude Code、Codex、OpenClaw、OpenCode、Hermes和千问平台快速接入。其不再仅仅关注数据的静态保存，而是将存储的核心重构为Agent提供高效、结构化、可理解的上下文供给，提供涵盖多源接入、提炼与资产化、检索与组合、治理与演进、权限控制及面向Agent服务化供给的统一Context生命周期管理。

功能简介

上下文管理难题

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

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

RDS ContextDB通过Context Growth Loop的"记录—组织—召回与组合—执行反馈—评估演进"闭环链路，解决会话、文档、业务数据和执行反馈分散存储、难以持续积累、缺乏业务语义以及无法安全复用和统一治理的问题，持续提升 Context 的质量和复用价值，服务于建设企业级Agent和多Agent协作平台的企业及 Agent 应用开发者。

RDS ContextDB核心优势

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

RDS ContextDB具备以下核心能力：

即开即用、快速接入：支持短期记忆、长期记忆与知识库等能力，通过API Key丝滑对接各类Agent（包括通过自然语言或命令行分钟级接入，支持钉钉、飞书文档同步），实现按需调用，架构更轻、更灵活。
智能上下文管理：上下文以图谱形式进行结构化存储，支持实时增量更新与复杂关系推理；通过“夜间服务”完成上下文演进，解决上下文的冗余与冲突问题。
跨Agent共享与企业级权限：不同workspace之间权限隔离，同一API Key的Context可以在多个Agent间共享。
统一管理：继承RDS企业级高可用、高可靠与权限隔离能力。

计费说明

RDS ContextDB采用按量付费模式，根据实际使用的资源量计费。ContextDB计费项包含两大类：

记忆和知识的写入、检索、演进费用：记忆写入/检索、知识写入/检索、上下文演进等调用大模型和计算资源产生的消耗，按Credit计费。
存储费用：数据（含知识原文、记忆、知识索引等）存储产生的费用，按存储空间用量（GB/小时）计费。

费用大类	计费项名称	计费项Code	计费说明	单价
记忆和知识写入/检索	记忆写入	`contextdb_mem_add_requests`	用户写入记忆过程产生的费用，按Credit计费	1元/Credit
	记忆检索	`contextdb_mem_retrieval`	检索记忆过程产生的费用，按Credit计费
	知识写入	`contextdb_rag_add_requests`	用户写入知识（含多模态）过程产生的费用，按Credit计费
	知识检索	`contextdb_rag_retrieval`	检索知识过程产生的费用，按Credit计费
	上下文演进	`context_growth`	记忆晋升、知识评审过程产生的费用，按Credit计费
存储	源存储空间	`agent_service_storage`	知识原文占用的存储空间，按用量（GB/小时）计费	0.00017元/GB/小时
存储	上下文存储空间	`agent_service_storage`	记忆、知识索引占用的存储空间，按用量（GB/小时）计费	0.0021元/GB/小时

使用限制

主流平台快速接入：支持Qoder、QoderWork、Claude Code、Codex、OpenClaw、OpenCode、Hermes和千问平台快速接入，其他平台需要手动配置。
记忆共享：同一Agent下（含跨Session）的记忆可共享，记忆数据暂不支持导出。
知识库：同一Workspace内成员可共享知识库内容（通过知识库内容共享，可以实现跨Agent的业务背景共享）。当前支持通过控制台、命令行或在Agent内通过对话的方式上传知识文档，暂不支持知识库导出。
记忆隔离：不同成员之间记忆内容互相隔离，同一成员下不同API Key不隔离。

步骤一：开通RDS ContextDB

登录RDS管理控制台。
在左侧导航栏中单击RDS ContextDB。
在RDS ContextDB页面，单击开通RDS ContextDB。

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

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

登录RDS管理控制台。
在左侧导航栏中单击RDS ContextDB进入管理页面。
单击新建按钮并在弹窗中填写工作空间名称与初始管理员名称并单击确定。
API Key将会自动生成。请立即妥善保存 API Key，关闭后将无法再次查看，单击我已保存。

说明

您也可以直接通过OpenAPI操作ContextDB，详情请参见RDS ContextDB API参考。

步骤三：安装与连接ContextDB

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

说明

以下安装方式中<API_KEY>均需替换为您在上一步中保存的API Key。

方式一：通过自然语言安装与连接

复制以下文本并发送给您的Agent，通过Agent自动完成安装与接入。

请阅读 https://context-database-client.oss-cn-hangzhou.aliyuncs.com/install.md，按照脚本说明安装 ctxdb CLI，并使用 API Key <API_KEY> 为你自己完成接入配置。

方式二：通过命令行安装与连接

Qoder

Linux/macOS/WSL

curl -fsSL 'https://context-database-client.oss-cn-hangzhou.aliyuncs.com/install.sh' | bash -s -- --agent qoder --api-key <API_KEY>

Windows PowerShell

& ([ScriptBlock]::Create((irm 'https://context-database-client.oss-cn-hangzhou.aliyuncs.com/install.ps1'))) -Agent qoder -ApiKey <API_KEY>

Claude

Linux/macOS/WSL

curl -fsSL 'https://context-database-client.oss-cn-hangzhou.aliyuncs.com/install.sh' | bash -s -- --agent claude --api-key <API_KEY>

Windows PowerShell

& ([ScriptBlock]::Create((irm 'https://context-database-client.oss-cn-hangzhou.aliyuncs.com/install.ps1'))) -Agent claude -ApiKey <API_KEY>

Codex

Linux/macOS/WSL

curl -fsSL 'https://context-database-client.oss-cn-hangzhou.aliyuncs.com/install.sh' | bash -s -- --agent codex --api-key <API_KEY>

Windows PowerShell

& ([ScriptBlock]::Create((irm 'https://context-database-client.oss-cn-hangzhou.aliyuncs.com/install.ps1'))) -Agent codex -ApiKey <API_KEY>

OpenCode

Linux/macOS/WSL

curl -fsSL 'https://context-database-client.oss-cn-hangzhou.aliyuncs.com/install.sh' | bash -s -- --agent opencode --api-key <API_KEY>

Windows PowerShell

& ([ScriptBlock]::Create((irm 'https://context-database-client.oss-cn-hangzhou.aliyuncs.com/install.ps1'))) -Agent opencode -ApiKey <API_KEY>

OpenClaw

Linux/macOS/WSL

curl -fsSL 'https://context-database-client.oss-cn-hangzhou.aliyuncs.com/install.sh' | bash -s -- --agent openclaw --api-key <API_KEY>

Windows PowerShell

& ([ScriptBlock]::Create((irm 'https://context-database-client.oss-cn-hangzhou.aliyuncs.com/install.ps1'))) -Agent openclaw -ApiKey <API_KEY>

Hermes

Linux/macOS/WSL

curl -fsSL 'https://context-database-client.oss-cn-hangzhou.aliyuncs.com/install.sh' | bash -s -- --agent hermes --api-key <API_KEY>

Windows PowerShell

& ([ScriptBlock]::Create((irm 'https://context-database-client.oss-cn-hangzhou.aliyuncs.com/install.ps1'))) -Agent hermes -ApiKey <API_KEY>

QoderWork

Linux/macOS/WSL

curl -fsSL 'https://context-database-client.oss-cn-hangzhou.aliyuncs.com/install.sh' | bash -s -- --agent qoderwork --api-key <API_KEY>

Windows PowerShell

& ([ScriptBlock]::Create((irm 'https://context-database-client.oss-cn-hangzhou.aliyuncs.com/install.ps1'))) -Agent qoderwork -ApiKey <API_KEY>

核心功能

RDS ContextDB工作空间内提供概览、API Key管理、记忆、记忆晋升、知识库、用量与审计日志管理等核心能力。

1. 概览

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

工作空间概览：展示工作空间名称与ID、运行状态和Endpoint等核心指标的汇总信息，帮助您快速了解服务的整体使用情况。
安装与连接：提供平台接入RDS ContextDB的引导信息，帮助您快速完成Agent对接。

2. API Key管理

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

成员管理：添加或删除工作空间成员
API Key管理：为各成员快速配置或吊销相应的API Key。

3. 记忆

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

事实：从上下文中拆解出的原子化的陈述（自洽短句），作为主要检索对象并向量化，召回时通常在这一层做语义命中。
实体：高频出现的人、组织、项目、工具等，会沉淀为带属性、别名、重要性评分等内容的常驻画像（Entity Card），并与后续写入的结论条目绑定，使会话重启时不从零铺垫背景。所有实体可构建实体关系图谱，通过可视化的方式展示实体间的联系。
记忆规则：可以根据业务需要自定义成员的记忆。

4. 记忆晋升

记忆晋升支持记忆成文功能，其能将Agent使用过程中沉淀的记忆自动整理为团队可复用知识的能力。该功能不会简单拼接记忆，而是通过一组Agent角色协作，完成资料检索、事实校验、文档写作、质量审核和风险标记，将分散的经验转化为结构化、可审核、可沉淀的知识文档。

发起记忆成文任务

进入RDS ContextDB工作空间，在导航栏中选择记忆晋升，进入记忆成文页面。
单击新建晋升任务，输入您想成文的主题关键词。
系统将根据记忆内容自动生成围绕该关键词的知识文档，等待生成完成后进入审批流程。

审批文档

对于状态为待审核的文档，单击查看详情即可进入审批页面。在审批页面中，您可以：

编辑文档信息：修改文档标题与内容。
处理疑问列表：查看系统标记的待确认疑点（如事实冲突、证据不足等），按照选项进行选择或自定义答案。
单击提交修订，文档将回到生成中状态，系统根据修订内容重新生成。

完成修改后，您可以：

单击批准，文档将进入指定知识库，您可以在知识库页面的文档管理中看到新入库的文档。
单击拒绝，文档将被标记为不适合放入知识库。

5. 知识库

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

通过控制台管理

创建知识库
1. 进入RDS ContextDB工作空间，在导航栏中选择知识库，进入知识库列表。
2. 单击新建知识库，输入名称，选择是否开启知识图谱与知识评审，单击确定。
  - 知识图谱：开启后，ContextDB会将非结构化或半结构化的知识转化为结构化的图谱数据，并在知识检索时返回图增强索引信息。
  - 知识评审：开启后，当文档上传到知识库时，系统会自动进行质量评估、自矛盾检测和重写建议，并根据配置决定自动入库或人工审核。
上传文档
1. 在导航栏中选择知识库，进入文档管理界面，选择需要上传文档的目标知识库。
2. 单击上传文档，根据需要勾选上传后进行知识评审，选择文件后单击确定。
  1. 当入库状态变为成功时，表示文档成功上传知识库。
  2. 当入库状态变为等待人工评审时，您需要前往知识评审页面进行人工审核。
查看知识库图谱
1. 在导航栏中选择知识库，进入知识库图谱界面。
2. 选择知识库名称与文档后，单击执行查询。

通过自然语言管理

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

创建知识库

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

上传文档

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

知识召回

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

通过命令行管理

创建知识库

# 命令返回的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": "测试知识库"}'

上传文本文档或本地文件

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

知识召回

# 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}'

6. 知识评审

当文档上传到知识库时，系统会自动进行质量评估、自矛盾检测和重写建议，并根据配置决定自动入库或人工审核。

重要

当前文档评审仅支持txt/md/pdf/doc/docx格式文档。

配置评审策略

进入RDS ContextDB工作空间，在导航栏中选择知识评审，进入评审策略页签。
配置自动入库阈值：当置信度低于该阈值时，需要人工评审；高于该阈值时文档自动入库并可被Agent召回。
配置重写文档自动入库：开启该功能时，如果重写后的文档置信度高于自动入库阈值，将自动入库。

评审列表

进入RDS ContextDB工作空间，在导航栏中选择知识评审，选择成员，进入评审列表页签，评审任务将分为以下三类：

待审核：
- 文档质量分数低于自动入库阈值：无论文档是否自动重写（噪音度高于0.3时触发重写），当质量分数低于设定阈值时，均需要人工审核。
- 未开启重写自动入库功能时，如果文档触发自动重写，重写后的文档均需要人工审核。
已通过：人工审核通过的文档，或置信度高于阈值自动入库的文档。
说明
如果开启重写文档自动入库功能，重写后自动入库的文档，依然可以在已通过区域选择拒绝，拒绝后重写的文档将从知识库中删除。
已拒绝：人工审核后拒绝入库的文档评审。

7. 用量与审计日志管理

您可以在用量管理页面查看当前工作空间的用量数据，包括调用次数、Token消耗和存储占用信息，也可以在审计日志页签处查看API调用的日志记录。

附录：文件大小及格式限制

RDS ContextDB对上传至知识库的文件有大小及格式限制：

文件类型	单个文件大小上限	支持格式
纯文本	20 MB	文本：txt、md、csv、tsv、log 标记/数据：json、xml、yaml、yml、html、htm 代码：java、py、js、ts、jsx、tsx、go、rs、c、cpp、h、hpp、cs、rb、php、swift、kt、scala、lua、r、m 脚本：sh、bash、zsh、bat、ps1 查询/接口：sql、graphql、proto 样式：css、scss、less、sass 框架：vue、svelte 配置：toml、ini、cfg、conf、properties、env、dockerfile、makefile、cmake、gitignore、editorconfig
复杂文档/图片	500 MB	复杂文档：pdf、doc、docx、ppt、pptx、xls、xlsx、epub 图片：png、jpg、jpeg、gif、bmp、webp、tiff、tif、svg
音频	10 MB/5分钟	mp3、wav、flac、ogg、m4a、aac、wma
视频	2 GB	mp4、avi、mov、mkv、webm、flv、wmv、3gp、mpeg、mpg

API名称	描述
CreateContextDatabaseWorkspace	创建工作空间、首位成员和首把 API Key 的一次性引导流程。
CreateContextDatabaseApiKey	创建 API Key。
CreateContextDatabaseMember	创建成员。
UpdateContextDatabaseWorkspace	更新工作空间。
UpdateContextDatabaseMember	更新成员。
UpdateContextDatabaseApiKey	更新API Key。
ListContextDatabaseWorkspaces	列出工作空间。
ListContextDatabaseMembers	列出成员。
ListContextDatabaseApiKeys	列出API Key。
DeleteContextDatabaseWorkspace	删除工作空间。
DeleteContextDatabaseMember	删除成员。
RevokeContextDatabaseApiKey	吊销API Key。