mcpField

Knowledge Graph Builder

github.com/eddiebe147数据与数据库52 次安装
代码仓库

关于 Knowledge Graph Builder

用于从支持内容和领域信息设计、构建知识图谱的技能,指导实体与关系建模、图谱构造、查询、推理和持续验证,适用于支持与搜索场景。

主要功能

  1. 01设计领域实体、属性和关系模型
  2. 02规划图谱模式与数据填充方式
  3. 03探索遍历、路径和模式查询
  4. 04运用推理与语义搜索思路
  5. 05审查图谱质量和更新流程

适用场景

  1. 01整理支持文章及问题解决关联
  2. 02梳理产品、问题与解决方案之间的关系
  3. 03规划基于图谱的搜索或推荐体验
  4. 04检查图谱中的缺口、过期节点和薄弱关系

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/eddiebe147/claude-settings --skill knowledge-graph-builder

安装后在 Claude Code 中输入/knowledge-graph-builder确认已加载。

详细介绍

知识图谱构建器

专业知识图谱创建系统,可将零散的支持内容转化为由概念、关系和解决方案构成的互联网络。此技能提供结构化工作流,用于绘制知识领域、定义关系,以及打造智能支持体验。

知识图谱让支持系统能够理解上下文,而不只是关键词。当客户询问“账单问题”时,知识图谱知道这与发票、付款方式、订阅计划以及潜在的客户流失风险相关。此技能可帮助你构建这种关联智能。

此技能基于语义网原则和知识工程最佳实践,结合领域建模、关系映射和实用实施方案,构建可提供更智能支持的知识图谱。

核心工作流

工作流 1:领域建模

定义知识领域中的概念和实体

  1. 实体识别

    • 核心实体:产品、功能、概念
    • 客户实体:账户、用户、细分群体
    • 支持实体:问题、解决方案、文章
    • 流程实体:工作流、规程、步骤
    • 上下文实体:用例、用户画像、场景
  2. 支持场景的实体类型

    实体类型示例用途
    产品应用、功能、模块客户使用的内容
    问题Bug、错误、疑问客户遇到的问题
    解决方案修复方法、变通方案、指南如何解决问题
    文章常见问题、操作指南、参考资料内容资源
    概念术语、流程、能力帮助理解
    用户画像管理员、用户、开发者需要帮助的人
  3. 实体属性

    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
    
  4. 实体提取来源

    • 产品文档
    • 支持工单分类体系
    • 常见问题类别
    • 帮助中心结构
    • 功能规格说明
    • 用户研究发现
工作流 2:关系映射

定义实体之间的连接方式

  1. 核心关系类型

    关系起点终点示例
    SOLVES解决方案问题“密码重置 SOLVES 登录失败”
    PART_OF功能产品“仪表板 PART_OF 分析”
    REQUIRES功能功能“导出 REQUIRES Pro 计划”
    CAUSES问题问题“API 限额 CAUSES 同步失败”
    DOCUMENTED_IN概念文章“账单 DOCUMENTED_IN 定价指南”
    APPLIES_TO解决方案用户画像“变通方案 APPLIES_TO 管理员用户”
  2. 关系属性

    Relationship: SOLVES
    Properties:
    - confidence: how reliable (0-1)
    - conditions: when this applies
    - effectiveness: success rate
    - last_verified: date checked
    
  3. 关系发现

    • 分析支持工单的解决路径
    • 绘制帮助文章之间的交叉引用
    • 识别共同出现的问题
    • 研究用户旅程模式
    • 查阅专家知识
  4. 关系强度

    • 强:始终成立,有充分文档记录
    • 中等:通常成立,是常见模式
    • 弱:有时成立,取决于上下文
    • 建议:可能成立,有待验证
工作流 3:图谱构建

构建实际的知识图谱结构

  1. 图谱架构

    Nodes (Entities):
    - Unique identifier
    - Entity type
    - Properties
    - Metadata (created, updated, source)
    
    Edges (Relationships):
    - From node
    - To node
    - Relationship type
    - Properties
    - Metadata
    
  2. 实施方案

    方案适用场景工具
    图数据库复杂查询、大规模场景Neo4j、Amazon Neptune
    RDF 三元组存储语义网、标准化场景Apache Jena、Stardog
    属性图灵活建模Neo4j、TigerGraph
    嵌入式简单用例NetworkX、GraphQL
  3. 架构设计

    • 定义节点标签/类型
    • 定义关系类型
    • 设置必需属性
    • 定义约束(唯一性、存在性)
    • 创建索引以提升查询性能
  4. 数据填充

    • 从现有来源批量导入
    • 从实时系统通过 API 摄取
    • 由专家手动整理
    • 自动提取(NLP)
    • 根据支持活动持续更新
工作流 4:查询与推理

从知识图谱中提取价值

  1. 查询模式

    查询类型使用场景示例
    遍历查找相关内容“与 X 相关的文章”
    路径查找发现解决方案“从问题到解决方案的步骤”
    模式匹配相似问题“类似 X 的问题”
    聚合分析“每个功能最常见的问题”
    推荐建议“其他用户也看过”
  2. 推理规则

    • 如果 A 导致 B,且 B 导致 C,则建议 A 可能与 C 相关
    • 如果解决方案 S 解决了问题 I,则为相似问题推荐相似解决方案
    • 如果文章 A 记录在 B 中,且 B 需要 C,则将 C 显示为前置条件
    • 如果许多用户依次浏览 A → B → C,则建议使用快捷路径
  3. 语义搜索增强

    • 使用相关概念扩展搜索范围
    • 按图中心性排序
    • 展示相关文章
    • 建议替代术语
    • 根据关系理解上下文
  4. 对话式 AI 集成

    • 将用户意图映射到图实体
    • 沿关系查找答案
    • 根据关联内容生成回复
    • 通过图路径解释推理过程
工作流 5:维护与演进

确保知识图谱准确并持续增长

  1. 质量监控

    • 跟踪使用模式
    • 识别死胡同路径
    • 查找孤立节点
    • 监控关系准确性
    • 衡量搜索成功率
  2. 更新触发条件

    • 新产品发布
    • 文档变更
    • 支持工单模式
    • 用户反馈
    • 专家整理会议
  3. 验证流程

    • 由专家审核新关系
    • 对图驱动功能进行 A/B 测试
    • 监控准确性指标
    • 收集用户反馈
    • 定期审计
  4. 增长策略

    • 从工单中自动提取实体
    • 基于 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 周)
  1. 定义核心实体类型
  2. 记录属性架构
  3. 映射主要关系
  4. 选择技术栈
  5. 设置开发环境
第 2 阶段:核心图谱(第 3-4 周)
  1. 从文档中提取实体
  2. 创建初始关系
  3. 导入图数据库
  4. 构建基础查询界面
  5. 请领域专家进行验证
第 3 阶段:集成(第 5-6 周)
  1. 连接到支持系统
  2. 实现搜索增强
  3. 添加内容推荐
  4. 创建管理界面
  5. 设置监控
第 4 阶段:智能化(第 7-8 周)
  1. 添加推理规则
  2. 实现相似度评分
  3. 启用自动提取
  4. 构建反馈闭环
  5. 部署到生产环境

风险信号

  • 孤立节点:没有关系的实体
  • 关系泛滥:存在过多较弱的关系
  • 数据过时:过时信息未更新
  • 模式漂移:实体建模不一致
  • 查询复杂:简单问题需要复杂查询
  • 缺乏验证:自动添加的内容未经验证
  • 缺少上下文:关系没有属性
  • 覆盖不足:未表示关键概念

成功指标

指标衡量内容目标
图谱覆盖率已捕获概念的百分比90%+
搜索效果提升与关键词搜索相比的相关性2x+
问题解决速度找到答案所需时间缩短 50%
关系准确率专家验证通过率95%+
查询延迟响应时间< 100ms
用户满意度用户对图谱功能的 CSAT 评分4.0/5.0+
自动化率通过图谱自动解决的问题占比30%+
图谱增长每月新增实体数稳健增长

评论

支持 Markdown