一、这个功能能做什么
在 瓜奇 → 综合 → 全局基础数据 → 第三方服务 → AI 设置 选择 AI 通道并填写该通道要求的模型、接口地址和密钥。智能搜索中的向量能力应使用可生成向量的模型；能聊天的模型不一定支持向量接口。
先认识这几个词
- API Key：访问某项服务的凭据，也称 API 密钥；应填入对应服务的设置中并妥善保管。
- 向量：把文字转换成便于计算相似程度的数据，用于帮助查找意思相近的内容。
- 索引：搜索服务为内容建立的可查询资料集；文章存在不等于已经收录进搜索。
二、设置后会有什么效果
可以为内容补全、翻译和知识助手配置适用的 AI 能力，并为语义搜索设置向量模型。聊天模型负责生成文字，向量模型帮助查找相近内容，两者用途不同。
三、怎么使用
先明确用途：AI 编辑补全、文章整包翻译、知识助手生成回答、搜索向量是不同环节。一个环节成功不能替代另外几个环节的验证。
配置顺序
- 在实际服务商取得相应模型权限，按照其接口规范填写地址及模型标识。
- 保存 AI 通道，先用短文本检查编辑补全。
- 如需语义搜索，配置向量模型，按智能搜索操作更新对应内容的向量。
- 再检查知识助手是否能引用目标站点、目标语言下的文章回答问题。
更换向量模型后，不应假设旧向量仍与新模型兼容；应按当前索引维护入口完成相应更新。不要直接修改数据库向量字段。
文章整包 AI 翻译还有独立开关。当前版本在选用 AI 后失败时，默认不自动退回普通翻译厂家。接口正常但译文未出现时，检查所选字段、覆盖策略和任务状态，参见 03.08 复制与自动翻译。
排查时提供模型名、操作时间及脱敏错误即可，不向知识库提交密钥或完整请求凭据。
语义模型字段速查
“AI 语义模型”在智能搜索内，独立于编辑生成通道：
| 提供商 | 当前配置字段 |
|---|---|
| 智谱 | API Key、Embedding-3／Embedding-2、适用语义维度选项 |
| OpenAI Embedding | API Key、text-embedding-3-small／large |
| Ollama | 嵌入接口地址、模型名；首次默认地址 http://localhost:11434/api/embed、模型 bge-m3 |
这是当前瓜奇配置支持的选项，不代表服务商账户已开通这些模型。维度越高也不能被解释为每个知识库问题一定回答更准确。
四、常见问题
聊天模型能直接用作向量模型吗？
不一定。聊天模型负责生成文字，向量模型负责将内容转成便于相似检索的数据。按各自入口配置受支持的模型，并分别检查生成和搜索效果。