通过 OpenAPI 接入外部知识

通过标准接口接入外部系统知识。

概述

对于四类默认来源之外的数据源，可使用当前已开放的数据源能力或 OpenAPI 接入。
接入内容按统一知识模型管理和调用。

开始之前

[!IMPORTANT]

• 接入权限：具备知识入库管理权限，并可按当前 OpenAPI 文档完成应用鉴权。
• 版本要求：使用知识库 2.0 当前界面。
• 知识标识：明确外部知识对象和唯一标识。
• 知识属性：准备标题、正文、附件、分类、权限、更新时间和有效期。

接入流程

1. 明确外部系统中的知识对象、唯一标识、标题、正文、附件、分类、权限、更新时间和有效期。
2. 根据当前 OpenAPI 文档完成应用鉴权和接口调用配置。
3. 将外部字段映射到知识条目字段，并确定目标空间和文件夹。
4. 设计新增、更新、删除、失败重试和重复数据处理规则。
5. 使用少量测试数据验证内容、权限、状态、附件和 AI 使用结果。
6. 开启正式同步，并通过日志监控失败和异常。

必须保持的边界

• 不在帮助文档中固化接口地址、凭证或密钥；具体参数以当前 OpenAPI 文档为准。
• 外部系统知识的可见范围不得超过来源系统授权范围。
• 外部唯一标识应稳定，避免同一来源反复生成重复知识。
• 导入成功不等同于正式可用，知识仍需满足发布状态、有效期和权限条件。

预期结果与验证

1. 使用当前账号重新打开对应页面。
2. 确认少量测试数据可按预期进入知识库并保留权限边界。

常见问题与故障排除

相关主题

• 知识库 2.0 概述
• 对应角色快速入门