向量数据库工具

taskflow_vector 提供向量数据库操作能力，支持语义搜索和 RAG 应用

---

📋 可用工具

工具名	功能	安全性
taskflow_vector_search	语义搜索	✅ Medium
taskflow_vector_insert	插入向量	✅ Medium
taskflow_vector_delete	删除向量	✅ High
taskflow_vector_listCollections	列出集合	✅ Low

---

🔧 工具详解

search

语义搜索。

参数：

{
  "collection": "string",  // 集合名（必填）
  "query": "string",       // 查询文本（必填）
  "topK": 5,               // 返回数量（可选）
  "filter": {}             // 过滤条件（可选）
}

示例：

Claude: 搜索关于机器学习的内容

调用：

{
  "name": "taskflow_vector_search",
  "arguments": {
    "collection": "documents",
    "query": "机器学习",
    "topK": 5
  }
}

返回：

{
  "success": true,
  "results": [
    {
      "id": "doc-1",
      "score": 0.95,
      "metadata": {"title": "机器学习入门"},
      "content": "机器学习是..."
    }
  ]
}

---

insert

插入向量。

参数：

{
  "collection": "string",  // 集合名（必填）
  "vectors": [],           // 向量数据（必填）
  "metadata": {}           // 元数据（可选）
}

示例：

Claude: 把这个文档插入向量数据库

调用：

{
  "name": "taskflow_vector_insert",
  "arguments": {
    "collection": "documents",
    "vectors": [
      {
        "id": "doc-1",
        "vector": [0.1, 0.2, ...],
        "metadata": {"title": "文档标题"}
      }
    ]
  }
}

---

🔒 安全机制

1. 权限控制

集合访问权限：

collections:
  documents:
    read: true
    write: true
  private:
    read: false  # 禁止读取
    write: false

2. 向量大小限制

限制项	默认值
向量维度	1536
批量大小	100
结果数量	100

3. 敏感数据过滤

元数据中的敏感字段会被过滤：

// ❌ 被过滤的字段
password
token
secret
apiKey

---

💡 使用技巧

技巧一：RAG 应用

Claude: 基于知识库回答这个问题

Claude 会先搜索向量数据库，然后基于结果生成答案。

技巧二：文档索引

Claude: 帮我索引这些文档

Claude 会提取向量并插入数据库。

技巧三：相似搜索

Claude: 找到与这个文档相似的文档

Claude 会计算相似度并返回结果。

---

🔗 相关链接

• MCP 工具总览
• 数据库工具

---

向量搜索有问题随时问我