核心用法
Embeddings 技能提供完整的向量化工作流，涵盖四大核心环节：
1. 嵌入生成：支持 OpenAI、Cohere、Voyage 等云服务商及 E5、BGE、Nomic 等本地模型。通过批量 API 调用（batch size ≤100）配合指数退避重试策略处理大规模数据集，避免单条处理导致的性能瓶颈与成本激增。
2. 智能分块：提供三种分块策略——基于 token 限制的分割、语义边界感知分块、10-20% 重叠窗口分块，有效防止上下文断裂。决策前需确认内容类型（文本/代码/图像/多模态）、数据体量与更新频率。
3. 向量存储：无缝集成 Pinecone、Weaviate、Qdrant、pgvector、Chroma 等主流向量数据库，支持元数据过滤与混合搜索（hybrid search）。
4. 相似度检索：实现 top-k 查询、类别过滤、包含元数据返回，支持余弦相似度计算（需确保查询与文档使用同一模型，并做归一化处理）。
显著优点
- 供应商灵活性：从顶级质量（OpenAI text-embedding-3-large）到成本敏感型（text-embedding-3-small，成本降低 80%）、多语言（Cohere embed-multilingual-v3，支持 100+ 语言）、代码专用（Voyage voyage-code-2）、隐私优先（完全本地部署）全覆盖
- 生产级最佳实践内置：强制批量处理、嵌入缓存（基于源内容哈希）、维度监控（768-1536 为最优区间）、归一化预处理
- 决策框架清晰：提供 5 维度评估清单（内容类型、体量、延迟要求、预算、现有基础设施），降低架构设计门槛
潜在局限
- 供应商锁定风险：不同嵌入模型输出维度与语义空间不兼容，切换成本极高
- 隐形成本：高频更新场景下，重新嵌入与向量数据库写入可能产生显著 API 与存储费用
- 本地模型运维负担：隐私场景需自行管理 GPU 资源、模型版本与推理优化
- 分块策略无银弹：领域特定内容（如法律条款、代码函数）需人工调优重叠比例与边界规则
适合人群
- 构建 RAG（检索增强生成）系统的 AI 应用开发者
- 需要企业级语义搜索的 SaaS 产品经理
- 处理多语言或代码库的智能检索场景的技术团队
- 对数据隐私有强合规要求的金融机构、医疗组织
常规风险
| 风险类别 | 具体描述 | 缓解建议 |
|---------|---------|---------|
| 模型不一致 | 查询与文档使用不同嵌入模型导致检索失效 | 强制代码审查与配置校验 |
| 维度灾难 | 盲目追求高维向量导致存储膨胀与检索延迟 | 监控 768-1536 甜蜜点，定期评估质量-成本曲线 |
| 缓存失效 | 源内容变更未触发重新嵌入 | 哈希校验 + 版本化存储策略 |
| 速率限制 | 批量处理未做退避导致 API 封禁 | 实现指数退避与并发控制 |
| 隐私泄露 | 敏感数据通过云 API 传输 | 本地模型部署或差分隐私预处理 |