Coze 企业知识库搭建｜附源码

在企业数字化转型过程中，知识管理一直是一个绕不开的话题。无论是客服问答、内部制度查询、产品资料检索，还是销售话术、研发文档、运维手册，企业每天都会产生大量知识内容。如果这些知识分散在飞书文档、Word、PDF、网页、数据库或聊天记录中，员工往往需要花费大量时间搜索、确认和整理。

随着大语言模型和智能体平台的发展，基于知识库的 AI 问答系统逐渐成为企业提升效率的重要工具。Coze 作为一款智能体开发平台，提供了 Bot 编排、插件调用、工作流、知识库等能力，非常适合用于搭建企业级知识问答助手。

本文将围绕 Coze 企业知识库搭建 展开，介绍整体架构、搭建流程、知识库设计方法，并附上一个可参考的源码示例，帮助你快速实现一个面向企业内部使用的 AI 知识库助手。

一、为什么企业需要知识库 AI 助手？

传统企业知识管理通常存在以下问题：

1. 知识分散

   • 文档可能分布在网盘、Wiki、飞书、语雀、Notion、Git 仓库、官网、PDF 文件中。
   • 员工想找一个答案，需要在多个系统之间来回切换。

2. 搜索效率低

   • 传统关键词搜索依赖标题和关键词匹配。
   • 如果用户不知道准确关键词，很难找到目标内容。

3. 知识更新不及时

   • 制度变更、产品升级、流程调整后，旧文档容易继续被引用。
   • 人工维护成本高。

4. 新人培训成本高

   • 新员工经常重复询问基础问题。
   • 老员工需要反复解答，影响工作效率。

5. 客服和销售响应不统一

   • 不同人员对同一问题的回答可能不一致。
   • 企业难以保证服务口径统一。

而基于 Coze 搭建企业知识库 AI 助手后，可以实现：

• 用户用自然语言提问；
• AI 自动从企业知识库中检索相关资料；
• 根据资料生成准确回答；
• 支持引用来源，方便用户追溯；
• 可结合工作流、插件、API，实现更复杂的业务动作。

例如：

员工问：“请问员工试用期转正流程是什么？”
AI 可以自动检索《员工手册》或《人事制度文档》，整理出转正条件、审批流程、所需材料和注意事项。

二、Coze 企业知识库整体架构

一个完整的企业知识库系统，通常可以分为以下几层：

用户入口层
  ├── Coze Bot 对话窗口
  ├── 企业微信 / 飞书 / 微信公众号
  ├── Web 页面
  └── 内部系统入口

智能体编排层
  ├── Coze Bot
  ├── Prompt 角色设定
  ├── 工作流 Workflow
  ├── 插件调用
  └── 多轮对话管理

知识检索层
  ├── Coze 知识库
  ├── 文档切片
  ├── 向量检索
  ├── 关键词检索
  └── 召回排序

企业数据层
  ├── PDF / Word / Excel
  ├── Markdown / HTML
  ├── 飞书文档
  ├── 语雀 / Notion
  ├── Git 仓库文档
  └── 业务数据库

系统服务层
  ├── 文档同步服务
  ├── 权限控制服务
  ├── 日志审计服务
  ├── API 接口服务
  └── 数据更新任务

在实际项目中，Coze 可以作为智能体平台，用来完成 Bot 编排、知识库检索和回答生成；而企业自己的服务可以负责文档采集、清洗、同步、权限校验和业务接口调用。

三、企业知识库搭建前的准备工作

在正式使用 Coze 搭建知识库之前，建议先完成以下准备。

1. 梳理知识类型

企业知识通常可以分为以下几类：

不同类型知识的更新频率、权限要求和回答风格都不一样，建议分库管理。

2. 统一文档格式

虽然 Coze 支持上传多种文档，但企业知识库建设不能只依赖“直接上传”。为了获得更好的检索效果，建议对文档进行标准化处理。

推荐格式：

# 文档标题

## 适用范围

说明该文档适用于哪些部门、角色或业务场景。

## 正文内容

清晰描述制度、流程、步骤或说明。

## 常见问题

### 问题一

答案内容。

### 问题二

答案内容。

## 更新时间

2025-01-01

这样的格式有几个好处：

• 标题层级清晰；
• 便于文档切片；
• 便于 AI 理解上下文；
• 便于后续自动同步和版本管理。

3. 设计知识库分类

建议不要把所有文档都放到一个知识库里。可以按照业务模块拆分，例如：

企业知识库
  ├── HR 人事知识库
  ├── 行政制度知识库
  ├── 产品资料知识库
  ├── 客服 FAQ 知识库
  ├── 技术文档知识库
  └── 销售资料知识库

这样做的好处是：

• 检索更精准；
• 权限更容易控制；
• 不同 Bot 可以绑定不同知识库；
• 后续更新维护更方便。

四、在 Coze 中创建企业知识库

下面以搭建一个企业内部知识问答助手为例，说明基本流程。

1. 创建 Bot

进入 Coze 控制台后，新建一个 Bot，例如命名为：

企业知识库助手

Bot 描述可以写：

这是一个面向企业内部员工的智能知识库助手，可以回答员工关于公司制度、产品资料、流程规范和常见问题的咨询。

2. 设置 Bot 角色 Prompt

Prompt 是影响回答质量的关键因素之一。企业知识库助手的 Prompt 应该强调几个原则：

• 必须基于知识库回答；
• 不确定时不要编造；
• 回答要结构化；
• 涉及制度、金额、权限等敏感内容时，应提示用户以官方文档为准；
• 必要时给出引用来源。

示例 Prompt：

你是企业内部知识库助手，负责帮助员工查询公司制度、业务流程、产品资料和常见问题。

回答要求：
1. 优先根据已绑定的知识库内容回答问题。
2. 如果知识库中没有相关内容，请明确说明“当前知识库中未找到相关信息”，不要编造。
3. 回答要简洁、准确、结构化，可以使用列表、步骤或表格。
4. 如果问题涉及制度、薪酬、合同、法律、财务审批等敏感事项，请提醒用户以公司最新正式文件或相关部门解释为准。
5. 如果检索到多个相关内容，请综合整理，并指出可能存在的适用范围差异。
6. 对于流程类问题，请尽量按“适用对象、办理条件、操作步骤、注意事项”的格式回答。
7. 对于产品类问题，请尽量按“功能说明、使用方法、限制条件、常见问题”的格式回答。

3. 创建知识库

在 Coze 中进入知识库管理页面，创建知识库，例如：

HR 人事制度知识库

然后上传准备好的文档，例如：

• 《员工手册.md》
• 《请假制度.md》
• 《报销制度.md》
• 《转正流程.md》
• 《绩效考核说明.md》

上传后，Coze 会对文档进行解析、切片和索引。为了提高效果，建议文档标题、章节标题尽量清晰，避免大段无结构文本。

4. 绑定知识库到 Bot

在 Bot 编排页面中，将创建好的知识库绑定到 Bot。然后在调试窗口进行测试。

测试问题示例：

试用期员工如何申请转正？

病假需要提供什么材料？

差旅报销的标准是什么？

如果回答不准确，需要检查：

• 文档内容是否完整；
• 标题是否清楚；
• 是否存在多个冲突版本；
• Prompt 是否限制了回答方式；
• 知识库召回结果是否合理。

五、企业知识库内容优化方法

知识库问答的效果，除了依赖模型能力，还高度依赖文档质量。下面是一些实用优化建议。

1. 使用问答式内容补充 FAQ

很多制度文档虽然完整，但不一定适合被用户直接提问。例如制度中写：

员工连续请假超过三天，应提供二级以上医院开具的诊断证明。

用户可能会问：

请病假超过三天要什么材料？

为了提高召回率，可以在文档后补充 FAQ：

## 常见问题

### 请病假超过三天需要提供什么材料？

员工连续请病假超过三天，应提供二级以上医院开具的诊断证明或公司认可的相关医疗证明。

### 病假证明可以后补吗？

如因特殊情况无法提前提交，应先向直属上级和 HR 说明情况，并在返岗后按要求补交证明材料。

2. 避免一个文档覆盖太多主题

如果一个文档同时包含人事、财务、行政、IT 等内容，可能导致检索混乱。建议按主题拆分。

例如不要上传一个巨大的《公司制度汇总.pdf》，而是拆成：

员工考勤制度
请假管理制度
差旅报销制度
办公用品申请流程
信息安全规范

3. 标注适用范围和更新时间

企业制度经常存在地区、部门、岗位差异。建议每个文档都包含：

## 适用范围

适用于中国区正式员工，不适用于外包人员和实习生。

## 更新时间

2025-01-01

这样 AI 在回答时可以提示适用条件，减少误导。

4. 清理无效内容

上传文档前应去除：

• 页眉页脚；
• 无意义目录；
• 重复内容；
• 过期制度；
• 扫描 PDF 中识别错误的乱码；
• 与主题无关的广告或说明。

5. 建立版本管理机制

建议企业文档统一放在 Git、飞书文档或内部 CMS 中，然后通过脚本定时同步到 Coze 或同步到自建服务。这样可以避免人工上传带来的版本混乱。

六、附源码：企业知识库文档同步与问答接口示例

下面提供一个简单的源码示例，使用 Node.js 实现：

1. 从本地 docs 目录读取 Markdown 文档；
2. 将文档内容整理为可上传格式；
3. 提供一个简单的问答 API；
4. 后端调用 Coze Bot API 获取回答。

说明：不同版本的 Coze API 参数可能有所差异，实际使用时请以官方文档为准。下面代码主要用于展示工程结构和实现思路。

七、项目目录结构

coze-enterprise-kb/
  ├── docs/
  │   ├── hr/
  │   │   ├── leave-policy.md
  │   │   └── probation.md
  │   └── product/
  │       └── product-faq.md
  ├── src/
  │   ├── config.js
  │   ├── documentLoader.js
  │   ├── cozeClient.js
  │   ├── server.js
  │   └── utils.js
  ├── package.json
  ├── .env
  └── README.md

八、package.json

{
  "name": "coze-enterprise-kb",
  "version": "1.0.0",
  "description": "Enterprise knowledge base assistant powered by Coze",
  "main": "src/server.js",
  "scripts": {
    "dev": "node src/server.js",
    "load-docs": "node src/documentLoader.js"
  },
  "dependencies": {
    "axios": "^1.7.0",
    "cors": "^2.8.5",
    "dotenv": "^16.4.5",
    "express": "^4.18.3",
    "fs-extra": "^11.2.0",
    "glob": "^10.3.10"
  }
}

安装依赖：

npm install

九、环境变量配置

创建 .env 文件：

COZE_API_BASE=https://api.coze.com
COZE_API_TOKEN=your_coze_api_token
COZE_BOT_ID=your_bot_id
COZE_USER_ID=enterprise_user_001

PORT=3000

字段说明：

十、配置文件 config.js

// src/config.js
require("dotenv").config();

const config = {
  cozeApiBase: process.env.COZE_API_BASE || "https://api.coze.com",
  cozeApiToken: process.env.COZE_API_TOKEN,
  cozeBotId: process.env.COZE_BOT_ID,
  cozeUserId: process.env.COZE_USER_ID || "default_user",
  port: Number(process.env.PORT || 3000)
};

function validateConfig() {
  const required = ["cozeApiToken", "cozeBotId"];
  const missing = required.filter((key) => !config[key]);

  if (missing.length > 0) {
    throw new Error(`Missing required config: ${missing.join(", ")}`);
  }
}

module.exports = {
  config,
  validateConfig
};

十一、工具函数 utils.js

// src/utils.js
function normalizeText(text) {
  if (!text) return "";

  return text
    .replace(/\r\n/g, "\n")
    .replace(/\n{3,}/g, "\n\n")
    .replace(/[ \t]+/g, " ")
    .trim();
}

function buildDocumentMetadata(filePath) {
  const parts = filePath.split(/[\\/]/);
  const category = parts.length >= 2 ? parts[parts.length - 2] : "default";

  return {
    category,
    source: filePath,
    updatedAt: new Date().toISOString()
  };
}

module.exports = {
  normalizeText,
  buildDocumentMetadata
};

十二、本地文档加载脚本 documentLoader.js

这个脚本用于读取本地 docs 目录下的 Markdown 文件，并整理成结构化数据。实际项目中，你可以将这里的数据进一步上传到 Coze 知识库，或同步到自建向量数据库。

// src/documentLoader.js
const path = require("path");
const fs = require("fs-extra");
const { glob } = require("glob");
const { normalizeText, buildDocumentMetadata } = require("./utils");

async function loadMarkdownDocuments() {
  const docsDir = path.resolve(__dirname, "../docs");
  const files = await glob("**/*.md", {
    cwd: docsDir,
    absolute: true
  });

  const documents = [];

  for (const file of files) {
    const raw = await fs.readFile(file, "utf-8");
    const content = normalizeText(raw);

    if (!content) continue;

    const relativePath = path.relative(docsDir, file);

    documents.push({
      title: path.basename(file, ".md"),
      content,
      metadata: buildDocumentMetadata(relativePath)
    });
  }

  return documents;
}

async function main() {
  const documents = await loadMarkdownDocuments();

  console.log(`Loaded ${documents.length} documents`);

  for (const doc of documents) {
    console.log("====================================");
    console.log("Title:", doc.title);
    console.log("Category:", doc.metadata.category);
    console.log("Source:", doc.metadata.source);
    console.log("Preview:", doc.content.slice(0, 200));
  }
}

if (require.main === module) {
  main().catch((err) => {
    console.error(err);
    process.exit(1);
  });
}

module.exports = {
  loadMarkdownDocuments
};

运行：

npm run load-docs

十三、Coze API 客户端 cozeClient.js

下面示例封装了一个调用 Coze Bot 对话接口的方法。接口路径和字段请根据你使用的 Coze 官方 API 文档调整。

// src/cozeClient.js
const axios = require("axios");
const { config } = require("./config");

const cozeRequest = axios.create({
  baseURL: config.cozeApiBase,
  timeout: 30000,
  headers: {
    Authorization: `Bearer ${config.cozeApiToken}`,
    "Content-Type": "application/json"
  }
});

async function chatWithCoze({ message, userId, conversationId }) {
  const payload = {
    bot_id: config.cozeBotId,
    user_id: userId || config.cozeUserId,
    query: message,
    conversation_id: conversationId,
    stream: false
  };

  const response = await cozeRequest.post("/v1/chat", payload);

  return parseCozeResponse(response.data);
}

function parseCozeResponse(data) {
  /**
   * 注意：
   * Coze 不同接口版本返回结构可能不同。
   * 这里做一个兼容式解析，你可以根据实际返回字段修改。
   */

  if (!data) {
    return {
      answer: "",
      raw: data
    };
  }

  if (data.messages && Array.isArray(data.messages)) {
    const answerMessage = data.messages.find(
      (item) => item.type === "answer" || item.role === "assistant"
    );

    return {
      answer: answerMessage ? answerMessage.content : "",
      raw: data
    };
  }

  if (data.answer) {
    return {
      answer: data.answer,
      raw: data
    };
  }

  if (data.data && data.data.answer) {
    return {
      answer: data.data.answer,
      raw: data
    };
  }

  return {
    answer: JSON.stringify(data),
    raw: data
  };
}

module.exports = {
  chatWithCoze
};

十四、Express 问答服务 server.js

// src/server.js
const express = require("express");
const cors = require("cors");
const { config, validateConfig } = require("./config");
const { chatWithCoze } = require("./cozeClient");

validateConfig();

const app = express();

app.use(cors());
app.use(express.json({ limit: "2mb" }));

app.get("/health", (req, res) => {
  res.json({
    status: "ok",
    service: "coze-enterprise-kb",
    time: new Date().toISOString()
  });
});

app.post("/api/chat", async (req, res) => {
  try {
    const { message, userId, conversationId } = req.body;

    if (!message || typeof message !== "string") {
      return res.status(400).json({
        success: false,
        message: "message is required"
      });
    }

    const result = await chatWithCoze({
      message,
      userId,
      conversationId
    });

    res.json({
      success: true,
      data: {
        answer: result.answer,
        raw: result.raw
      }
    });
  } catch (error) {
    console.error("Chat error:", error.response?.data || error.message);

    res.status(500).json({
      success: false,
      message: "Failed to chat with Coze",
      error: error.response?.data || error.message
    });
  }
});

app.listen(config.port, () => {
  console.log(`Server is running at http://localhost:${config.port}`);
});

启动服务：

npm run dev

测试接口：

curl -X POST http://localhost:3000/api/chat \
  -H "Content-Type: application/json" \
  -d '{
    "message": "试用期员工如何申请转正？",
    "userId": "employee_10001"
  }'

返回示例：

{
  "success": true,
  "data": {
    "answer": "试用期员工申请转正通常需要满足试用期考核要求，并由员工提交转正申请，经直属上级、部门负责人和 HR 审批后完成转正流程。具体流程以公司最新人事制度为准。",
    "raw": {}
  }
}

十五、示例知识文档

下面给出两份示例 Markdown 文档，可以放入 docs/hr/ 目录中。

1. leave-policy.md

# 请假管理制度

## 适用范围

本制度适用于公司中国区正式员工。实习生、外包人员及兼职人员请假规则以对应合同或管理要求为准。

## 请假类型

公司常见请假类型包括：

1. 年假
2. 病假
3. 事假
4. 婚假
5. 产假
6. 陪产假
7. 丧假

## 年假规则

员工连续工作满一年后，可按国家规定及公司制度享受带薪年假。年假申请应至少提前三个工作日提交，并经直属上级审批。

## 病假规则

员工因病无法正常出勤时，应及时向直属上级说明情况，并在系统中提交病假申请。

连续病假超过三天的，应提供二级以上医院或公司认可医疗机构出具的诊断证明。

## 事假规则

员工因个人事务需要请假的，应提前提交事假申请。事假期间不计发对应出勤工资，具体以薪酬制度为准。

## 常见问题

### 请病假超过三天需要什么材料？

连续病假超过三天的，应提供二级以上医院或公司认可医疗机构出具的诊断证明。

### 年假可以临时申请吗？

原则上年假应至少提前三个工作日申请。如遇特殊情况，应提前与直属上级沟通并获得审批。

### 事假是否扣工资？

事假期间不计发对应出勤工资，具体扣款方式以公司薪酬制度为准。

## 更新时间

2025-01-01

2. probation.md

# 试用期转正流程

## 适用范围

本流程适用于公司正式员工试用期转正管理，不适用于实习生、外包人员和兼职人员。

## 转正条件

员工申请转正通常需要满足以下条件：

1. 已完成约定试用期；
2. 试用期内无重大违纪行为；
3. 绩效表现达到岗位要求；
4. 已完成必要的新员工培训；
5. 直属上级确认员工符合岗位胜任要求。

## 操作流程

1. HR 在试用期结束前发起转正提醒；
2. 员工填写转正申请表；
3. 直属上级进行试用期评价；
4. 部门负责人审批；
5. HR 复核员工材料和审批记录；
6. 审批通过后，员工转为正式员工。

## 注意事项

如果员工试用期表现未达到要求，公司可根据劳动合同、公司制度及相关法律法规进行试用期延长、岗位调整或终止试用处理。

## 常见问题

### 试用期员工需要自己提交转正申请吗？

一般情况下，员工需要按照 HR 通知填写转正申请表，并配合直属上级完成试用期评价。

### 转正审批需要多久？

转正审批时间取决于直属上级、部门负责人和 HR 的审批进度。通常建议在试用期结束前完成。

### 试用期表现不达标怎么办？

如试用期表现未达到岗位要求，公司可根据劳动合同、公司制度及相关法律法规进行处理。具体处理方式以 HR 通知为准。

## 更新时间

2025-01-01

十六、前端调用示例

如果你希望在企业内部系统中嵌入一个简单的问答页面，可以使用下面的 HTML 示例。

  
  
  


  
企业知识库助手

  


  
  发送

  

十七、企业级落地需要注意的几个问题

1. 权限控制

企业知识库不是所有内容都应该对所有人开放。例如：

• 薪酬制度只允许 HR 和管理层访问；
• 研发文档只允许研发部门访问；
• 客户合同信息只允许销售和法务访问。

如果使用 Coze 作为统一问答入口，建议在外层系统中增加权限校验，根据用户身份决定调用哪个 Bot 或绑定哪个知识库。

常见做法：

用户登录企业系统
  ↓
获取用户部门、角色、权限
  ↓
根据权限选择可访问知识库
  ↓
调用对应 Coze Bot
  ↓
返回答案

2. 数据安全

企业知识库可能涉及内部制度、商业计划、客户资料和产品策略。上线前应确认：

• 文档是否可以上传到外部平台；
• 是否包含敏感个人信息；
• API Token 是否安全存储；
• 是否需要内网部署或私有化方案；
• 日志是否会记录敏感问题和答案。

3. 回答可追溯

对于制度类和流程类问题，最好让 AI 给出来源文档或引用片段。这样可以降低误答风险。

回答示例：

根据《试用期转正流程》文档，员工转正通常包括以下步骤：
1. HR 发起转正提醒；
2. 员工填写转正申请表；
3. 直属上级评价；
4. 部门负责人审批；
5. HR 复核；
6. 审批通过后转正。

提醒：具体流程以 HR 最新通知为准。

4. 定期评估回答质量

建议收集用户问题和 AI 回答，定期进行评估：

5. 设置兜底机制

当知识库没有答案时，不应让 AI 随意发挥。可以设置兜底回复：

当前知识库中未找到相关信息。建议你联系对应负责部门确认：
- 人事制度问题：联系 HR；
- 报销问题：联系财务；
- 系统权限问题：联系 IT 服务台。

十八、常见问题

1. Coze 知识库适合做企业内部问答吗？

适合。Coze 提供知识库绑定、Bot 编排、工作流和插件能力，可以快速构建企业内部知识问答助手。不过，如果企业对数据安全、权限隔离、私有化部署有严格要求，需要结合企业自身合规要求进行评估。

2. 文档上传越多越好吗？

不是。知识库效果更依赖文档质量，而不是数量。大量重复、过期、混乱的文档会降低回答准确率。建议先从高频问题和标准文档开始建设。

3. 如何提升回答准确率？

可以从以下方面优化：

• 拆分知识库；
• 清理文档结构；
• 补充 FAQ；
• 优化 Bot Prompt；
• 使用明确标题；
• 删除过期版本；
• 定期分析错误回答。

4. 是否需要自建向量数据库？

如果只是中小规模企业知识问答，直接使用 Coze 知识库即可。如果有复杂权限、海量文档、自定义检索策略、多数据源同步等需求，可以考虑自建向量数据库，再通过插件或 API 与 Coze 结合。

5. 能否接入企业微信或飞书？

可以。常见方案是：

• 使用 Coze 平台支持的发布渠道；
• 或者企业自建中间服务；
• 接收企业微信/飞书消息；
• 调用 Coze API；
• 将回答返回给用户。

十九、最佳实践总结

搭建 Coze 企业知识库时，建议遵循以下原则：

1. 先业务，后技术

   • 不要一开始就追求复杂架构，先明确企业最需要解决哪些问题。

2. 先高频，后全面

   • 优先整理员工最常问、客服最常答、销售最常查的问题。

3. 先标准化，后自动化

   • 文档格式不规范时，自动同步只会放大混乱。

4. 知识库分层分库

   • 按部门、业务、权限拆分知识库，提升检索质量。

5. Prompt 明确边界

   • 要求 AI 基于知识库回答，不知道就说明不知道。

6. 建立反馈机制

   • 让用户可以反馈“回答有误”或“没有帮助”，再定期优化。

7. 关注安全合规

   • 企业知识库必须重视权限、日志、隐私和数据合规。

二十、结语

Coze 为企业搭建知识库 AI 助手提供了非常便捷的能力。通过 Bot、知识库、工作流和 API，企业可以快速实现一个可用的智能问答系统，让员工不再反复翻文档，让客服和销售能够快速获取标准答案，让企业知识真正流动起来。

不过，知识库系统的核心并不是“接入一个大模型”，而是持续建设高质量知识内容。只有文档结构清晰、内容准确、权限合理、更新及时，AI 才能真正发挥价值。

如果你正在为企业搭建内部知识库，可以先从一个小范围场景开始，例如 HR 问答、客服 FAQ 或产品资料查询。通过 Coze 快速验证效果，再逐步扩展到更多业务模块。最终，你可以形成一个覆盖制度、流程、产品、技术和客户服务的企业级 AI 知识管理体系。