Skip to main content

向量数据库工具

向量数据库功能

提供完整的向量数据库操作接口,支持:
  • 数据检索和向量搜索
  • 数据的增删改查
  • 批量操作
  • 条件过滤

获取数据列表

/tool/vdb/{className}
获取指定数据库的数据列表。

路径参数

参数名类型必选说明
classNamestring数据库名称

查询参数

参数名类型必选说明
limitnumber返回数量
skipnumber跳过数量
whereobject查询条件
GET /tool/vdb/wainao_chat?limit=10&skip=0
Authorization: Bearer YOUR_TOKEN

获取单条数据

/tool/vdb/{className}/{id}
获取指定ID的数据详情。

路径参数

参数名类型必选说明
classNamestring数据库名称
idstring数据ID
GET /tool/vdb/wainao_chat/doc123
Authorization: Bearer YOUR_TOKEN

创建数据

/tool/vdb/{className}
创建新的向量数据。

请求参数

参数名类型必选说明
contentstring内容文本
tagsarray标签列表
metadataobject元数据
POST /tool/vdb/wainao_chat
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN

{
  "content": "新的文档内容",
  "tags": ["AI", "新文档"],
  "metadata": {
    "author": "用户名",
    "createTime": "2024-01-10"
  }
}

更新数据

/tool/vdb/{className}/{id}
更新指定ID的数据。

路径参数

参数名类型必选说明
classNamestring数据库名称
idstring数据ID
PATCH /tool/vdb/wainao_chat/doc789
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN

{
  "content": "更新后的文档内容",
  "tags": ["AI", "更新文档"]
}

删除数据

/tool/vdb/{className}/{id}
删除指定ID的数据。

路径参数

参数名类型必选说明
classNamestring数据库名称
idstring数据ID
DELETE /tool/vdb/wainao_chat/doc789
Authorization: Bearer YOUR_TOKEN
删除操作不可恢复,请谨慎操作。

向量搜索

/tool/vdb/{className}/vector
基于内容进行向量相似度搜索。

路径参数

参数名类型必选说明
classNamestring数据库名称

请求参数

参数名类型必选说明
contentstring搜索内容
queryobject查询条件
POST /tool/vdb/wainao_chat/vector
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN

{
  "content": "查找相似的AI文档",
  "query": {
    "filter": {
      "tags": ["AI"]
    },
    "limit": 10
  }
}
向量搜索支持基于内容的相似度匹配,可以通过query参数进行精确过滤。

错误码说明

错误码说明
400请求参数错误
404数据不存在
422数据处理错误
500服务器错误