内部智能体搭建 · 文档索引

这是 Cursor 文档的总入口。目标不是「只装一个 Dify」，而是搭一套企业内部智能体：知识库问答、制度助手、编程助手（Shell/代码执行）这一类。

主线按三步走：先部署 Dify → 再接 Langfuse → 再开 Rerank。后面的专题只在出问题时按症状查阅。

各专题、手册的技术正文没有改，都是 207 上实战写下来的。这次只重新归类阅读顺序。文件名里仍有 Dify_、Langfuse_，方便对上原来的文章。

打开成品请用：

docs/html_cursor/内部智能体搭建_文档索引首页/内部智能体搭建_文档索引首页_cursor.html

运行环境：业务脚本均在 207 固定目录 /opt/workbuddy 执行，Python 为 /usr/bin/python3。 Windows 开发机仅保留 _probe_* 调试脚本；同步命令：python scripts_cursor/完整代码约定/00_部署_workbuddy到207.py。

目录

1. 这套文档解决什么
2. 一文一夹（学习路径）
3. 配置专题汇总（总纲）
4. 推荐阅读：主线三步
5. 第一步 部署 Dify
6. 第二步 接上 Langfuse
7. 第三步 开启 Rerank
8. 排障专题（按症状）
9. 运维培训：排错 SOP
10. 平台服务汇总（入口 · 凭据 · 架构）
11. 集成环境部署
12. 实战作业：让 Agent 动起来
13. 个人成长：AI Infra 架构师路线
14. 完整文件清单
15. 目录约定

一文一夹（学习路径）

统一要求：专题、作业、手册、教程、索引、基础设施——同一套规则（文件名 _cursor；md/html 分离）。

• 权威原文：docs/md_cursor/<文档名>_cursor.md（根目录保留，不 move）
• 一文一夹（新增拷贝）：docs/md_cursor/<文档名>/<文档名>_cursor.md（方便按篇浏览）
• 历史汇总夹（专题/、作业/、00_～08_* 等）若存在则保留；整理脚本只 copy，不进 backup

整理 / 生成：

python scripts_cursor/文档整理/organize_one_doc_one_folder.py
python gen_all_html.py
python gen_index_html.py

基础设施专题：

基础设施 · K8s GPU / Operator / Harbor·GitLab·Argo CD（理论） 基础设施 · Argo CD 原理与部署教程（GitOps 入门恶补） 基础设施 · K8s GPU 单私有化集群完整案例（端到端跟读：集群 → GitOps → LiteLLM 切流）

这套文档解决什么

在本环境（192.168.110.207 + GPU 机上的 Qwen）上，把内部智能体从能问、能查制度、能看调用链路、能把检索排准，一路跑通。

旧入口 Dify_文档索引首页_cursor.html 只保留跳转，避免收藏夹失效。

配置专题汇总（总纲）

需要理论流程、CPU/GPU 双路径、完整代码、实战问题总表时，优先打开汇总文档（不必从专题一读到十五）：

推荐阅读：主线三步

按这个顺序做，不要一上来从专题三看到专题十五。

口诀（创建和改配置时）：

工作室里没有的开关，去工作区「设置 → 模型供应商」，或直接用 dify_api.py。改 Agent 快照后仍然不要点发布。

第一步 部署 Dify

把平台跑起来，让知识库智能体（以及需要时的编程助手）能问能答。这一步结束时：不必已经有 Langfuse 或 Rerank。

1. 主线手册（必读）

从 git clone 到 vLLM、bge-m3、知识库、Agent 可用。

手册里已经串了 Embedding、建库、创建 Agent。某一步失败，再用下面的专题补洞，不要改手册里的实战步骤。

2. 创建新 Agent（必读）

手册步骤 16 比较短。完整创建流程、哪些必须走 API/改库、不要点发布：

3. 第一步里会用到的接入专题

手册某段卡住时，打开对应专题（技术内容保持原样）：

第一步验收：新开对话能基于知识库回答；编程助手则再验证一条 Shell 指令。

第二步 接上 Langfuse

Dify 能问答之后，再接观测。新 Agent 工作室没有「监测」菜单，连接走控制台 API。

第二步验收：问一句知识库问题，能在 http://192.168.110.207:3000 打开对应 Trace。召回名次仍以命中测试为准（连接专题里写过）。

第三步 开启 Rerank

观测通了以后，再给检索加精排。必须同时改知识库检索设置和新 Agent 快照，改完不要发布。

第三步验收：以前答得含糊的题，命中测试第 1 条变成直接能答题的条款；新开对话能引用关键数字。

开完 Rerank 后若变慢、卡住，不要改专题十三正文，去看专题十四。

排障专题（按症状）

主线三步做完仍出问题，再按症状打开。不按专题号从头读。

创建与模型

问答报错

编程助手

专题十四后半还有按公司人数和 GPU/CPU/内存的参数建议，扩容时看那一篇即可。

运维培训：排错 SOP

主线三步做完、业务开始日常使用后，运维最常接三类话：搜不到、答非所问、很慢。

平台服务汇总（入口 · 凭据 · 架构）

一页查全：各服务登录地址、账号密码、无登录 API 用法、架构图与端口速查。

集成环境部署

主线三步把 Dify / Langfuse / Rerank 跑通之后，207 上还要一套 Prometheus + Grafana + SLA Exporter，给领导看可用性与延迟。端口必须错开已有服务。

实战作业：让 Agent 动起来

主线链路通了之后，用作业把「工具调用」跑通。

个人成长：AI Infra 架构师路线

从「协调者 / 验收者」到 算力平台总架构师 的学习规划；并补齐基础设施理论（K8s GPU / GitOps）。

与平台文档关系：作业 5～8、17 是已做的实战；本路线与基础设施专题是下一步要补的穿透力。

完整文件清单

文件名和路径都不改，只是阅读入口换成上面三步。

docs/workbuddy/ 里是非 Cursor 原文（专题一到十、两本手册），不要改，也不要往那里写新文章。

目录约定

• 编辑：优先改根目录原文 → organize_one_doc_one_folder.py（只 copy）→ gen_all_html.py。
• 跑代码：/usr/bin/python3 /opt/workbuddy/scripts_cursor/<文档名>/xxx.py
• 不要写到 docs/ 根目录，也不要用 _cusor。整理禁止 move 进 backup。