用途:该技能面向 Weaviate 向量数据库的日常操作,适合需要查看集合、模式或数据分布,执行语义/混合/关键词/过滤/Query Agent 搜索,以及导入 CSV、JSON、JSONL、PDF 数据或创建示例数据的场景。
主要能力:搜索与查询方面,Query Agent 的 Ask 模式可基于一个或多个集合给出带来源引用(集合名与对象 ID)的结构化回答,Search 模式返回原始对象;混合搜索为默认选择,兼顾语义与关键词;语义搜索用于概念相似内容;关键词搜索用于精确词、ID、SKU。集合管理方面,可列出集合、查看集合详情(属性、数据类型、向量化配置、副本因子、多租户状态)、探索数据分布与取值、创建自定义模式集合。数据操作方面,可按 ID 或过滤条件获取对象,导入文件,生成示例数据。
使用方式:需先配置环境变量 WEAVIATE_URL 与 WEAVIATE_API_KEY,外部向量化服务密钥按集合实际使用情况设置。常用命令包括:uv run scripts/list_collections.py;uv run scripts/example_data.py;uv run scripts/get_collection.py --name "COLLECTION_NAME";uv run scripts/explore_collection.py "COLLECTION_NAME";创建集合 uv run scripts/create_collection.py CollectionName --properties '[{"name": "title", "data_type": "text"}, {"name": "body", "data_type": "text"}]';导入 uv run scripts/import.py "data.csv" --collection "CollectionName"。PDF 导入会自动创建集合。未明确要求时不要指定向量化器,默认使用 text2vec_weaviate。所有脚本支持 Markdown 表格(默认)与 JSON(--json)。
限制:需要可访问的 Weaviate 实例与有效凭据;导入、建集合与 Query Agent 操作可能改动或暴露数据,运行前应确认目标实例与集合;脚本仅聚焦 Weaviate,不替代数据治理、备份或生产迁移流程。若尚无实例,可前往 Weaviate Cloud 注册并创建免费沙箱。