让 Agent 快速读懂企业文档
为现有 Agent 安装 Context0 接入插件，配置知识库和文档同步后，即可直接询问公司制度、项目规范和技术文档相关问题。
架构
文档同步到 Context0 后，Agent 在回答问题时按需检索，这一步由内置 Skill 指导完成。
接入后能做什么
Agent 基于企业知识库中的制度文档回答提问。
代码块
Plain Text
您：年假申请需要提前多久？
Agent：根据《员工考勤与休假制度》，需要提前 3 个工作日在 OA 提交。
来源：企业制度知识库 / 员工考勤与休假制度。
Agent 可以依据团队自己的文档回答，也可以在写代码、排查问题时使用规范和操作指南。参数、流程、制度条款等需要精确原文的内容，适合用 RAG。希望理解跨文档的概念与架构时，可再开启 Wiki。
快速上手
步骤一：把 Context0 接入现有 Agent
步骤二：准备知识库和资料
可以在Context0 dashboard控制台创建知识库并上传文档，也可以直接让 Agent 帮您完成，
•
直接用自然语言让 Agent 帮您创建知识库并上传资料。
代码块
Plain Text
请在 Context0 新建一个"工程规范"知识库，
将当前项目 docs 目录下的开发规范和 API 设计文档上传进去。
•
已有知识库时说：
代码块
Plain Text
请把 ./docs/api-guide.md 加入 Context0 的"工程规范"知识库。
Agent 会根据内置 Skill 创建或定位知识库、上传指定资料。文档随后由后台解析和索引，完成后即可使用。若知识库开启了审核，需要先完成审核。若资料来自飞书、钉钉或需要持续更新的本地目录时，需按照文档同步配置完成首次同步。团队管理员可以统一准备知识库，再为使用者配置读取权限。
步骤三：直接向 Agent 提问
资料就绪后，开启一个已加载 Context0 插件的 Agent 会话：
代码块
Plain Text
请根据"工程规范"里的 API 设计要求，帮我加一个创建订单接口。
Agent 会检索相关文档，结合规范开展工作。您可以在回答中看到引用的文档或来源，无需自己挑选分块、执行搜索或把查询结果粘贴给模型。
说明：完成安装、知识库准备和权限配置后，日常只需正常向 Agent 提需求。
日常使用举例
以下以团队已同步相关资料为例，回答内容应以实际文档为准。
查询公司制度
Agent 从制度文档中检索条款并引用出处。
代码块
Plain Text
您：入职满三年的员工有几天年假？怎么申请？
Agent：根据《员工考勤与休假制度》，入职满三年有 7 天年假，
需要提前 3 个工作日在 OA 提交申请。
来源：《员工考勤与休假制度》第二章。
按团队规范写代码
Agent 检索 API 设计规范，按团队约定生成接口代码。
代码块
Plain Text
您：按我们的 API 规范加一个创建订单接口。
Agent：我查到了《API 设计规范》：路径使用 /api/v1/orders，
新同事快速了解项目
新同事借助知识库快速了解项目的本地开发流程。
代码块
Plain Text
新同事：这个项目怎么在本地启动？
Agent：根据《开发环境搭建指南》，先准备 Node.js 22，
再配置环境变量、安装依赖并启动开发服务。
我可以结合当前项目文件帮您逐步完成。
文档更新后继续使用
配置了定时同步后，源文档改动会在后续同步与索引完成后进入知识库，Agent 即可按需使用更新后的内容。
代码块
Plain Text
文档同步配置
少量资料可直接在Context0 dashboard控制台上传，或让 Agent 上传。需要同步目录、飞书或钉钉时，由资料维护者完成以下配置。
安装同步工具
代码块
Bash
# 全局安装文档同步工具（要求 Node.js ≥ 22）
npm install -g @polardbx/ctxdb0-sync
配置知识库与文档源
•
文件规范：在工作目录创建 .ctxdb0-sync.json。以下用本地目录举例，将 kbId 换成已创建知识库的 ID：
代码块
JSON
{"provider": "local","kbId": "1","baseUrl": "${CTXDB0_BASE_URL}","apiKey": "${CTXDB0_SYNC_KEY}","path": "./docs"}
•
参数说明
•
同步工具独立读取这份配置；即使已经连接了 Agent，也要为同步工具设置上述变量。${VAR} 会从运行环境中取值，配置文件中不要填写真实密钥。
•
示例：飞书配置文件如下：
代码块
JSON
{"provider": "feishu","kbId": "1","baseUrl": "${CTXDB0_BASE_URL}","apiKey": "${CTXDB0_SYNC_KEY}","spaceId": "${FEISHU_SPACE_ID}","appId": "${FEISHU_APP_ID}","appSecret": "${FEISHU_APP_SECRET}"}
首次同步与后续更新
•
首次同步后等待后台索引完成，就可以直接向 Agent 提问。后续每次运行都会按内容哈希跳过未变化的文档。
代码块
Bash
# 先用 dry-run 预览将要同步的文件列表，不实际写入
ctxdb0-sync run --dry-run
# 确认无误后执行正式同步
•
需要每天更新时，可让团队调度系统或 cron 定时执行，例如：crontab配置示例，每天凌晨 2 点自动执行文档同步，日志输出到指定文件。
代码块
Plain Text
0 2 * * * cd /path/to/project && /usr/local/bin/ctxdb0-sync run >> /var/log/ctxdb0-sync.log 2>&1
说明：将路径替换为实际路径，并为调度环境配置相同的环境变量。完成定时同步后，日常使用者无需关心同步命令。
权限与默认配置
表格加载中...
团队共享时，管理员需配置知识库可见性与协作者。所有检索都使用当前连接的 Key，只能读取它有权限访问的资料。知识检索默认开启，每次默认最多返回 5 条。通常不必调整。若需要限制某个项目使用知识库，可以通过连接或项目配置关闭能力。不要使用旧的 prompt-knowledge-recall 开关：当前由内置 Skill 帮助 Agent 按需检索。
（可选）主动使用 CLI
需要脚本调用、主动检索或排查时，也可以自己使用 CLI。以下操作不是日常对话的必需步骤。
代码块
Bash
# 主动检索某个知识库
ctxdb0 knowledge query '年假政策' --source '企业制度' --json
# 主动上传一篇文档
ctxdb0 knowledge import --source '工程规范' --file ./docs/adr.md --json
# 查看文档处理状态
ctxdb0 knowledge documents show
# 查看当前连接配置
ctxdb0 config show --json
检索可重复传 --source 指定多个知识库，或用 --all-accessible 检索当前 Key 可读的全部知识库。默认最多 5 条，可通过 --top-k 调整。
表格加载中...
常见问题