提供嵌入与重排序模型 API 的服务——这是 Voyage AI 最主要的用途，也是本文讨论的前提。

下面按「现象 → 可能原因 → 处理办法」整理常见问题。

排查表

现象处理办法
答案引用了错误段落调整切分大小、加入重排序，并检查文档解析是否丢失标题。
表格内容检索不到换用能保留表格结构的解析工具，或单独把表格转成文本描述。
搜索结果过时限定时间范围，或在提问中注明需要最新信息并核对发布日期。
中文检索效果差选择对中文支持好的嵌入模型，并为专有名词建立同义词。
回答过于笼统要求逐条引用原文，并限定只回答文档中有依据的内容。

通用排查顺序

  1. 确认账号、额度和网络状态正常。
  2. 用一份简单材料复现问题，排除材料本身的干扰。
  3. 检查设置是否被改动（模型、语言、格式等）
  4. 查看官方状态页或更新日志。
  5. 仍无法解决时整理复现步骤联系官方支持。

用标准任务做对照测试

构建问答测试集

准备材料：一份产品手册。

根据手册编写 20 个用户可能问的问题及标准答案，标注答案所在章节，用来评估知识库检索效果。

检查点：每个答案都能在手册中找到。

更多可以试的用法

带来源的快速调研

适用情况：手头有一个需要事实支撑的问题时。

请回答【问题】，每个关键结论后标注来源链接；如果不同来源说法不一，请分别列出；最后给出你认为最可靠的来源及原因。

检查点：关键结论都有可点击来源。

检索效果对比

适用情况：手头有同一批问题和两种检索配置时。

用同一批测试问题分别跑关键词检索、向量检索和混合检索，记录前 5 条结果中正确段落的命中情况。

检查点：对比用同一批问题。

内部文档入库

输入：一批 PDF、Word 和网页。

把这些文档解析为干净的文本：保留标题层级和表格，去掉页眉页脚，按章节切分，每段附上原文件名和页码。

验收标准：切分后的段落能回溯到页码。

常见问题：回答过于笼统

要求逐条引用原文，并限定只回答文档中有依据的内容。

常见问题：答案引用了错误段落

调整切分大小、加入重排序，并检查文档解析是否丢失标题。

常见问题：中文检索效果差

选择对中文支持好的嵌入模型，并为专有名词建立同义词。

概念补充：重排序（Rerank）

对初步检索结果再次打分排序，提升相关性。

概念补充：切分（Chunking）

把长文档拆成适合检索的小段，大小影响效果。

适合人群：科研人员

科研人员可以用 Voyage 处理文献检索与阅读、实验记录与数据整理等工作。需要注意：遵守期刊和机构关于 AI 使用的披露要求，引用逐条核对。

适合人群：研究生

研究生可以用 Voyage 处理文献阅读、开题与论文写作等工作。需要注意：遵守学校学术诚信规定，AI 只用于辅助理解和润色。

注意事项

本文基于 Voyage AI 公开的定位与通用用法编写，具体功能、套餐与可用地区以官方页面为准，产品更新后界面和名称可能变化。

文中提示词和示例仅作示意，实际效果取决于你的材料和 Voyage 当前版本，重要内容请人工核对后再使用。

延伸阅读