> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xpertai.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 连接外部知识库

XpertAI 智能体平台支持连接外部知识库，通过系统集成方式扩展智能体的知识边界。此功能允许您的智能体直接访问和利用存储在外部知识库中的专业信息，无需重复上传或迁移数据，既能保障数据一致性，又能提升智能体问答的准确性和专业性。

本文将详细介绍如何在 XpertAI 平台上配置和使用外部知识库功能。

## 准备工作

在开始配置前，请确保您已准备好以下信息：

1. **外部知识库的 API 端点（Endpoint）**：这是 XpertAI 访问您知识库的地址URL，通常由您的知识库服务提供商提供。
2. **认证密钥（如需要）**：如果您的知识库需要 API Key、AK/SK 或其他形式的认证，请提前获取。
3. **知识库标识（ID 或名称）**：如果您的外部知识库系统管理多个库，您需要指定要连接的具体知识库 ID 或名称。

<Info>
  目前已经支持的知识库提供商有：**RAGFlow**, **Dify** 和 **FastGPT**
</Info>

## 配置步骤

以下是在 XpertAI 平台上连接外部知识库的详细步骤。

### 步骤 1：进入系统集成页面

1. 登录 XpertAI 设置模块。
2. 在左侧导航栏中，找到并点击“**集成**”。
3. 在“集成”页面，选择知识库相关的提供商类型。
4. 填写基础地址和授权信息后点击创建。

### 步骤 2：添加外部知识库连接

转到工作空间的“知识库”页面：点击连接外部知识库，填写基础信息后选择一个知识库集成连接。

### 步骤 3：高级设置（可选）

XpertAI 平台提供了高级检索参数配置，以优化召回效果：

* **Top K**：设置每次检索返回的最相关文本片段数量。增加此值可能会返回更多相关信息，但也可能增加无关信息的干扰。默认值通常为 3-5。
* **Score 阈值**：设置相关性分数阈值，只有分数高于此值的文本片段才会被返回。提高此值可以使结果更精准，但可能导致召回数量减少。默认值通常为 0.5。

您可以根据后续的测试结果调整这些参数。

### 步骤 4：保存并测试连接

1. 填写完所有必要信息后，点击“**连接**”按钮。
2. 如果配置正确，系统会显示连接成功的消息。
3. 强烈建议使用“**测试召回**”功能。输入一个测试问题或关键词，检查 XpertAI 是否能从您的外部知识库中正确检索到相关的文本片段。

## 在智能体中应用外部知识库

连接成功后，您可以在创建或编辑智能体时使用这个外部知识库。

## 故障排除

| 问题现象    | 可能原因             | 解决方案                                   |
| :------ | :--------------- | :------------------------------------- |
| 测试召回无结果 | API 端点或知识库 ID 错误 | 检查端点 URL 和知识库 ID 是否填写正确。               |
| 认证失败    | API Key 无效或过期    | 检查并更新 API Key。                         |
| 检索结果不相关 | 检索参数设置不当         | 调整 Top K 和 Score 阈值；检查知识库本身的文档质量和索引设置。 |
| 连接超时    | 网络不通或防火墙限制       | 检查网络连通性，确保 XpertAI 服务可以访问您知识库的 API 地址。 |

## 结语

通过连接外部知识库，XpertAI 智能体平台能够更深度地融入您企业的知识生态系统，充分发挥现有知识资产的价值，构建更加智能、专业的AI应用。如果您在配置过程中遇到任何问题，请随时联系我们的技术支持团队。