Agent开发系列(十一)-知识库建设(知识地图)
一、什么是知识地图核心判断知识地图的难点不是建,是维护——人变动频繁,信息 1 个月内就可能过期。 治理的命脉是从 HR/CODEOWNERS 自动同步,不是让人手动更新。它是什么它不是什么团队成员 × 负责领域/技能的映射花名册(那在 HR 系统)跨团队找谁的对齐层组织架构图(那是上下级)当前能力 当前职责的快照简历集合(那是历史)强时效性 隐私敏感1:1 关系图(那是 RACI)为什么知识库需要建设知识地图知识地图对 Agent 来说,本质上是通讯录 路由表 团队感知——没有它,Agent 能做事但不知道做给谁、卡住找谁、避免撞到谁。整个知识库是 Agent 的工作记忆,知识地图是 Agent 的协作接口——前者解决怎么做事,后者解决跟谁协作。二、知识地图的知识模板如何定义2.1 模板 1:服务 × 人(services-to-people.md)字段类型必填来源可见性服务string(link → 服务清单)✓自动全员主 Owneruser✓CODEOWNERS全员副 Owner(≥1)user✓人工全员Backup(临时)user×人工全员联系渠道enum(IM/邮件)✓自动全员紧急联系电话string×人工仅主管 oncall最近响应 SLAduration×人工全员离职风险enum(低/中/高)×主管评估仅主管最后更新datetime✓自动全员2.2 模板 2:角色 × 联系方式(roles-contacts.md)字段类型必填备注角色enum✓如DBA oncall/安全 oncall主联系人user✓副联系人user✓联系电话string✓分级可见IM 群link✓升级路径list[user]✓搞不定找谁值班轮换表link✓链接到排班系统应急手册link✓链接到 Runbook2.3 模板 3:业务域 × 人(domains-to-people.md)字段类型必填来源业务域enum✓业务域划分业务负责人(BP)user✓组织架构技术负责人(TL)user✓人工PM Owneruser✓PMO关键 Stakeholderslist[user]×人工2.4 模板 4:项目 × 人(projects-to-people.md)字段类型必填备注项目名string✓链接到项目文档状态enum✓规划/进行中/暂停/已完结Sponsoruser✓项目 sponsorProject Manageruser✓Tech Leaduser✓核心成员list[user]✓≥3 人启动时间date✓计划结束date×已完结填实际结束2.5 模板 5:人 × 技能(skills-to-people.md)字段类型必填来源技能enum✓技能分类(见下)熟练度enum×自评(初/中/高/专家)持有项目list[link]×自动持有 ADRlist[link]×自动(从 ADR author 推)是否可做培训bool×自评备注string(≤100字)×自评2.6 关键设计点(为什么这么设计)设计点原因电话分级可见防止全员公开,合规要求离职风险仅主管可见敏感信息,避免员工心理负担服务 × 人的服务是 link避免重复维护,跟服务清单保持一致技能熟练度是 enum,不是数字Agent 可消费,可机器聚合个人档案只放当前维护成本可控,避免变简历库2.7 反模式反模式后果个人档案含完整履历/项目经历维护不动,变简历库联系方式全员公开隐私问题,合规风险技能用百分比或分数不可机器解析一个人一份全面档案单点维护,过期没人负责离职立刻删除档案历史查不到X 之前负责什么三、知识地图的更新机制如何设计核心判断HR 系统是个人信息的单一真相源,CODEOWNERS 是 Owner 的单一真相源,wiki 只做视图渲染。 任何在 wiki 里改个人信息都是污染。存在5个触发器触发器触发条件动作责任方HR系统同步入职/转岗/离职同步个人信息、自动增删/归档HR 系统CODEOWNERS 变化PR 改 CODEOWNERSLLM 检查,提议更新服务 Owner自动服务清单变化新服务/服务下线LLM 检查,提议补/移 Owner自动季度 review每季度全员确认自己负责的服务/项目人工事件触发找不到负责人事件补 Owner 反思 schema人工四、知识地图的质量标准如何定义核心判断知识地图的质量 找人的速度和准确性,不是信息多不多。 一个 100% 完整但 1 个月前的快照,不如一个 80% 完整但 1 周前的快照。5 个核心指标指标定义健康值测量方式覆盖率已部署服务都有主副 Owner100%自动新鲜度Owner 信息最后审阅时间中位数≤ 90 天自动触达 SLA紧急联系人 1 跳可达比例100%值班演练冗余度关键(P0)服务有 ≥2 个 Owner≥ 90%自动反向事件率找不到负责人事件频率月度环比下降事件统计4.1 3 个反向指标(出现就告警)反向指标告警触发修复动作孤儿服务服务有部署但无 Owner立即告警,要求补 Owner幽灵 OwnerOwner 已离职但服务仍挂在名下立即告警,要求重新分配失效渠道紧急联系渠道(IM/电话)不可用告警,要求更新4.2 准入 / 持续 / 淘汰门槛门槛触发动作新服务准入服务注册新增服务必须填主副 Owner,否则不准合并Owner 变更持续转岗/离职24h 内自动同步,失效 Owner 7 天未补齐告警服务下线淘汰服务注册移除服务30 天后 Owner 信息归档到90-archive/离职归档员工离职档案移到90-archive/people/,保留X 之前负责什么