@geoscene/ai-components 0.0.0-stage → 5.1.13

package/dist/chunks/geosceneKnowledgeGraph.js

@@ -0,0 +1,221 @@
+/* COPYRIGHT GeoScene - https://js.geoscene.cn/5.1/LICENSE.txt */
+import { StateGraph as x, START as k, END as c, Command as b } from "@langchain/langgraph/web";
+import { a as K, c as _, b as T, d as A, e as S, s as M, q as v, g as u, h as q, t as g, r as C, i as E, G, j as m } from "./adapter.js";
+import "@geoscene/core/identity/IdentityManager.js";
+import "@geoscene/core/portal/Portal.js";
+import "@geoscene/toolkit/string";
+import { h as N, e as R } from "./generateLayerDescriptions.js";
+import { AIMessage as y } from "@langchain/core/messages";
+import "@langchain/core/callbacks/dispatch/web";
+import "@langchain/openai";
+import "@geoscene/core/config.js";
+import "@geoscene/core/core/reactiveUtils.js";
+import "@geoscene/core/layers/FeatureLayer.js";
+import "@geoscene/core/request.js";
+import { ToolNode as L } from "@langchain/langgraph/prebuilt";
+import { s as p, a as z } from "./index.js";
+import "@langchain/core/prompts";
+const w = [
+  K,
+  _,
+  T,
+  A,
+  S,
+  M,
+  v
+];
+async function D(e, t) {
+  const o = await u("geoscene_knowledge_tool_prompt"), s = q(t), n = {
+    assignedTask: e.agentExecutionContext.assignedTask,
+    userRequest: e.agentExecutionContext.userRequest,
+    priorSteps: e.agentExecutionContext.priorSteps,
+    contextType: s
+  }, r = await N({
+    promptText: o,
+    messages: e.geosceneKnowledgeMessages,
+    inputVariables: n,
+    tools: w,
+    config: t
+  }), l = (r.tool_calls?.length ?? 0) > 0, a = typeof r.text == "string" ? r.text.trim() : "", i = a.length > 0, d = r.content.toString();
+  return !l && (s === "map" || s === "knowledgeGraph") ? {
+    ...e,
+    geosceneKnowledgeMessages: [...e.geosceneKnowledgeMessages, r],
+    outputMessage: s === "map" ? "当前视图和提示没有适用工具。地图不支持修改非空间可见性、修改布局或根据查询生成链接图。" : "当前提示和知识图谱服务没有适用工具，知识图谱服务仅支持搜索和查询。",
+    status: "success"
+  } : {
+    ...e,
+    geosceneKnowledgeMessages: [...e.geosceneKnowledgeMessages, r],
+    outputMessage: l ? d : a,
+    status: l ? e.status : i ? "success" : "failed",
+    summary: d ? g(d) : "GeoScene 知识 Agent 工具已执行。"
+  };
+}
+const f = {
+  generateCypher: "generated-cypher-query",
+  queryGraphData: "graph-query-result",
+  searchGraphData: "graph-search-result",
+  addRecords: "added-records",
+  applyLayout: "applied-layout",
+  changeNonspatialVisibility: "changed-nonspatial-visibility",
+  createLinkChart: "created-link-chart"
+};
+function F(e) {
+  return !!e && e.status === "success" && !!f[e.toolName];
+}
+function $(e) {
+  return {
+    type: f[e.toolName],
+    data: e.details
+  };
+}
+async function I(e, t) {
+  const o = new L(w, { handleToolErrors: !1 });
+  try {
+    const s = await o.invoke(
+      {
+        messages: e.geosceneKnowledgeMessages
+      },
+      t
+    ), n = [];
+    for (const a of s.messages) {
+      let i;
+      if (typeof a.content != "string")
+        throw new Error(`工具消息内容类型异常：${typeof a.content}，应为字符串。`);
+      try {
+        i = JSON.parse(a.content);
+      } catch {
+        throw new Error(
+          `将工具消息解析为 JSON 失败。工具：${a.name ?? "unknown"}。
+
+原始内容：${a.content}`
+        );
+      }
+      if (!i || typeof i != "object" || !("toolName" in i))
+        throw new Error(
+          `解析的工具消息结构不符合预期，解析内容：${JSON.stringify(i)}`
+        );
+      n.push(i);
+    }
+    await p(
+      {
+        text: `GeoScene 知识 Agent 工具执行完成：${s.messages.filter((a) => a.name).map((a) => a.name).join(", ")}`
+      },
+      t
+    );
+    const r = n.filter((a) => typeof a != "string").map((a) => `- 调用的工具：${a.toolName}，状态：${a.status}`), l = n[0];
+    return l && F(l) && await z($(l), t), {
+      ...e,
+      outputMessage: r.join(`
+`),
+      summary: r.length ? g(r.join(`
+`)) : "GeoScene 知识 Agent 未执行工具，也未返回结果。",
+      geosceneKnowledgeMessages: [...e.geosceneKnowledgeMessages, ...s.messages],
+      geosceneKnowledgeToolResult: n
+    };
+  } catch (s) {
+    const n = s instanceof Error ? s.message : String(s);
+    return await p(
+      { text: `GeoScene 知识 Agent 工具执行发生异常：${n}` },
+      t
+    ), {
+      ...e,
+      outputMessage: `GeoScene 知识 Agent 工具执行发生异常：${n}`,
+      status: "failed",
+      summary: g(`GeoScene 知识 Agent 工具执行发生异常：${n}`),
+      geosceneKnowledgeMessages: [...e.geosceneKnowledgeMessages]
+    };
+  }
+}
+const V = (e, t) => (
+  //agent services (ex: embeddingsWorker) would go in the array below, if required.
+  C([], "GeoScene 知识 Agent")(e, t)
+);
+async function j(e, t) {
+  const s = (e.geosceneKnowledgeToolResult ?? []).map((d) => ({
+    ...d,
+    details: void 0
+    // Remove details to avoid overwhelming the LLM with too much info
+  })), { knowledgeGraph: n } = await E(t), r = G.getDataModelTypesSummary(n.dataModel), l = {
+    assignedTask: e.agentExecutionContext.assignedTask,
+    userRequest: e.agentExecutionContext.userRequest,
+    toolResult: s,
+    dataModelSummary: r
+  }, a = await R({
+    promptText: await u("geoscene_knowledge_summarize_result_prompt"),
+    modelTier: "default",
+    inputVariables: l,
+    config: t
+  }), i = typeof a == "string" ? a : a.content;
+  return {
+    ...e,
+    outputMessage: i,
+    status: "success",
+    summary: g(i),
+    geosceneKnowledgeMessages: [...e.geosceneKnowledgeMessages, new y(i)]
+  };
+}
+async function O(e) {
+  const t = e.geosceneKnowledgeToolResult?.[0], o = t?.status === "success" ? t.summary : "GeoScene 知识 Agent 工具执行失败。";
+  return {
+    ...e,
+    outputMessage: o,
+    status: "success",
+    summary: g(o),
+    geosceneKnowledgeMessages: [...e.geosceneKnowledgeMessages, new y(o)]
+  };
+}
+function h(e) {
+  return async (t, o) => o?.signal?.aborted ? (await p({ text: "知识 Agent 执行已取消" }, o), new b({
+    goto: c,
+    update: {
+      outputMessage: "知识 Agent 执行已取消",
+      summary: "知识 Agent 执行已取消",
+      status: "failed"
+    }
+  })) : await e(t, o);
+}
+const P = () => new x(m).addNode("requireGeosceneKnowledgeServices", V).addNode("agent", h(D)).addNode("tools", h(I)).addNode("summarizationLLM", h(j)).addNode("finalizeToolSummary", h(O)).addEdge(k, "requireGeosceneKnowledgeServices").addEdge("requireGeosceneKnowledgeServices", "agent").addConditionalEdges("agent", (t) => (t.geosceneKnowledgeMessages[t.geosceneKnowledgeMessages.length - 1]?.tool_calls?.length ?? 0) > 0 ? "tools" : c).addConditionalEdges("tools", (t) => {
+  if (t.status === "failed")
+    return c;
+  const o = t.geosceneKnowledgeToolResult?.[0];
+  return o?.status === "success" && ["applyLayout", "changeNonspatialVisibility"].includes(o.toolName) ? "finalizeToolSummary" : "summarizationLLM";
+}).addEdge("summarizationLLM", c).addEdge("finalizeToolSummary", c), J = String.raw`该 Agent 处理知识图谱数据。知识图谱以互相连接的实体（节点）和关系（边）表示并存储数据。
+能力分为两类：操作当前链接图中可视化的数据子集，以及查询服务和数据库中的完整知识图谱数据。
+对于链接图，可添加、移除实体或关系，从指定实体展开，查找并添加实体间关系或指定实体发出的关系，切换非空间数据可见性，以及修改布局。
+对于完整图谱，可根据用户提示生成 Open Cypher 查询，必要时根据查询结果创建新链接图。
+
+支持的操作：
+- 修改或应用布局：将用户意图映射到 organic-standard、organic-community、basic-grid、hierarchical-bottom-to-top、radial-root-centric、tree-left-to-right、geographic-organic-standard、chronological-mono-timeline 等有效布局。
+- 切换非空间数据可见性：将请求映射到 hidden 或 visible。
+- 生成 Cypher 查询：按条件过滤和遍历指定关系，保证语法和性能；只有用户明确要求返回查询语句时才单独返回，否则查询用于其他工具。
+- 创建新链接图：用户必须明确要求创建或生成链接图。
+- 添加记录：将查询得到的实体或关系添加到当前链接图。
+- 搜索图谱数据：生成并执行 Lucene 查询，返回匹配实体和关系。
+- 查询图谱数据：生成并执行 Cypher，在聊天面板展示结果。
+
+示例：
+“把布局改为 hierarchical-bottom-to-top”“应用 radial-root-centric 布局”“显示非空间数据”“隐藏非空间数据”“关闭非空间数据可见性”。
+“生成查询，查找2020年后通过 Relationship X 连接 Entity A 的实体”。
+“查找2015年后加入 GeoScene 且位于 California 的员工”。
+“查询 Supplier Y 供应且价格超过 $1000 的产品”。
+“创建新链接图，显示通过 Relationship Y 关联 Entity B 的实体”。
+“查找 Microsoft 员工并放到新链接图”。
+“将通过 Relationship Z 连接 Entity C 的实体添加到当前链接图”。
+“将 GeoScene 员工及其驾驶的汽车添加到当前链接图”。
+“找到 Supplier X 的产品并添加到可视化”。
+“从 Entity D 展开直接连接”“查找所有汽车并添加其两跳以内的全部记录”。
+“如果 Emma 和 Rob 有关系，在链接图上连接他们”。
+“查找并添加 Entity E 发出的全部关系”。
+“查找名称类似 Smith 的实体并添加到链接图”。
+“查找标题类似 Quarterly Earnings 的报告”。
+“查找 John Smith 及其过去一年内通话的人”。
+“GeoScene 员工的平均年龄是多少”。`, le = {
+  id: "geosceneKnowledge",
+  name: "GeoScene 知识 Agent",
+  description: J,
+  createGraph: P,
+  workspace: m
+};
+export {
+  le as A
+};

package/dist/chunks/geoscene_knowledge_current_lc_context.js

@@ -0,0 +1,25 @@
+/* COPYRIGHT GeoScene - https://js.geoscene.cn/5.1/LICENSE.txt */
+const e = `## 图中记录的绑定参数
+
+当前链接图只包含数据库中的部分实体和关系。这些记录的字符串标识符可通过以下绑定参数用于 Cypher 查询：
+
+- $entityIds
+- $relationshipIds
+
+只有用户明确要求将数据范围限制到“当前链接图”“我的链接图”等已有记录时，才使用这些参数过滤。
+
+### 示例开始
+
+用户请求：“将与本链接图中人员相连的记录添加到链接图”。
+上下文：数据模型有 Person 实体。
+预期结果：MATCH (n:Person)-[r]->(m) WHERE id(n) IN $entityIds return r, m
+
+用户请求：“将全部供应商添加到链接图”。
+上下文：数据模型有 Supplier 实体。
+预期结果：MATCH (s:Supplier) RETURN s
+
+### 示例结束
+`;
+export {
+  e as default
+};

package/dist/chunks/geoscene_knowledge_current_map_context.js

@@ -0,0 +1,36 @@
+/* COPYRIGHT GeoScene - https://js.geoscene.cn/5.1/LICENSE.txt */
+const e = `## 图中记录的绑定参数
+
+当前地图只包含数据库中的部分实体和关系。这些记录的字符串标识符可通过以下绑定参数用于 Cypher 查询：
+
+- $entityIds
+- $relationshipIds
+
+包含的类型：
+{nonDynamicTypes}
+
+过滤规则：
+- 只有同时满足以下条件才按地图已有记录过滤：
+  - 用户要求将范围限制到“当前地图”“我的地图”“知识图谱图层”等已有记录。
+  - Cypher 变量的类型属于上述包含的类型。
+- 其他情况不得使用这种过滤。未列入上述列表的类型也不得添加该过滤。
+
+### 示例开始
+
+用户请求：“将与本地图中人员相连的记录添加到地图”。
+上下文：数据模型有 Person，且在上述绑定参数类型内。
+预期结果：MATCH (n:Person)-[r]->(m) WHERE id(n) IN $entityIds return r, m
+
+用户请求：“将全部供应商添加到地图”。
+上下文：数据模型有 Supplier。
+预期结果：MATCH (s:Supplier) RETURN s
+
+用户请求：“添加与地图中工厂相连的全部供应商”。
+上下文：模型有 Plant，但不在上述绑定参数类型内。
+预期结果：MATCH (p:Plant)-[r]->(s:Supplier) return r, s
+
+### 示例结束
+`;
+export {
+  e as default
+};

package/dist/chunks/geoscene_knowledge_cypher_query_prompt.js

@@ -0,0 +1,96 @@
+/* COPYRIGHT GeoScene - https://js.geoscene.cn/5.1/LICENSE.txt */
+const e = `# GeoScene 知识图谱 Cypher 规则
+
+## 目标
+
+生成符合数据模型、能够回答用户请求的 Cypher 查询。
+
+---
+
+## 1. 用户要求优先（最高优先级）
+
+如果用户指定以下任何内容，始终遵守用户要求，而不是默认值：
+- LIMIT 或不限制结果数量。
+- 输出列或数据模型。
+- 是否包含 globalid。
+- 排序、分组、过滤和投影。
+
+---
+
+## 2. 遵守数据模型（不可违反）
+
+只能使用有效的数据模型元素。
+
+### 要求
+- 只使用有效的实体类型、关系类型和属性。
+- 确保关系连接的实体类型有效。
+- 根据用户提示判断方向；不明确时，使用模型支持且限制最少的有效形式。
+
+### 严格校验
+- 实体、关系和属性必须在数据模型中精确存在。
+- 关系类型、源到目标的配对及方向必须符合结构定义。
+- 属性和过滤条件必须存在于引用类型上，并使用有效数据类型。
+- 每个别名只能对应一个类型，含义不得改变。
+- 任一部分无效时，不生成查询，也不要推断或自行修复。
+
+## 4. 路径解析
+
+- 先尝试直接关系。
+- 不存在时使用有效的多跳路径。
+- 每一跳都必须在数据模型中有效。
+- 默认最多3跳，除非用户要求更多。
+
+### 路径选择
+- 优先最短有效路径。
+- 多条有效路径存在时，选择最符合用户意图的路径。
+- 没有有效路径时，不要猜测。
+
+---
+
+## 5. 性能
+- 使用最少的实体和关系。
+- 优先最短有效路径。
+- 避免不必要的模式和复杂度。
+
+---
+
+## 6. Cypher 规则
+
+- UNION 查询必须返回相同的列。
+- LIMIT 只能放在 UNION 之后，不能放在子查询内部。
+- 不得使用 OVER、REDUCE()。
+- 不得把 call、match、return、as 等保留关键字用作变量。
+- 只使用有效的 openCypher 语法。
+- 在 OPTIONAL MATCH 之后，在任何 MATCH 或关系模式中使用 var 之前，始终加入：
+  WITH ...
+  WHERE var IS NOT NULL
+
+---
+
+## 7. 空间规则
+
+- 优先使用图谱关系，而不是空间函数。
+- 只有必要时才使用空间函数。
+- 使用空间函数时必须保证几何不为 null，例如：
+  WHERE n.shape IS NOT NULL
+
+---
+
+## 9. 默认输出（用户未指定时）
+
+- 除非结果显然很少，否则添加 LIMIT 50。
+- 使用 AS 设置含义明确的别名。
+- 除非用户要求特定属性，否则始终返回完整实体和关系。
+
+---
+
+## 11. 输出格式
+
+- 查询有效时，只返回 Cypher 查询。
+- 不要解释。
+
+---
+`;
+export {
+  e as default
+};

package/dist/chunks/geoscene_knowledge_lucene_generation_prompt.js

@@ -0,0 +1,98 @@
+/* COPYRIGHT GeoScene - https://js.geoscene.cn/5.1/LICENSE.txt */
+const e = `## GeosceneKnowledge Agent——生成图谱搜索的 Lucene 查询
+
+你负责为图谱文本搜索生成 Lucene 查询。
+
+以下是知识图谱中的命名类型，以及每种类型对应的可搜索文本属性。
+数据结构：
+<TYPE_NAME> - [可搜索字段名组成的数组]
+
+{dataModelForSearch}
+
+用户希望通过文本搜索回答：
+{inquiry}
+
+返回能回答问题的 Lucene 查询参数对象，包含：
+- \`query\`：字符串，用于回答问题的 Lucene 查询表达式。
+- \`typeFilters\`：字符串数组，只搜索指定的命名类型；无需限制类型时返回 null。
+- \`typeCategoryFilter\`：只能是 'entity'、'relationship' 或 'both'，分别表示实体、关系或两者。默认使用 'entity'，除非用户要求搜索两种记录，或明确提到关系、关系类型。选择 'entity' 时，\`typeFilters\` 不得包含关系类型，反之亦然。
+- \`resultLimit\`：最小值为1的数字或 null，表示最多返回多少条。默认10；用户指定数量时遵从要求；用户明确要求全部结果或不限制数量时返回 null。
+
+生成参数的补充规则：
+- 只有用户指定了字段或属性，且对应类型的可搜索字段列表确实包含该字段，才在 Lucene 表达式中限定字段，否则搜索全部字段。
+- 用户的问题限定某些实体或关系类型时，用 \`typeFilters\` 表达，不要试图通过搜索字段替代类型过滤。无需类型过滤时返回 null。
+- Lucene 搜索不支持正则表达式，\`query\` 中不得包含正则查询。
+
+**示例开始**
+
+### 可搜索属性示例
+
+实体类型：
+Author - [name, title]
+Report - [organization, summary, full_text, tags]
+
+关系类型：
+authored - [contribution_type]
+
+各类型的可搜索字段：
+
+Author:
+name
+title
+
+Report:
+organization
+summary
+full_text
+tags
+
+authored:
+contributionType
+
+### 用户问题1
+
+查找前5份报告：summary 提到 Sacramento 附近的 flood zoning，organization 名称接近 City of Sacramento Utilities，并且 tags 包含 stormwater。
+
+### 对应参数1
+
+query: 'summary:"flood zoning" AND summary:Sacramento AND organization:"City of Sacramento Utilities"~2 AND tags:stormwater'
+
+typeFilters: ['Report']
+
+typeCategoryFilter: "entity"
+
+resultLimit: 5
+
+### 用户问题2
+
+查找包含类似 'City of Sacramento Utilities' 文本的实体。
+
+### 对应参数2
+
+query: '"City of Sacramento Utilities"~2'
+
+typeFilters: null
+
+typeCategoryFilter: "entity"
+
+resultLimit: 10
+
+### 用户问题3
+
+查找 title 为 'Researcher' 的人撰写的全部报告。
+
+### 对应参数3
+
+query: 'title:"Researcher"'
+
+typeFilters: ['Author']
+
+typeCategoryFilter: "entity"
+
+resultLimit: null
+
+**示例结束**
+`;
+export {
+  e as default
+};

package/dist/chunks/geoscene_knowledge_summarize_result_prompt.js

@@ -0,0 +1,104 @@
+/* COPYRIGHT GeoScene - https://js.geoscene.cn/5.1/LICENSE.txt */
+const n = `# GeoScene 知识 Agent——操作结果汇总
+
+你是一名知识图谱助手，已经通过工具调用处理了用户请求。
+
+## 上下文
+
+**数据模型**
+{dataModelSummary}
+
+**分配的任务**
+{assignedTask}
+
+**用户请求**
+{userRequest}
+
+**工具结果**
+{toolResult}
+
+---
+
+## 目标
+
+基于工具结果生成简洁、完整的 Markdown 回答。
+
+---
+
+## 优先规则（严格按顺序）
+
+### 1. 用户指定格式（最高优先级）
+- 如果用户指定表格、列表、项目符号等格式，必须精确遵守。
+- 忽略下方所有默认格式规则。
+- 除非用户要求，否则不要增加摘要或额外章节。
+
+---
+
+### 2. 默认输出（用户未指定时）
+- 摘要：1至2句话，不加标题、不用项目符号。
+- 结果：最精简、格式清晰的数据。
+- 可选说明：用1至2句斜体说明工具限制。
+- maxPreviewItems: 5
+
+---
+
+### 3. 输出限制（不可违反）
+- 只输出有效 Markdown，不输出 JSON。
+- 不得虚构实体、字段、数量或关系。
+- 不要包含推理、分类标签、追问、后续步骤、“以下是”等开场语，也不要复述问题。
+- 回答完成后立即结束。
+
+---
+
+### 4. 数据处理
+- 结果为空时，明确说明没有返回结果。
+- 数据不足时，说明限制，不要猜测。
+- 不输出原始嵌套对象、大数组或几何数据。
+- 汇总复杂结构。
+- 长值使用 \`…\` 截断。
+- 实体和关系只展示一次。
+- 术语使用“实体”（entity）而不是“节点”（node），使用“关系”（relationship）而不是“边”（edge）。
+- 除非明确要求，否则隐藏 \`globalid\` 和 \`objectid\`。
+
+---
+
+### 5. 格式规则（仅默认模式）
+- 不使用标题，必要时使用斜体标签。
+- 项目符号用于单项概括，表格用于多项结果，最多5行。
+- 仅保留关键字段列。
+- 日期按“日 月 年”（day month year）顺序，时间与日期分开。
+
+---
+
+### 6. 不同结果类型的格式
+
+**SEARCH_HITS**
+- 用项目符号突出最佳匹配。
+- 其余结果使用表格。
+
+**ENTITIES**
+- 如果有多种类型，则按类型分组。
+- 只展示关键属性。
+
+**RELATIONSHIPS**
+- 格式：\`(entity) —[relationship]→ (entity)\`。
+
+**PATHS**
+- 摘要加1至3个示例。
+
+---
+
+## 内部处理（不要输出）
+
+将结果归类为：
+SEARCH_HITS、ENTITIES、RELATIONSHIPS、PATHS。
+
+## 失败处理
+- 数据不足时，明确说明限制。
+- 绝不推断或编造缺失信息。
+
+---
+`;
+export {
+  n as default
+};

package/dist/chunks/geoscene_knowledge_tool_prompt.js

@@ -0,0 +1,30 @@
+/* COPYRIGHT GeoScene - https://js.geoscene.cn/5.1/LICENSE.txt */
+const e = `# GeosceneKnowledge 工具调用要求
+
+你帮助用户回答知识图谱问题，并操作知识图谱、地图或链接图。请通过一次工具调用完成下列任务。
+
+## 任务详情
+
+分配的任务：
+{assignedTask}
+
+用户请求：
+{userRequest}
+
+之前的步骤：
+{priorSteps}
+
+上下文类型：
+{contextType}
+
+## 规则
+
+1. 根据上方上下文类型判断：如果是 map，绝不能调用 changeNonspatialVisibility、applyLayout、createLinkChart 这些 geosceneKnowledge 工具。
+2. 如果上下文类型是 knowledgeGraph，绝不能调用 changeNonspatialVisibility、applyLayout、createLinkChart、addRecords。
+3. 没有适用工具时，返回零次工具调用和空消息。
+4. 有适用工具时，根据任务传入合适参数，只调用一个 geosceneKnowledge 工具。仅在理解任务需要上下文时，才参考用户请求或之前的步骤。
+5. 关键限制：禁止多次工具调用。必须只调用一个工具或不调用工具。
+`;
+export {
+  e as default
+};