---
title: 嵌入提供商
summary: 通过连接嵌入提供商，为记忆和技能启用真正的语义搜索；或者跳过此步骤，使用免费的纯文本匹配。
date: 2026-09-17
---

# 嵌入提供商

通过连接嵌入提供商，为记忆和技能启用真正的语义搜索；或者跳过此步骤，使用免费的纯文本匹配。

## 向量搜索与纯文本搜索

可在**设置 → 嵌入**中进行配置。默认情况下，记忆和技能的查找使用纯文本（关键词）匹配，不产生额外费用。连接一个嵌入提供商后会改为启用向量搜索，使查找按语义而非精确字词进行匹配。页面顶部的开关可在**向量搜索**和**纯文本搜索**之间切换。

## 支持的提供商

共有七个提供商，各自拥有自己的嵌入模型：

- **OpenAI**
- **Voyage AI**
- **Cohere**
- **Mistral**
- **Google Gemini**
- **Hugging Face**
- **Ollama（本地）**：唯一无需 API 密钥的选项。将其指向本地的 Ollama 安装，并使用**发现**功能导入你已有的模型。

大多数提供商会显示一个模型下拉列表，列出每个选项的维度和每个 token 的费用；Ollama 和 Hugging Face 则改为使用自由文本形式的模型名称。

## 保存前先测试

在保存新的或修改过的提供商之前，请使用**测试连接**。它会返回所得向量的维度和延迟，方便你在记忆和技能搜索开始依赖该连接之前，先确认它确实可用。

## 之后更换提供商

如果你更换提供商或模型，技能的嵌入会在后台自动重建；在重建完成之前，现有技能会继续使用其旧的向量正常工作，因此搜索在此期间不会中断。记忆的重建方式并不相同：更换提供商只会改变新记忆的比对对象，而不会追溯性地重建旧记忆。请将更换提供商视为一个应尽早做出的决定，而不是在智能体已经积累了大量有意义的记忆之后可以随意更改的事。

## 未配置或出现故障时

未配置嵌入提供商，或提供商无法访问，都不会导致记忆或技能搜索失效：HeartBeatAgents 会为该次查找回退到纯文本匹配，而不是报错。如果你发现这种回退意外发生，请参见[智能体无法正确回忆记忆](/zh/docs/troubleshooting/memory-recall-degraded)。

## 相关内容

- [记忆](/zh/docs/features/memory)：语义搜索究竟能带来哪些提升
- [智能体无法正确回忆记忆](/zh/docs/troubleshooting/memory-recall-degraded)：诊断静默回退到纯文本搜索的情况