WorkBuddy 可以结合云数据库 PostgreSQL 的 Apache AGE 图数据库能力，辅助用户从关系型业务数据中构建图模型，并通过自然语言完成路径查询、关系解释和影响范围分析。
该场景适用于客户关系分析、产品依赖分析、故障传播分析、组织协作分析、知识图谱和 GraphRAG 等业务。
说明：
WorkBuddy 生成的图模型、导入计划和关系分析结论仅作为辅助参考。生产环境中的扩展创建、图对象创建和数据导入应由用户确认后执行，并遵循业务发布和数据库变更规范。
前提条件
开始前，请完成以下准备工作：
已完成 PostgreSQL MCP Server 配置，WorkBuddy 能够连接数据库并完成只读验证。
已确认目标实例支持 Apache AGE，或已在 PostgreSQL 控制台 AI 应用页面确认实例支持相关 AI 能力。
已准备包含实体和关系的业务数据，例如客户、账号、产品、工单、服务依赖、资源拓扑等表。
已准备临时初始化账号，用于创建扩展、图和导入关系数据。日常查询建议使用只读账号。
如需通过控制台工具生态中的 PostgreSQL MCP Server 查询实例详情和内核版本，请准备最小权限 CAM 子账号的 SecretId、SecretKey 和地域代码。
流程指引
步骤1：检查实例和扩展能力
用户可以向 WorkBuddy 输入：
请检查当前腾讯云 PostgreSQL 是否适合做 Apache AGE 图分析：1. 检查 PostgreSQL 版本。2. 检查 age 扩展是否可用、是否已安装、版本是多少。3. 如果配置了工具生态里的 PostgreSQL MCP Server，请查询实例详情、内核版本和地域信息。4. 只做只读检查，不创建扩展、不创建图、不写入数据。5. 如果当前实例不支持 AGE，请说明阻塞原因和下一步建议。
WorkBuddy 应输出是否可以继续建图。如果实例不支持 AGE，应停止在能力检查阶段。
步骤2：分析业务关系并设计图模型
请分析我的业务表是否适合构建图模型：1. 只读查看相关表结构、外键和每张表最多 5 行样例。2. 识别哪些表适合作为节点，哪些字段适合作为节点 ID 和属性。3. 识别哪些字段或关联关系适合作为边。4. 输出“源表/字段 → 节点标签/属性 → 边类型”的映射表。5. 在我确认前不要创建图，也不要导入数据。
WorkBuddy 应输出图模型建议，帮助用户确认实体和关系是否符合业务理解。
步骤3：生成图初始化和导入计划
请根据确认后的图模型生成 Apache AGE 初始化计划：1. 说明图名称。2. 说明节点类型、边类型和唯一标识。3. 说明预计导入的节点数量和边数量。4. 说明哪些步骤会修改数据库。5. 说明如何验证图创建和路径查询是否成功。6. 在我确认前不要执行。
WorkBuddy 应在执行前展示影响范围和验证方式。
步骤4：确认执行并验证
用户确认后，WorkBuddy 可以创建图、导入节点和边，并执行只读路径查询验证：
age 扩展状态和版本。
图是否存在。
节点类型及数量。
边类型及数量。
典型路径查询是否返回预期关系。
步骤5：自然语言关系分析
图数据准备完成后，用户可以直接描述分析目标：
请分析图中与指定产品相关的客户、账号和工单关系，展示关键路径，找出关联工单最多的产品，并总结受影响客户范围。只执行只读图查询，路径不超过 3 跳。
WorkBuddy 应输出关系路径、关键节点和业务解释。
典型使用场景
场景 | 适合解决的问题 | 主要产出 |
客户影响分析 | 客户、账号、产品和工单关系复杂 | 影响路径、关键客户、关联产品 |
故障传播分析 | 服务或资源之间存在依赖关系 | 传播路径、关键节点、风险范围 |
知识图谱 | 需要维护实体与关系 | 节点模型、边模型、路径查询 |
GraphRAG | RAG 需要结构化关系增强 | 关系上下文、实体路径 |
注意事项
Apache AGE 能否使用取决于实例和扩展支持情况，应先检查再执行。
如果实例在 AI 应用页面显示“不支持 AI”，不要假设 AGE 可用。
图模型应由 WorkBuddy 提出并由用户确认，不建议直接把所有业务表无差别导入图。
生产环境导入前，应先在测试环境验证图模型和查询性能。
图查询路径过长可能导致结果膨胀，建议限制跳数和返回行数。
总结
通过 WorkBuddy，用户可以降低 Apache AGE 图分析的建模和查询门槛。WorkBuddy 可以帮助用户检查实例能力、识别实体关系、生成图初始化计划、导入关系数据并解释路径查询结果。
