Weaviate Claude Skills

为什么要用

核心特性

涵盖整个本地Weaviate生命周期的五项技能
本地实例的Docker撰写模板
批量摄取和基于文件的导入
使用过滤器、混合搜索和分析的RAG查询
使用requirements.txt设置Pythonvenv

实时演示

实际使用效果

weaviate-claude-skills.replay ▶ 就绪

0/0

安装

作者仓库 · Claude Skills 官方文档

使用场景

实战用法： Weaviate Claude Skills

在1小时内为您的文档抹上当地的破布

👤 开发人员启动本地RAG原型 ⏱ ~60 min intermediate

何时使用： 您希望在不将文档发送给云供应商的情况下与自己的文档聊天。

步骤

Docker-start Weaviate

使用weaviate-local-setup为本地Weaviate启动docker-compose。✓ 已复制

→ docker ps在8080上显示weaviate healthy
建立收藏

使用字段创建集合“Docs” ： title (text)、body (text)、source_url (text)。✓ 已复制

→ 已应用架构； weaviate-collection-manager返回配置
上传

将./docs下的每个.md文件作为“Docs”中的对象导入。✓ 已复制

→ 已报告批处理进度；对象通过查询可见
發問

使用weaviate-query-agent: '我们如何轮换API密钥？'✓ 已复制

→ Answer引用了文档集合中的source_url

结果： 您可以迭代的可运行的本地抹布。

注意事项

导入整个巨型PDF ，无需分块 — 分块约500个代币；让技能的摄取模板处理它

搭配使用： filesystem

无需手动API调用即可迭代集合架构

👤 优化矢量架构的团队 ⏱ ~20 min intermediate

何时使用： 早期RAG —您的架构每周更改一次，您不需要curl命令。

步骤

检查当前架构

显示“文档”的架构—字段，矢量化程序，索引配置。✓ 已复制

→ 已返回完整配置
提出变更

添加“language”枚举属性（ en/zh/ja ）；保留其余部分。✓ 已复制

→ 迁移计划+备份警告
确认

应用；重新索引现有的500个对象。✓ 已复制

→ 作业进度；计数对账

结果： 架构在意识到重新索引成本的情况下安全地发展。

注意事项

假设房源移除是免费的 — 某些更改需要重新嵌入；技能标记便宜与昂贵

混合搜索+过滤器，提供可靠答案

👤 任何人都可以将抹布运送给真实用户 ⏱ ~15 min intermediate

何时使用： 纯语义搜索丢失了完全匹配的术语；混合（ BM25 +向量）修复了它。

步骤

运行混合查询

查询“SAML SSO错误代码42” ， alpha = 0.5 （平衡语义+关键字）。✓ 已复制

→ 热门歌曲包括字面上的“42”匹配，但也包括与概念相关的匹配
图层过滤器

筛选语言= 'en' ， source_url包含'/docs/auth/'。✓ 已复制

→ 点击量缩小；答案仍被引用

结果： 精确术语查询的精确度更高，而不会丢失召回率。

搭配使用： local-rag

组合

与其他 MCP 搭配，撬动十倍杠杆

weaviate-claude-skills + filesystem

通过文件系统MCP导入本地文件，然后通过技能查询

列出./docs下的所有扣分项，导入Weaviate “Docs” ，然后混合搜索问题。✓ 已复制

weaviate-claude-skills + local-rag

比较方法—仅嵌入与Weaviate的结构化指数

对于此语料库，请在10个评估问题上对比local-rag和Weaviate混合语料库。✓ 已复制

weaviate-claude-skills + qdrant

评估工作负载上的矢量数据库选择

在Weaviate和Qdrant上运行相同的eval集；报告延迟+ MRR。✓ 已复制

工具

此 MCP 暴露的能力

工具	输入参数	何时调用
weaviate-local-setup (SKILL)	(none)	仅限第一次—带出本地Weaviate
weaviate-connection (SKILL)	URL + API key	验证可访问性和身份验证
weaviate-collection-manager (SKILL)	schema ops	创建、检查或改进集合
weaviate-data-ingestion (SKILL)	object(s) or file paths	单次插入、批量插入或文件导入
weaviate-query-agent (SKILL)	query + filters + alpha	语义/混合搜索和RAG答案

成本与限制

运行它的成本

API 配额: 无— Weaviate在本地运行
每次调用 Token 数: 查询+检索到的区块大小
费用: 本地免费。如果您以后迁移， Weaviate Cloud有自己的定价。
提示: 故意分块（约500个代币）；超大块浪费存储和上下文。

安全

权限、密钥、影响范围

凭据存储： 在.env中编织API密钥，而不是在技能文件中。本地开发人员可以跳过身份验证，但不会暴露端口。

数据出站： 没有任何东西离开您的机器进行本地设置。Cloud Weaviate发送到您配置的端点。

在许多映像中，本地Weaviate默认绑定到0.0.0.0 —如果其他服务在您的LAN上运行，则限制为127.0.0.1。
嵌入模型：如果使用第三方矢量化工具，您的块将转到该提供商。将敏感数据保留在本地（例如， text2vec-transformers ）。

故障排查

常见错误与修复

连接被拒绝

Weaviate容器未运行。docker在weaviate-local-setup中compose up -d。

验证： curl localhost:8080/v1/.well-known/ready

架构更改失败

某些属性更改需要重新创建集合。导出、丢弃、重新创建、重新添加。

验证： weaviate-collection-manager diff output

缓慢查询

检查HNSW索引参数，并确保矢量化器配置正确。避免在未索引的字段上进行全文回退。

验证： Query explain in the skill's debug mode

替代方案