RDS ContextDB快速入门

通过控制台管理

1. 创建知识库

   1. 在导航栏中选择知识库，进入知识库列表。

   2. 单击新建知识库，输入名称，选择是否开启知识图谱与知识评审，单击确定。

      • 知识图谱：开启后，ContextDB会将非结构化或半结构化的知识转化为结构化的图谱数据，并在知识检索时返回图增强索引信息。

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

2. 上传文档

   1. 选择需要上传文档的目标知识库。

   2. 单击上传文件，根据需要勾选上传后进行知识评审，选择文件后单击确定。

      1. 当入库状态变为成功时，表示文档成功上传知识库。

      2. 当入库状态变为等待人工评审时，您需要前往知识评审页面进行人工审核。

3. 查看知识库图谱

   1. 在导航栏中选择知识库，进入知识图谱界面。

   2. 查看图谱：查看知识库中实体间的联系，支持选定实体名称与文件范围进行检索。

   3. 实体管理：查看当前知识库下所有实体，并支持手动添加实体。

通过自然语言管理

接入 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/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"

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

记忆晋升环节

知识评审环节