关于 Knowledge Graph Builder
用于从支持内容和领域信息设计、构建知识图谱的技能,指导实体与关系建模、图谱构造、查询、推理和持续验证,适用于支持与搜索场景。
主要功能
- 01设计领域实体、属性和关系模型
- 02规划图谱模式与数据填充方式
- 03探索遍历、路径和模式查询
- 04运用推理与语义搜索思路
- 05审查图谱质量和更新流程
适用场景
- 01整理支持文章及问题解决关联
- 02梳理产品、问题与解决方案之间的关系
- 03规划基于图谱的搜索或推荐体验
- 04检查图谱中的缺口、过期节点和薄弱关系
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ eddiebe147/ claude-settings --skill knowledge-graph-builder安装后在 Claude Code 中输入/knowledge-graph-builder确认已加载。
详细介绍
知识图谱构建器
专业知识图谱创建系统,可将零散的支持内容转化为由概念、关系和解决方案构成的互联网络。此技能提供结构化工作流,用于绘制知识领域、定义关系,以及打造智能支持体验。
知识图谱让支持系统能够理解上下文,而不只是关键词。当客户询问“账单问题”时,知识图谱知道这与发票、付款方式、订阅计划以及潜在的客户流失风险相关。此技能可帮助你构建这种关联智能。
此技能基于语义网原则和知识工程最佳实践,结合领域建模、关系映射和实用实施方案,构建可提供更智能支持的知识图谱。
核心工作流
工作流 1:领域建模
定义知识领域中的概念和实体
-
实体识别
- 核心实体:产品、功能、概念
- 客户实体:账户、用户、细分群体
- 支持实体:问题、解决方案、文章
- 流程实体:工作流、规程、步骤
- 上下文实体:用例、用户画像、场景
-
支持场景的实体类型
实体类型 示例 用途 产品 应用、功能、模块 客户使用的内容 问题 Bug、错误、疑问 客户遇到的问题 解决方案 修复方法、变通方案、指南 如何解决问题 文章 常见问题、操作指南、参考资料 内容资源 概念 术语、流程、能力 帮助理解 用户画像 管理员、用户、开发者 需要帮助的人 -
实体属性
Entity: Feature Properties: - id: unique identifier - name: display name - description: what it does - status: active/deprecated/beta - complexity: basic/intermediate/advanced - related_persona: who uses it - documentation_url: help article link -
实体提取来源
- 产品文档
- 支持工单分类体系
- 常见问题类别
- 帮助中心结构
- 功能规格说明
- 用户研究发现
工作流 2:关系映射
定义实体之间的连接方式
-
核心关系类型
关系 起点 终点 示例 SOLVES 解决方案 问题 “密码重置 SOLVES 登录失败” PART_OF 功能 产品 “仪表板 PART_OF 分析” REQUIRES 功能 功能 “导出 REQUIRES Pro 计划” CAUSES 问题 问题 “API 限额 CAUSES 同步失败” DOCUMENTED_IN 概念 文章 “账单 DOCUMENTED_IN 定价指南” APPLIES_TO 解决方案 用户画像 “变通方案 APPLIES_TO 管理员用户” -
关系属性
Relationship: SOLVES Properties: - confidence: how reliable (0-1) - conditions: when this applies - effectiveness: success rate - last_verified: date checked -
关系发现
- 分析支持工单的解决路径
- 绘制帮助文章之间的交叉引用
- 识别共同出现的问题
- 研究用户旅程模式
- 查阅专家知识
-
关系强度
- 强:始终成立,有充分文档记录
- 中等:通常成立,是常见模式
- 弱:有时成立,取决于上下文
- 建议:可能成立,有待验证
工作流 3:图谱构建
构建实际的知识图谱结构
-
图谱架构
Nodes (Entities): - Unique identifier - Entity type - Properties - Metadata (created, updated, source) Edges (Relationships): - From node - To node - Relationship type - Properties - Metadata -
实施方案
方案 适用场景 工具 图数据库 复杂查询、大规模场景 Neo4j、Amazon Neptune RDF 三元组存储 语义网、标准化场景 Apache Jena、Stardog 属性图 灵活建模 Neo4j、TigerGraph 嵌入式 简单用例 NetworkX、GraphQL -
架构设计
- 定义节点标签/类型
- 定义关系类型
- 设置必需属性
- 定义约束(唯一性、存在性)
- 创建索引以提升查询性能
-
数据填充
- 从现有来源批量导入
- 从实时系统通过 API 摄取
- 由专家手动整理
- 自动提取(NLP)
- 根据支持活动持续更新
工作流 4:查询与推理
从知识图谱中提取价值
-
查询模式
查询类型 使用场景 示例 遍历 查找相关内容 “与 X 相关的文章” 路径查找 发现解决方案 “从问题到解决方案的步骤” 模式匹配 相似问题 “类似 X 的问题” 聚合 分析 “每个功能最常见的问题” 推荐 建议 “其他用户也看过” -
推理规则
- 如果 A 导致 B,且 B 导致 C,则建议 A 可能与 C 相关
- 如果解决方案 S 解决了问题 I,则为相似问题推荐相似解决方案
- 如果文章 A 记录在 B 中,且 B 需要 C,则将 C 显示为前置条件
- 如果许多用户依次浏览 A → B → C,则建议使用快捷路径
-
语义搜索增强
- 使用相关概念扩展搜索范围
- 按图中心性排序
- 展示相关文章
- 建议替代术语
- 根据关系理解上下文
-
对话式 AI 集成
- 将用户意图映射到图实体
- 沿关系查找答案
- 根据关联内容生成回复
- 通过图路径解释推理过程
工作流 5:维护与演进
确保知识图谱准确并持续增长
-
质量监控
- 跟踪使用模式
- 识别死胡同路径
- 查找孤立节点
- 监控关系准确性
- 衡量搜索成功率
-
更新触发条件
- 新产品发布
- 文档变更
- 支持工单模式
- 用户反馈
- 专家整理会议
-
验证流程
- 由专家审核新关系
- 对图驱动功能进行 A/B 测试
- 监控准确性指标
- 收集用户反馈
- 定期审计
-
增长策略
- 从工单中自动提取实体
- 基于 ML 的关系建议
- 用户贡献机制
- 专家知识采集会议
- 与外部来源交叉引用
快速参考
| 操作 | 命令/触发语 |
|---|---|
| 创建实体 | “为 [name] 添加 [type] 实体” |
| 定义关系 | “创建从 [A] 到 [B] 的 [type] 关系” |
| 查询图谱 | “查找与 [entity] 相关的 [entity]” |
| 查找路径 | “显示从 [issue] 到 [solution] 的路径” |
| 图谱统计信息 | “显示知识图谱指标” |
| 验证关系 | “审计 [entity] 的关系” |
| 从工单提取 | “从近期工单中提取实体” |
| 生成文档 | “将图谱导出为文档” |
| 查找缺口 | “识别缺失的关系” |
| 可视化图谱 | “可视化 [entity] 周围的图谱” |
最佳实践
领域建模
- 从核心产品概念入手
- 从客户视角建模
- 保持实体类型精简明确
- 清晰记录实体定义
- 对架构进行版本管理
关系设计
- 使用基于动词的关系名称
- 明确关系方向
- 添加置信度/强度属性
- 避免冗余关系
- 记录关系语义
图谱构建
- 从小规模开始,逐步扩展
- 请领域专家验证
- 为频繁查询的属性创建索引
- 从一开始就规划扩展能力
- 维护数据沿袭信息
查询优化
- 分析查询性能
- 创建适当的索引
- 缓存常见遍历结果
- 对大型结果进行分页
- 监控查询模式
维护
- 安排定期审计
- 跟踪内容时效性
- 移除过时的节点/边
- 验证自动添加的内容
- 记录变更
知识图谱架构
核心实体
Product:
properties:
- id: string (required, unique)
- name: string (required)
- description: text
- version: string
- status: enum [active, deprecated, beta]
- tier: enum [free, pro, enterprise]
Feature:
properties:
- id: string (required, unique)
- name: string (required)
- description: text
- complexity: enum [basic, intermediate, advanced]
- introduced_version: string
- documentation_url: url
Issue:
properties:
- id: string (required, unique)
- title: string (required)
- description: text
- severity: enum [critical, high, medium, low]
- frequency: enum [common, occasional, rare]
- symptoms: array[string]
Solution:
properties:
- id: string (required, unique)
- title: string (required)
- steps: array[string]
- type: enum [fix, workaround, configuration]
- effectiveness: float [0-1]
- applies_to: array[string]
Article:
properties:
- id: string (required, unique)
- title: string (required)
- url: url (required)
- type: enum [faq, how-to, reference, troubleshooting]
- audience: enum [all, admin, developer]
- last_updated: date
Concept:
properties:
- id: string (required, unique)
- term: string (required)
- definition: text (required)
- aliases: array[string]
- domain: string
核心关系
PART_OF:
from: [Feature, Concept]
to: [Product, Feature, Concept]
properties:
- required: boolean
SOLVES:
from: Solution
to: Issue
properties:
- confidence: float [0-1]
- conditions: text
- verified_date: date
CAUSES:
from: Issue
to: Issue
properties:
- probability: float [0-1]
- mechanism: text
DOCUMENTED_IN:
from: [Feature, Issue, Solution, Concept]
to: Article
properties:
- section: string
- is_primary: boolean
REQUIRES:
from: [Feature, Solution]
to: [Feature, Permission, Plan]
properties:
- type: enum [prerequisite, dependency, permission]
RELATED_TO:
from: [any]
to: [any]
properties:
- strength: float [0-1]
- type: enum [similar, alternative, complementary]
APPLIES_TO:
from: [Solution, Article]
to: [Persona, Plan, Version]
properties:
- conditions: text
实施指南
阶段 1:基础(第 1–2 周)
- 定义核心实体类型
- 记录属性架构
- 映射主要关系
- 选择技术栈
- 设置开发环境
第 2 阶段:核心图谱(第 3-4 周)
- 从文档中提取实体
- 创建初始关系
- 导入图数据库
- 构建基础查询界面
- 请领域专家进行验证
第 3 阶段:集成(第 5-6 周)
- 连接到支持系统
- 实现搜索增强
- 添加内容推荐
- 创建管理界面
- 设置监控
第 4 阶段:智能化(第 7-8 周)
- 添加推理规则
- 实现相似度评分
- 启用自动提取
- 构建反馈闭环
- 部署到生产环境
风险信号
- 孤立节点:没有关系的实体
- 关系泛滥:存在过多较弱的关系
- 数据过时:过时信息未更新
- 模式漂移:实体建模不一致
- 查询复杂:简单问题需要复杂查询
- 缺乏验证:自动添加的内容未经验证
- 缺少上下文:关系没有属性
- 覆盖不足:未表示关键概念
成功指标
| 指标 | 衡量内容 | 目标 |
|---|---|---|
| 图谱覆盖率 | 已捕获概念的百分比 | 90%+ |
| 搜索效果提升 | 与关键词搜索相比的相关性 | 2x+ |
| 问题解决速度 | 找到答案所需时间 | 缩短 50% |
| 关系准确率 | 专家验证通过率 | 95%+ |
| 查询延迟 | 响应时间 | < 100ms |
| 用户满意度 | 用户对图谱功能的 CSAT 评分 | 4.0/5.0+ |
| 自动化率 | 通过图谱自动解决的问题占比 | 30%+ |
| 图谱增长 | 每月新增实体数 | 稳健增长 |
评论
支持 Markdown