SuperAPI AI 工具集

aliyun-dashvector-search

编程与开发

查看项目

更新于 10-16 03:42

技能介绍

用途:通过 DashVector 的 Python SDK 管理集合(collection)并执行向量相似度检索,支持可选过滤条件与稀疏向量。

安装与配置:建议在虚拟环境中安装 SDK:python3 -m venv .venv,. .venv/bin/activate,python -m pip install dashvector。通过环境变量提供凭据与端点:DASHVECTOR_API_KEY、DASHVECTOR_ENDPOINT(集群端点)。

主要能力:创建集合,参数包括 name、dimension、metric(cosine | dotproduct | euclidean)以及可选的 fields_schema(字段类型字典);写入文档,docs 为 {id, vector, fields} 或元组列表,支持 sparse_vector 与多向量集合;查询文档,vector 或 id 二者至少其一(均为空时仅应用 filter),并支持 topk、filter(类 SQL 的 where 子句)、output_fields、include_vector。

用法要点:优先使用 upsert 实现幂等写入;dimension 需与嵌入模型输出维度一致;用 filter 做租户或数据集范围限定;使用稀疏向量时在写入或查询中传 sparse_vector={token_id: weight, ...}。脚本方式可运行 python skills/ai/search/aliyun-dashvector-search/scripts/quickstart.py,相关环境变量为 DASHVECTOR_API_KEY、DASHVECTOR_ENDPOINT、可选 DASHVECTOR_COLLECTION、DASHVECTOR_DIMENSION,可选参数为 --collection、--dimension、--topk、--filter。

错误处理:401/403 表示 DASHVECTOR_API_KEY 无效;400 表示集合 schema 无效或维度不匹配;429/5xx 建议指数退避重试。

限制:具体收费、价格、配额、可用地域及其他平台细节资料暂未提供。