图分析工具参考

返回：返回加载状态、graph_version 和规模信息。后续用 get_graph_info 检查图结构。

• 覆盖与追加会改变活动图。构图属性图不支持 append，返回 UNSUPPORTED_PROPERTY_GRAPH_APPEND 时原图保持不变。

返回：直接加载返回格式、状态与图版本；后台加载返回 async、job_id、status。任务完成后读取 get_job_status 的 job.result。

• MCP 对 .sql、.csv、.txt 文件返回 CONSTRUCTION_REQUIRED，要求先在数据集面板构图。引擎的其他文件路径可检测边列表、三元组或自然语言，但不能据此绕过数据集构图入口。
• 自然语言、多图数据集与部分 Nebula 导入会转为后台工作；不要将 queued 当作图已加载完成。

返回：返回 async=true、job_id 和 queued 状态；最终结果包含抽取与图加载信息。

• 该入口执行文本关系抽取。基于技能的数据集构图由独立构图智能体完成，具有查询验收与表示演化流程。

返回：返回加载状态、图版本与规模；关系和附带证据信息参与图数据生成。

• relation 写入 edge_type，evidence 写入 edge_text，confidence 写入 edge_feat；三元组数不一定等于最终边条目数。

无业务参数；身份与会话由运行时注入。

返回：返回 success、graph_version 及清空后的图状态。

无业务参数；身份与会话由运行时注入。

返回：返回转换状态、图版本、节点与边数量及方向信息。

• 方向转换会影响路径、入度/出度与边计数语义；转换后重新读取 get_graph_info。

无业务参数；身份与会话由运行时注入。

返回：返回 datasets 列表及数据集标识、版本和存储信息；构图数据集受访问范围限制。

返回：返回 dataset_id、dataset_version、图版本与规模。已构图数据集应使用 load_constructed_graph。

• 已构图数据集使用 load_constructed_graph；普通加载可能返回 USE_CONSTRUCTED_GRAPH_LOADER，提示更新正确的会话绑定。

返回：返回 dataset 元数据，包括数据集标识、名称、版本及用户或全局范围。

无业务参数；身份与会话由运行时注入。

返回：返回恢复是否成功及当前 graph_version；无可用历史状态时返回失败说明。

无业务参数；身份与会话由运行时注入。

返回：每项包含 graph_version、描述、创建时间、节点与边数量，以及 current 标记。

返回：返回切换状态、当前 graph_version 和节点、边数量。

返回：返回 discarded_graph_version、当前 graph_version 和图规模；版本或可用回退状态不存在时返回失败。

• 该工具在目录中标记为 internal，但原生 MCP 工具发现仍可取得它。它删除历史版本；普通切换使用 load_graph_version。

返回：提交返回 async=true、job_id、graph_id 与 graph_version；完成结果含质量摘要、规模及 representation=partitioned_snapshot，current_graph_replaced=false。

• 无需先构建完整 GraphData 或 NetworkX 图；需要运行中的大图 worker 与足够资源。省略 quality_policy 时，edgelist 默认保留节点原名并采用最后重复边权；triples 默认 nfkc_casefold 与最大权重。传入空对象使用质量策略类的默认值，不能视作完全等同于省略对象。

返回：返回异步作业句柄；完成后通过 get_job_result 获取 summary、preview 和 artifact_id。精确、近似、有界或混合语义以能力与实际结果为准；完整可物化输出保存在结果文件中。

• 路径需 source/target，流/割需 source/sink，方法类需 method，指标类需 metric。LCA 另需 node1/node2，支配关系需 source，均衡着色需 num_colors。参数对象允许扩展字段，但仍由运行时按算法校验；不支持模式或资源不足会明确拒绝。

返回：返回 success、graph_id 和 versions；版本信息包含准备/发布状态与质量摘要。

• 只有已发布版本可用于算法。该列表不是 list_graph_versions 返回的普通活动图历史，不要仅凭编号假定两个表示已绑定同一数据源。

返回：返回 success、artifact 和 download_url_template；文件总数、路径/下载序号预览与完整序号范围在 artifact 中。

• download_url_template 的 {partition} 是扁平结果文件列表的下载序号，不一定等于输入分区编号。经 Backend 的 /api/sessions/{session_id}/large-graph/artifacts/{artifact_id}/partitions/{partition} 逐文件下载，仍校验工作区、会话和文件范围，无需浏览器登录。

无业务参数；身份与会话由运行时注入。

返回：返回 success 与 capabilities，包含引擎版本、精确/近似/有界语义、复杂度、并行策略和结果类型。

• 目录表示实现契约和适用条件，不代表每个方法都已在当前数据上运行成功。社区名称当前映射为加权同步标签传播近似，部分中心性也有采样或近似映射；严格比较前设置 strict_semantics 并核对实际结果。

无业务参数；身份与会话由运行时注入。

返回：返回图概要、节点与边预览、num_edge_entries、num_unique_edges、semantic_type、storage_type，以及标签、特征与图学习就绪状态。

• num_edge_entries 是存储条目数，num_unique_edges 是去重后的逻辑边数；双向存储的无向图应按其语义理解计数。

返回：返回节点度、入度、出度、邻居、前驱、关联边与标签、类型；有节点文本时包含 text。列表按预览上限截断。

• 描述性查询先使用 search_node，取得精确名称后再调用本工具。

返回：返回存在状态及权重、关系名称、标签与类型；多关系结果附预览和截断信息。

• 平行关系应使用返回的真实关系 ID 区分；只给端点不代表图中只有一条关系。

返回：返回 exists 和 directed 等状态字段。

返回：返回指定方向的邻居列表及相关遍历信息，最多按 limit 返回。

• Nebula 的方向参数由原生查询处理；返回的是一跳局部结果。

返回：返回 best、candidates、ambiguous、semantic_enabled 和 retrieval_mode；候选包含精确 node_name 及匹配证据。

• ambiguous=true 时先确认候选。没有可用语义嵌入服务时，精确名称或有效节点编号仍可匹配；其他文本查询不会获得词法相似度分数，候选主要由结构过滤和排序决定。使用 semantic_enabled 与 retrieval_mode 判断模式。
• 实体语义检索依赖 Graph Engine 自己的嵌入服务配置：EMBEDDING_PROVIDER 可显式选择 sentence-transformers、openai 或 lexical。默认先尝试本地 Sentence Transformers（需要依赖与模型权重），失败后在存在 OPENAI_API_KEY 时选择 OpenAI，否则使用词法哈希。当前 OpenAI 分支调用固定的 api.openai.com/v1/embeddings；Agent Runtime 的聊天模型或 EMBEDDING_BASE_URL 配置不会自动改写这个地址。词法模式不为实体查询提供语义相似度排序；索引编码失败时也会禁用语义检索，应检查 semantic_enabled 与检索错误信息。 显式选择 openai 时必须提供 OPENAI_API_KEY；显式提供方初始化失败不会执行上述自动选择。首次实体索引会编码全图节点与边文本，远程服务的可达性、延迟和额度也影响可用性。

返回：返回 best、candidates、ambiguous 及检索模式，候选包含精确端点和关系信息。

• query、src_query、dst_query 至少提供一项；ambiguous=true 时先确认关系或端点候选。
• 精确端点定位只返回最后一条关系，无法据此枚举全部平行关系；逐条核对请使用保存属性图中的真实 edge_id。
• 语义查询使用与 search_node 相同的 Graph Engine 嵌入服务；无可用服务时只保留精确定位、结构过滤与排序能力，rerank 不会调用独立重排模型。

返回：单路径返回 found、path、hop_count、total_length、edges、weighted；k 路径返回 paths；all 返回 reachable_count、距离统计和 nearest_paths。

• 权重在此表示距离或成本。多重图对同一端点对取最小权重构成私有计算视图，原有关系不被删除。

返回：返回 length、paths、count_returned、truncated；默认最多展示 10 条。没有路径时 paths 为空。

• 本工具返回等价最优路径；yen_k_shortest 可以包含成本更高的备选路径。公开参数不含 limit，默认结果上限为 10 条。

返回：按模式返回 has_path、paths/count/truncated 或平均距离结果；Nebula 有界分析会附范围元数据。

• 平均最短路径按边权计算。有向图要求整图强连通，否则失败；无向非连通图只计算最大连通分量。该结果不能用来宣称其他分量也可互达。

返回：返回节点或闭包边预览、数量和截断标记；闭包未完全枚举时给出 num_edges_at_least。

• Nebula 查询受 max_steps、max_nodes、max_edges 限制。范围内无路径或未返回某节点，不能直接证明整图不可达。

返回：返回 max_flow_value、total_nonzero_edges、top_flow_edges 和 truncated。

• weight 作为容量，平行边容量相加；不能直接把成本图的权重当作吞吐能力。

返回：返回 min_cut_value、分区规模、较小分区节点和割边预览。

• 源汇最小割使用容量语义；平行关系在计算视图中按容量求和。

返回：返回 min_cut_value、algorithm、分区规模、割边预览及 disconnected；不连通图割值为 0。

• 有向图在 treat_as_undirected=false 时拒绝该操作；需要保留方向的源汇问题使用 minimum_cut。

无业务参数；身份与会话由运行时注入。

返回：连通时返回 total_weight、num_edges 和 mst_edges_preview；不连通时返回 num_components 和 forest_summary。

• 采用无向视图；对属性多重图使用每对节点间的最小权关系。森林摘要不等于完整边列表。

返回：返回连通性判断、分量总数、大小与节点预览；默认展示 5 个分量，每个预览 10 个节点。

返回：返回 cycles、truncated 和 total_cycles_at_least；截断时数量是已确认下界。

• 简单环数量可能指数增长。limit=all 会取消展示枚举上限；truncated=true 时不可把已返回环数写成全图总数。

返回：返回 cycle、cycle_length、cycle_weight、edges、cycles_examined、search_exhausted 和 truncated。

• 最长简单环是高成本组合问题。search_exhausted=false 时只保证已扫描候选中的最优结果；多重图暂不支持。

返回：返回拓扑顺序预览、节点总数及 truncated；包含环时无法给出合法拓扑序。

• 拓扑顺序可能不唯一；预览只是合法顺序的前缀，不代表整个执行计划。

返回：find_cliques 返回团预览及数量下界；clique_number 返回最大团大小；number_of_cliques 返回节点参与次数。

• 极大团是无法再扩展的完全子图；最大团是所有团中规模最大的一个。团枚举可能指数增长，多重图暂不支持。

返回：根据方法返回 value、is_planar、hash、score_sequence、order/orders 或遍历树 edges_preview，附总量与截断信息；不会改变活动图。

• 树/森林、AT-free、二部图和平面性使用无向视图。BFS/DFS 需 source；拓扑排序需 DAG。score_sequence 检查出度序列是否满足锦标赛得分序列条件，不能代替 is_tournament。WL 哈希相同也不是同构证明。
• 当前普通图入口不支持多重图，返回 UNSUPPORTED_MULTIGRAPH_OPERATION；大图同名算子有独立能力约束。

返回：按方法返回 value、nodes、items、components 或缩点图 nodes/edges；size/count 和 truncated 描述总量与列表范围。

• 局部连通度/割集同时提供 source 和 target。连通度、割集、割点、桥和双连通类方法使用无向视图；condensation 要求有向图。全局最小点/边割要求非空连通输入，并非前述按权重容量计算的 minimum_cut。
• 当前普通图入口不支持多重图，返回 UNSUPPORTED_MULTIGRAPH_OPERATION；大图同名算子有独立能力约束。

返回：按方法返回 edges/total_weight、ancestor、items、path、value、antichains 或 structures。汇聚结构结果含 count_is_exact；count=null 表示未得到精确总数。

• 生成树使用连通无向视图；LCA 需 node1/node2，支配关系需 source。DAG 最长路按 weight 计算，拓扑相关方法要求 DAG。is_aperiodic 要求非空强连通有向图；v_structures 排除两个前驱之间已有连接的情形。
• 当前普通图入口不支持多重图，返回 UNSUPPORTED_MULTIGRAPH_OPERATION；大图同名算子有独立能力约束。

返回：返回 matching 或 edges 及 size/total_weight，匹配校验返回 value，着色返回 coloring 与 num_colors；列表可截断。

• 极大匹配是不能再加入边的匹配，不保证边数最大。最小边覆盖拒绝孤立节点；equitable_color 需要 num_colors 大于最大度。greedy_color 的结果依赖策略，不承诺最少颜色。
• 当前普通图入口不支持多重图，返回 UNSUPPORTED_MULTIGRAPH_OPERATION；大图同名算子有独立能力约束。

返回：标量返回 value；节点集合返回 nodes/count，映射返回 values/count，并附适用的 truncated。无环图 girth 返回 value=null、acyclic=true。

• 中心、边缘、离心率、Wiener 指数和重心使用最大无向连通分量；其中重心按 weight，其他四项无权。效率使用无权无向视图，富俱乐部系数 normalized=false。flow_hierarchy 要求有向图并使用权重。
• 当前普通图入口不支持多重图，返回 UNSUPPORTED_MULTIGRAPH_OPERATION；大图同名算子有独立能力约束。

返回：返回 centrality_type、total_nodes、value_stats、top_nodes、bottom_nodes 和 truncated。

• 多重图中 PageRank/eigenvector/Katz 使用平行权重求和；betweenness/closeness/harmonic/load 使用最小距离。voterank/percolation 尚未支持多重图。
• 属性/多重图的距离权重须非负；betweenness 与 load 还要求严格正权重。迭代中心性可能因数值或收敛条件失败。

返回：返回度统计、分布与高低度节点预览；Nebula 指定 node 时直接返回该节点的度。

返回：返回 metric、value 与 defined。直径/半径使用最大无向连通分量的无权距离；非有限值表示为 value=null、defined=false。度同配系数无定义时还附原因码和说明。

• density 保留原图方向语义；diameter/radius 在最大无向分量计算。多重图仅显式支持 density、diameter、radius。

返回：返回算法名、社区总数、模块度、社区规模与节点预览，附 communities_truncated。

• Leiden 依赖不可用或计算失败时回退 Louvain。Girvan–Newman 取第一次拆分；asyn_fluidc 在非连通图上只处理最大分量。
• 多重图仅支持 louvain 与 greedy_modularity，以无向平行权重求和视图计算；每个社区内部节点仍是预览。

返回：返回子图规模、节点与边预览；create_version=true 时还返回新图版本并切换活动图。

• create_version 默认 true。仅想检查局部结构时传 false；活动图切换后，后续工具使用新的子图。
• 多重图显式支持 ego_graph 与 node_subset；核、truss 与 corona 不在已支持的多重图选项内。

返回：返回指定节点对的得分，或按分数排序的前 top_k 个候选关系。

• 使用无向邻域。全图候选评分仍需扫描非边，top_k 只限制保留的结果；多重图不支持。

返回：返回文档标识、分块数量与检索模式等索引结果。

• 文档索引属于当前会话。切换嵌入服务的向量维度可能需要重新索引现有文档。

返回：返回相关片段、文档与分块标识、分数及检索模式。

返回：返回 nodes、edges 及可选社区与高亮信息；受限视图附 truncated 等字段，活动图不变。

• 概览综合高亮、节点类型、社区代表、高度数节点和连接路径；边上限由 VISUALIZE_MAX_EDGES 控制，默认 2,000。检查 truncated、total_nodes/total_edges、overview.required_nodes_truncated；过多高亮也可能截断。图指标应来自分析工具。

返回：返回报告结构与展示数据；所有统计必须来自 source_results、当前图或用户明确提供的数据。

• 报告工具由 MCP_ENABLE_REPORTING_TOOLS 控制，默认启用；设为 0、false、no 或 off 时不向智能体注册。
• 返回 analysis_report.v2 结构以供界面展示，不自动写入 Markdown/PDF 或 Derived。需要可下载文件时，在 Runtime 的 Ephemeral 工作区生成内容，再用 workspace_publish(path=..., name=...) 发布；name 应带正确扩展名。

返回：返回数据集标识、profile、图数量、标签与划分信息；MCP 调用以后台任务处理加载。

• 使用数据集固定契约、划分与指标。将其中一张图加载为活动图不会把多图分类问题变为单图训练数据。

返回：返回 graph_version、单图规模、split、graph_label、预览与分析就绪状态。

返回：返回模型结构图、层级摘要和关键超参数。

返回：MCP 返回任务句柄；完成后结果包含模型标识、训练状态与指标或错误。模型产物绑定相应会话与训练数据身份。

• 图分类必须先加载数据集，并使用固定 split/metric。feature_source=embedding 必须提供 upstream_model_id；训练前检查数据就绪状态。
• 嵌套参数用点号展示路径，实际请求仍按 data、train_config、algo_config 对象发送。MCP 自动处理训练的后台任务标记。
• MCP 层可以返回后台句柄；原生运行时的 GraphMCPTools 会监控任务并将最终结果交回主智能体。
• 缺少 node_feat 的单图使用归一化入度、出度、总度与常数特征，原始业务字段不会自动编码。GNN 预训练无独立掩码/增广实现，也不执行早停；Node2Vec 固定 CPU，默认嵌入维度 128，忽略 weight_decay 和早停。

返回：监督任务返回预测明细与相应评估，分页不缩小评估集合；预训练返回 embeddings 数组，每项包含 node 与 embedding。PCBA 默认只展示少量高概率任务。

• edges 必须是二元数组列表。预测分页不应被解读为评估只覆盖这一页；PCBA 默认返回少量高概率任务。
• 预训练推理不对新图执行 GNN，只查询训练时保存的 embedding.npy。链接预测的内积解码器对称，候选中可有已存在边，需检查 exists_in_graph。节点分类 query.split 读取原图掩码，不是训练时未保存的随机划分。

返回：返回 success、job 和 progress_updates。普通作业 job 含状态、进度、detail 与最终 result；大图 job 含 stage、summary、artifact_id 等持久化状态，完整结果摘要使用 get_job_result 读取。

• 普通作业传 after_seq 可按游标读取进度；省略时消费待推送进度。大图作业 progress_updates 为空。普通完成结果可从 job.result 或 get_job_result 读取，大图完成结果使用 get_job_result；两者均需检查终态与业务 success。

返回：返回 success 与 job_id，表示取消请求是否被接受；随后用 get_job_status 确认终态。请求成功不能单独证明计算已退出。

• 取消请求与计算停止分开确认。排队任务不会启动实际计算，运行任务要等待 worker 停止和资源回收。

无业务参数；身份与会话由运行时注入。

返回：返回 Nebula 可用性、连接与图存储状态信息。

无业务参数；身份与会话由运行时注入。

返回：同步可返回后台 job_id；通过任务状态读取最终同步结果及图版本相关信息。

• 需先配置可用的 Nebula 服务。智能体查询节点与路径通常使用 get_node_info、get_neighbors、shortest_path 这些统一入口。

返回：返回 Nebula 节点、属性与连接相关信息；未加载或未同步图时返回相应存储错误。

• 这是后端专用入口。希望由引擎按当前存储选择路径时，可使用 get_node_info。

返回：返回 Nebula 邻居列表与遍历信息，结果数受 limit 限制。

• 统一的 get_neighbors 同样可路由 Nebula 主存储。两者查询目的相同时无需重复调用。

返回：返回有界路径查询结果、节点序列与遍历信息；边界内没有路径不证明整个图不可达。

• 没有 use_weight 参数，不用于最小加权代价。需要统一入口时使用 shortest_path；Nebula 原生路径对应 use_weight=false。

返回：外层返回 success 与 result。普通终态的 result 含 job_id、status、result、error；大图 result 含 status、graph_id、graph_version、summary、preview、artifact_id、error 等。

• queued/running 的 success=true 仅表示作业查找成功。确认 status=done 后再检查内层业务结果；failed/cancelled 返回 success=false。未知或无权访问的作业不会返回结果。

无业务参数；身份与会话由运行时注入。

返回：返回 source_type 对应能力与优化规则；未注册算法显示 algorithm_unavailable。

• 初次源文件构图由数据集面板发起。算法不可用时报告能力状态，不将旧文本抽取结果冒充技能构图成果。

返回：返回 status、revision、source_type 和规模。只有 ready 表示已保存图可用。

返回：graph 包含 directed、nodes(id,type,properties) 与 edges(id,source,target,type,properties)，并返回修订信息。

• 先读取图再引用元素 ID。这里的 revision 属于保存数据集，与会话 graph_version 是不同的版本空间。

返回：返回加载状态、会话图版本和数据集绑定；替换活动图，不重新运行构图。

• 加载后用 get_graph_info 检查分析语义与特征；使用 visualize_subgraph 展示结果。

返回：返回预览图与 diff，用于确认受影响节点、关系和属性；保存状态与 revision 不变。

• operations[].op 为每项必需字段，其余字段由具体操作决定；先用 get_constructed_graph 取得真实节点、关系与属性名。

返回：返回提交结果与新 revision。版本冲突需重新读取并预览；之后调用 load_constructed_graph 更新活动会话。

• 必须保持与预览相同的 base_revision 和 operations，并完成用户确认。remove_from_node 与 cascade 应明确填写预期行为。