---
title: Qdrant
description: 使用 Qdrant 向量数据库
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="qdrant"
  color="#1A223F"
  icon={true}
  iconSvg={`<svg className="block-icon"  fill='none' viewBox='0 0 49 56' xmlns='http://www.w3.org/2000/svg'>
      <g clipPath='url(#b)'>
        <path
          d='m38.489 51.477-1.1167-30.787-2.0223-8.1167 13.498 1.429v37.242l-8.2456 4.7589-2.1138-4.5259z'
          clipRule='evenodd'
          fill='#24386C'
          fillRule='evenodd'
        />
        <path
          d='m48.847 14-8.2457 4.7622-17.016-3.7326-19.917 8.1094-3.3183-9.139 12.122-7 12.126-7 12.123 7 12.126 7z'
          clipRule='evenodd'
          fill='#7589BE'
          fillRule='evenodd'
        />
        <path
          d='m0.34961 13.999 8.2457 4.7622 4.7798 14.215 16.139 12.913-4.9158 10.109-12.126-7.0004-12.123-7v-28z'
          clipRule='evenodd'
          fill='#B2BFE8'
          fillRule='evenodd'
        />
        <path
          d='m30.066 38.421-5.4666 8.059v9.5207l7.757-4.4756 3.9968-5.9681'
          clipRule='evenodd'
          fill='#24386C'
          fillRule='evenodd'
        />
        <path
          d='m24.602 36.962-7.7603-13.436 1.6715-4.4531 6.3544-3.0809 7.488 7.5343-7.7536 13.436z'
          clipRule='evenodd'
          fill='#7589BE'
          fillRule='evenodd'
        />
        <path
          d='m16.843 23.525 7.7569 4.4756v8.9585l-7.1741 0.3087-4.3397-5.5412 3.7569-8.2016z'
          clipRule='evenodd'
          fill='#B2BFE8'
          fillRule='evenodd'
        />
        <path
          d='m24.6 28 7.757-4.4752 5.2792 8.7903-6.3886 5.2784-6.6476-0.6346v-8.9589z'
          clipRule='evenodd'
          fill='#24386C'
          fillRule='evenodd'
        />
        <path
          d='m32.355 51.524 8.2457 4.476v-37.238l-8.0032-4.6189-7.9995-4.6189-8.0031 4.6189-7.9995 4.6189v18.479l7.9995 4.6189 8.0031 4.6193 7.757-4.4797v9.5244zm0-19.045-7.757 4.4793-7.7569-4.4793v-8.9549l7.7569-4.4792 7.757 4.4792v8.9549z'
          clipRule='evenodd'
          fill='#DC244C'
          fillRule='evenodd'
        />
        <path d='m24.603 46.483v-9.5222l-7.7166-4.4411v9.5064l7.7166 4.4569z' fill='url(#a)' />
      </g>
      <defs>
        <linearGradient
          id='a'
          x1='23.18'
          x2='15.491'
          y1='38.781'
          y2='38.781'
          gradientUnits='userSpaceOnUse'
        >
          <stop stopColor='#FF3364' offset='0' />
          <stop stopColor='#C91540' stopOpacity='0' offset='1' />
        </linearGradient>
        <clipPath id='b'>
          <rect transform='translate(.34961)'   fill='#fff' />
        </clipPath>
      </defs>
    </svg>`}
/>

{/* MANUAL-CONTENT-START:intro */}
[Qdrant](https://qdrant.tech) 是一个开源的向量数据库，专为高维向量嵌入的高效存储、管理和检索而设计。Qdrant 支持快速且可扩展的语义搜索，非常适合需要相似性搜索、推荐系统和上下文信息检索的 AI 应用。

使用 Qdrant，您可以：

- **存储向量嵌入**：高效管理和持久化大规模高维向量
- **执行语义相似性搜索**：实时查找与查询向量最相似的向量
- **过滤和组织数据**：使用高级过滤功能根据元数据或负载缩小搜索结果范围
- **获取特定点**：通过 ID 检索向量及其关联的负载
- **无缝扩展**：处理大型集合和高吞吐量工作负载

在 Sim 中，Qdrant 集成使您的代理能够以编程方式将 Qdrant 作为其工作流程的一部分进行交互。支持的操作包括：

- **插入或更新（Upsert）**：在 Qdrant 集合中插入或更新点（向量和负载）
- **搜索（Search）**：执行相似性搜索，以找到与给定查询向量最相似的向量，并可选择过滤和自定义结果
- **获取（Fetch）**：通过 ID 从集合中检索特定点，并可选择包括负载和向量

此集成使您的代理能够利用强大的向量搜索和管理功能，从而实现高级自动化场景，例如语义搜索、推荐和上下文检索。通过将 Sim 与 Qdrant 连接，您可以构建能够理解上下文、从大型数据集中检索相关信息并提供更智能、更个性化响应的代理——而无需管理复杂的基础设施。
{/* MANUAL-CONTENT-END */}

## 使用说明

将 Qdrant 集成到工作流程中。可以插入、搜索和获取点。需要 API 密钥。

## 工具

### `qdrant_upsert_points`

在 Qdrant 集合中插入或更新点

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `url` | string | 是 | Qdrant 基础 URL |
| `apiKey` | string | 否 | Qdrant API 密钥（可选）|
| `collection` | string | 是 | 集合名称 |
| `points` | array | 是 | 要插入或更新的点数组 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `status` | string | 插入或更新操作的状态 |
| `data` | object | 插入或更新操作的结果数据 |

### `qdrant_search_vector`

在 Qdrant 集合中搜索相似向量

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `url` | string | 是 | Qdrant 基础 URL |
| `apiKey` | string | 否 | Qdrant API 密钥（可选）|
| `collection` | string | 是 | 集合名称 |
| `vector` | array | 是 | 要搜索的向量 |
| `limit` | number | 否 | 要返回的结果数量 |
| `filter` | object | 否 | 要应用于搜索的过滤器 |
| `search_return_data` | string | 否 | 搜索中要返回的数据 |
| `with_payload` | boolean | 否 | 在响应中包含有效负载 |
| `with_vector` | boolean | 否 | 在响应中包含向量 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `data` | array | 向量搜索结果，包括 ID、分数、有效负载和可选的向量数据 |
| `status` | string | 搜索操作的状态 |

### `qdrant_fetch_points`

从 Qdrant 集合中通过 ID 获取点

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `url` | string | 是 | Qdrant 基础 URL |
| `apiKey` | string | 否 | Qdrant API 密钥（可选）|
| `collection` | string | 是 | 集合名称 |
| `ids` | array | 是 | 要获取的点 ID 数组 |
| `fetch_return_data` | string | 否 | 获取中要返回的数据 |
| `with_payload` | boolean | 否 | 在响应中包含有效负载 |
| `with_vector` | boolean | 否 | 在响应中包含向量 |

#### 输出

| 参数       | 类型  | 描述                     |
| --------- | ---- | ---------------------- |
| `data` | array | 包含 ID、有效负载和可选向量数据的获取点 |
| `status` | string | 获取操作的状态             |

## 注意事项

- 类别：`tools`
- 类型：`qdrant`
