关于 together-embeddings
面向开发者的 Together 技能,用于构建语义检索流程,涵盖嵌入生成、候选检索、重排和 RAG 示例。它专注于语言模型生成之前的检索环节。
主要功能
- 01生成单条和批量嵌入
- 02构建余弦相似度语义搜索
- 03重排检索候选项
- 04组合 RAG 检索与生成流程
适用场景
- 01为应用添加语义搜索
- 02在数据流水线中生成文档嵌入
- 03通过重排改善候选项排序
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ togethercomputer/ skills --skill together-embeddings安装后在 Claude Code 中输入/together-embeddings确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/api-reference.mdmodels.mdscripts/embed_and_rerank.pyembed_and_rerank.tsrag_pipeline.pysemantic_search.py详细介绍
Together Embeddings 与 Reranking
概述
在以下语义检索场景中使用此技能:
- 创建嵌入
- 批量生成嵌入
- 构建检索或 RAG 管道
- 对检索到的候选项重新排序
此技能用于检索流程,而非生成最终的大模型响应。
适用场景
- 构建向量搜索或语义相似度功能
- 将嵌入生成添加到数据管道
- 通过重新排序提升检索质量
- 在调用聊天模型前组装检索阶段
转交给其他技能
- 使用
together-chat-completions完成最终答案生成步骤 - 对于超大规模离线嵌入回填,使用
together-batch-inference - 当重新排序需要专用部署时,使用
together-dedicated-model-inference
快速路由
- Embeddings API 用法
- 语义搜索(嵌入、存储、查询)
- 从 scripts/semantic_search.py 开始——其中包含内存向量存储、余弦相似度检索和可选的重新排序
- RAG 管道编排
- 模型选择和重新排序限制
工作流
- 确认用户需要的是向量或检索,而非直接生成。
- 选择嵌入模型和批次大小。
- 为语料库和查询路径生成嵌入,并保持方式一致。
- 检索候选项。内存余弦相似度存储适用于原型开发和小型语料库(参见
semantic_search.py)。生产规模请使用专用向量数据库。 - 只有在额外延迟和端点要求合理时才进行重新排序。如果没有可用的专用重新排序端点,使用余弦相似度排序作为合理的备选方案。
高优先级规则
- Python 脚本需要 Together v2 SDK(
together>=2.0.0)。如果用户使用的是旧版本,必须先升级:uv pip install --upgrade "together>=2.0.0"。 - 将嵌入和重新排序视为不同环节;重新排序是第二阶段的精度优化步骤。
- 此仓库中的重新排序假定使用专用端点。除非产品发生变化,否则不要承诺支持无服务器重新排序。如果没有可用端点,请退回到余弦相似度排序。
- 嵌入模型的上下文限制为 514 个 token。对较长的文档进行分块后再生成嵌入。
rag_pipeline.py示例展示了检索与生成;应将生成环节转交给 chat completions。- 索引和查询时保持模型一致。
资源索引
- API 详情:references/api-reference.md
- 模型指南:references/models.md
- Python 嵌入示例:scripts/embed_and_rerank.py
- TypeScript 嵌入示例:scripts/embed_and_rerank.ts
- Python 语义搜索:scripts/semantic_search.py
- Python RAG 管道:scripts/rag_pipeline.py
官方文档
评论
支持 Markdown