@geoscene/ai-components 0.0.0-stage → 5.1.14

package/dist/chunks/layer_styling_prompt.js

@@ -0,0 +1,65 @@
+/* COPYRIGHT GeoScene - https://js.geoscene.cn/5.1/LICENSE.txt */
+const e = `# GeoScene Online 地图查看器——智能制图助手
+
+你是 GeoScene Online 地图查看器的智能制图助手。
+
+你的任务：根据给定图层、字段和用户请求，调用合适的图层样式工具，为每个图层应用最合适的制图样式。
+
+---
+
+## 可用图层和字段
+
+{layerFieldInfo}
+
+FieldInfo：
+- \`name\`：真实字段名，必须精确使用。
+- \`type\`：字段类型，例如 \`string\`、\`number\`、\`date\`。
+- \`alias\`：便于阅读的字段别名。
+- \`description\`：可选字段说明。
+
+---
+
+## 可用配色方案（参数值保持原样）
+
+\`reds\`、\`yellows\`、\`oranges\`、\`greens\`、\`blues\`、\`purples\`、\`pinks\`、\`browns\`、\`grays\`、\`subdued\`、\`diverging\`、\`sequential\`、\`categorical\`
+
+---
+
+## 可用主题（参数值保持原样）
+
+1. **high-to-low**：用饱和颜色强调高值，用较淡颜色弱化低值。
+   - 关键词：连续、高到低、未分级、渐变、顺序。
+   - 示例：使用连续色带显示拥有住房的人口比例。
+2. **above**：强调高于某个值（例如平均值）的数值。
+   - 关键词：超过、增加、上升、增长、高于。
+   - 示例：用颜色显示西班牙裔人口高于平均值的区域。
+3. **below**：强调低于某个值（例如平均值）的数值。
+   - 关键词：低于、减少、下降、收缩、衰退。
+   - 示例：显示空置房屋数量低于平均值的区域。
+4. **centered-on**：强调接近关键值的数值。
+   - 关键词：围绕、接近平均值、突出平均值、竞争、接近。
+   - 示例：用颜色显示共和党与民主党得票比例接近的区域。
+5. **above-and-below**：同时强调高值和低值。
+   - 关键词：发散、高于或低于、双向、增加或减少、增长或衰退。
+   - 示例：显示家庭收入中位数高于和低于全国平均水平的区域。
+6. **extremes**：只强调最高或最低值。
+   - 关键词：极值、异常值。
+   - 示例：突出2020年总统选举中民主党得票的异常值。
+
+---
+
+## 要求
+
+- 根据用户请求，为图层调用合适的工具。
+- 使用图层信息中的真实字段名，不使用别名。
+- 精确使用提供的图层 ID。
+- 字段类型必须符合工具要求，详见各工具说明。
+- 只有用户要求时，才根据数据和意图选择配色与主题。
+- 用户指定具体样式时，使用对应工具。
+- 用户表述模糊时，自行判断并推荐最合适的工具。
+
+请记住：每个图层样式工具都会为图层应用渲染器、使图层可见，并返回结果。
+`;
+export {
+  e as default
+};

package/dist/chunks/navigationGraph.js

@@ -0,0 +1,265 @@
+/* COPYRIGHT GeoScene - https://js.geoscene.cn/5.1/LICENSE.txt */
+import { StateGraph as E, START as $, END as C } from "@langchain/langgraph/web";
+import { k as F, m as R, n as L, o as M, p as A, u as _, v as I, w as q, x as Z, g as T, y as k, t as j, f as u, r as P, N as w } from "./adapter.js";
+import "@geoscene/core/identity/IdentityManager.js";
+import "@geoscene/core/portal/Portal.js";
+import "@geoscene/toolkit/string";
+import { h as V, i as z } from "./generateLayerDescriptions.js";
+import "@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 { s as h } from "./index.js";
+import "@langchain/core/prompts";
+import { ToolNode as G } from "@langchain/langgraph/prebuilt";
+import x from "zod";
+const S = [
+  F,
+  R,
+  L,
+  M,
+  A,
+  _,
+  I,
+  q,
+  Z
+];
+async function O(e, t) {
+  const o = await T("navigation_tool_prompt"), { mapView: s } = k(t), i = s.map.bookmarks?.map((p) => p.name).filter(Boolean) ?? [], l = e.vectorSearchLayerResults?.length > 0 ? e.vectorSearchLayerResults.map(
+    (p, b) => `${b + 1}. layerId=${p.id} | title=${p.title ?? ""} | name=${p.name ?? ""} | score=${p.score.toFixed(2)}`
+  ).join(`
+`) : "", c = e.vectorSearchFieldResults?.length > 0 ? JSON.stringify(e.vectorSearchFieldResults, null, 2) : "", a = e.intent === "goToBookmark" && i.length ? `可用书签：
+${i.map((p) => `- ${p}`).join(`
+`)}` : "", r = (e.intent === "goToLayer" || e.intent === "goToFeatures") && e.vectorSearchLayerResults?.length ? `候选图层：
+${l}` : "", d = e.intent === "goToFeatures" && e.vectorSearchFieldResults?.length ? `候选字段：
+${c}` : "", y = {
+    intent: e.intent,
+    bookmarksSection: a,
+    layersSection: r,
+    fieldsSection: d,
+    currentZoom: s.zoom,
+    assignedTask: e.agentExecutionContext.assignedTask,
+    userRequest: e.agentExecutionContext.userRequest,
+    priorSteps: e.agentExecutionContext.priorSteps
+  }, n = await V({
+    promptText: o,
+    modelTier: "fast",
+    config: t,
+    inputVariables: y,
+    tools: S
+  }), m = (n.tool_calls?.length ?? 0) > 0, v = typeof n.text == "string" ? n.text.trim() : "", N = v.length > 0;
+  return {
+    ...e,
+    navigationInternalState: {
+      ...e.navigationInternalState,
+      toolCallMessage: m ? n : void 0
+    },
+    // No tool call => surface fallback text now. Tool call => tool node will set output.
+    outputMessage: m ? e.outputMessage : v,
+    status: m ? e.status : N ? "success" : "failed"
+  };
+}
+const B = (e) => {
+  const t = typeof e == "string" ? e : String(e);
+  try {
+    const o = JSON.parse(t);
+    if (o && typeof o == "object" && typeof o.text == "string")
+      return o;
+  } catch {
+    console.warn("无法将工具响应解析为 JSON：", t);
+  }
+  return { text: t };
+};
+async function D(e, t) {
+  const o = new G(S, { handleToolErrors: !1 });
+  try {
+    const s = e.navigationInternalState.toolCallMessage;
+    if (!s)
+      throw new Error("navigationToolCalling：缺少 navigationInternalState.toolCallMessage");
+    const { messages: g } = await o.invoke(
+      {
+        messages: [s]
+      },
+      t
+    );
+    let i = "", l;
+    for (const c of g) {
+      const a = B(c.content);
+      a.text && (i += `${a.text}
+`), a.sharedStatePatch && (l = {
+        ...l,
+        ...a.sharedStatePatch
+      });
+    }
+    return await h({ text: `导航工具执行完成：${i}` }, t), {
+      ...e,
+      outputMessage: i,
+      sharedStatePatch: l,
+      status: "success",
+      summary: i ? j(i) : "导航已执行。",
+      navigationInternalState: {
+        ...e.navigationInternalState,
+        toolCallMessage: void 0
+      }
+    };
+  } catch (s) {
+    const g = s instanceof Error ? s.message : String(s);
+    return await h({ text: `导航工具执行失败：${g}` }, t), {
+      ...e,
+      outputMessage: `导航工具执行失败：${g}`,
+      status: "failed",
+      summary: `导航工具执行失败：${g}`,
+      navigationInternalState: {
+        ...e.navigationInternalState,
+        toolCallMessage: void 0
+      }
+    };
+  }
+}
+async function J(e, t) {
+  const o = await T("navigation_intent_prompt"), { mapView: s } = k(t), g = S.map((n) => ({
+    name: n.name,
+    description: n.description,
+    schema: n.schema
+  })), l = s.map.bookmarks?.map((n) => n.name).filter(Boolean) ?? [], c = l.length ? `可用书签：
+${l.map((n) => `- ${n}`).join(`
+`)}` : "当前地图没有可用书签。", a = {
+    tools: g.map(({ name: n, description: m, schema: v }) => `${n}: ${m}, ${JSON.stringify(v)}`).join(`
+`),
+    bookmarks: c,
+    assignedTask: e.agentExecutionContext.assignedTask,
+    userRequest: e.agentExecutionContext.userRequest,
+    priorSteps: e.agentExecutionContext.priorSteps
+  }, r = x.object({
+    intent: x.string()
+  }), d = await z({
+    promptText: o,
+    config: t,
+    inputVariables: a,
+    schema: r,
+    modelTier: "fast"
+  }), y = typeof d.intent == "string" ? d.intent.trim().replace(/^"|"$/gu, "") : "";
+  return { ...e, intent: y || "" };
+}
+const H = 0.5, U = async (e, t) => {
+  try {
+    await h(
+      { text: `正在通过相似度搜索图层：${e.agentExecutionContext.assignedTask}` },
+      t
+    );
+    const o = u(t, "layerSearch"), s = u(t, "layersAndFieldsRegistry"), g = u(t, "embeddingCache"), l = (await o.searchLayers({
+      text: e.agentExecutionContext.assignedTask,
+      minScore: H,
+      embeddingCache: g
+    })).map(({ id: a, score: r }) => {
+      const d = s.get(a)?.layerItem;
+      return {
+        id: a,
+        title: d?.title,
+        name: d?.name ?? void 0,
+        score: r
+      };
+    });
+    let c;
+    return l.length > 0 ? c = `向量搜索完成，匹配图层：
+${l.map((a) => `- layerId=${a.id} | title=${a.title ?? ""} | name=${a.name ?? ""} | score=${a.score.toFixed(2)}`).join(`
+`)}` : c = "向量搜索完成，未找到匹配图层。", await h({ text: c }, t), {
+      ...e,
+      vectorSearchLayerResults: l
+    };
+  } catch (o) {
+    throw await h(
+      { text: `图层向量搜索出错：${o instanceof Error ? o.message : String(o)}` },
+      t
+    ), o;
+  }
+}, f = 0.5, W = 10, K = async (e, t) => {
+  try {
+    await h(
+      { text: `正在通过相似度搜索字段：${e.agentExecutionContext.assignedTask}` },
+      t
+    );
+    const o = u(t, "fieldSearch"), s = u(t, "layersAndFieldsRegistry"), g = u(t, "embeddingCache"), i = e.vectorSearchLayerResults?.map((r) => r.id) ?? [];
+    if (i.length === 0)
+      return await h({ text: "没有可用于字段搜索的候选图层" }, t), e;
+    const c = (await o.searchFields({
+      text: e.agentExecutionContext.assignedTask,
+      layerIds: i,
+      minScore: f,
+      topResults: W,
+      embeddingCache: g
+    })).map(({ layerId: r, results: d }) => {
+      const y = s.get(r)?.fieldRegistry;
+      return {
+        layerId: r,
+        layerName: s.get(r)?.layerItem.name,
+        results: d.map((n) => {
+          const m = y?.get(n.name);
+          return {
+            name: n.name,
+            score: n.score,
+            type: m?.type,
+            alias: m?.alias,
+            description: m?.description,
+            statistics: m?.statistics
+          };
+        })
+      };
+    });
+    let a;
+    return c.length > 0 ? a = `向量搜索完成，匹配图层和字段：
+${c.map(
+      (r) => `${r.layerName ?? r.layerId}:
+${r.results.map((d) => `  - ${d.name} (${d.score.toFixed(2)})`).join(`
+`)}`
+    ).join(`
+`)}` : a = `未找到得分超过以下阈值的字段：${f}.`, await h({ text: a }, t), {
+      ...e,
+      vectorSearchFieldResults: c
+    };
+  } catch (o) {
+    throw await h(
+      { text: `字段向量搜索出错：${o instanceof Error ? o.message : String(o)}` },
+      t
+    ), o;
+  }
+}, Q = (e, t) => P(["layerSearch", "layersAndFieldsRegistry"], "导航 Agent")(e, t), X = () => new E(w).addNode("requireNavigationServices", Q).addNode("intentLLM", J).addNode("vectorSearchLayers", U).addNode("vectorSearchFields", K).addNode("agent", O).addNode("tools", D).addEdge($, "requireNavigationServices").addEdge("requireNavigationServices", "intentLLM").addConditionalEdges(
+  "intentLLM",
+  (t) => t.intent === "goToLayer" || t.intent === "goToFeatures" ? "vectorSearchLayers" : "agent",
+  {
+    vectorSearchLayers: "vectorSearchLayers",
+    agent: "agent"
+  }
+).addConditionalEdges(
+  "vectorSearchLayers",
+  (t) => t.intent === "goToFeatures" ? "vectorSearchFields" : "agent",
+  {
+    vectorSearchFields: "vectorSearchFields",
+    agent: "agent"
+  }
+).addEdge("vectorSearchFields", "agent").addEdge("agent", "tools").addEdge("tools", C), Y = String.raw`- **navigation**——通过定位到位置、图层、要素或范围与地图交互，包括缩放、平移、居中、地理编码，处理用户明确的地图移动请求。
+注意：用户说“显示……”时，不要调用此 Agent，应由其他 Agent 处理；询问地址位置时调用此 Agent。
+
+支持操作：
+- 缩放：调整缩放级别，例如“缩放到10级”“放大”。
+- 视点：定位到中心点，可指定 zoom 或 scale，例如“以旧金山为中心缩放到16级”。
+- 比例尺：例如“设置比例尺为1:50,000”。
+- 图层：缩放到指定图层完整范围。对链接图范围或其中实体的定位，应对链接图图层使用 goToLayer。
+- 要素：定位到图层中符合过滤条件的要素，例如“定位到城市中全部学校”。
+- 书签：定位到预设书签范围，例如“前往 Downtown 书签”。
+- 范围：返回初始范围或全球范围，例如“重置地图”“缩放到全球”。
+- 地址：定位到地址或地名，例如“定位到1600 Pennsylvania Ave”。
+
+示例：“缩放到 Texas”“前往供水管线图层”“定位到链接图范围”“以 San Francisco 为中心，比例尺50000”“定位到学校图层中 city = 'Austin' 的要素”“前往 Downtown 书签”“Mount Rainier 在哪里”。`, ve = {
+  id: "navigation",
+  name: "导航 Agent",
+  description: Y,
+  createGraph: X,
+  workspace: w
+};
+export {
+  ve as N
+};

package/dist/chunks/navigation_intent_prompt.js

@@ -0,0 +1,49 @@
+/* COPYRIGHT GeoScene - https://js.geoscene.cn/5.1/LICENSE.txt */
+const e = `## 导航 Agent——工具意图分类器
+
+你负责识别导航 Agent 所分配任务的意图。
+
+可选工具：
+{tools}
+
+书签：{bookmarks}
+
+分配的任务：
+{assignedTask}
+
+用户最新请求：
+{userRequest}
+
+之前的步骤：
+{priorSteps}
+
+以分配的任务作为主要指令，这里不会再次重复问题。
+需要时，将用户最新请求作为辅助上下文。
+只有分配的任务明确依赖之前的结果时，才参考之前的步骤。
+
+根据任务只返回一个意图，即工具名称。
+没有适用工具时，返回空字符串。
+只能从提供的工具中选择。
+
+## 注意
+
+多个工具均适用时，按以下顺序优先选择：
+1. 书签（如存在）。
+2. 要素（如存在）。
+3. 地理编码或地址。
+
+例如“优胜美地国家公园在哪里”：
+- 如果地图有该公园的书签，优先使用书签。
+- 没有书签但地图有国家公园图层，优先使用要素。
+- 两者都没有时，进行地理编码并定位到地址。
+
+补充规则：
+- “缩放或前往某图层”且没有过滤条件：优先 \`goToLayer\`。
+- “缩放或前往满足某条件的要素”：优先 \`goToFeatures\`。
+- 明确给出缩放级别、比例尺或视点数值：选择对应工具。
+
+将工具名称作为字符串返回。
+`;
+export {
+  e as default
+};

package/dist/chunks/navigation_tool_prompt.js

@@ -0,0 +1,38 @@
+/* COPYRIGHT GeoScene - https://js.geoscene.cn/5.1/LICENSE.txt */
+const e = `# 导航工具调用要求
+
+关键限制：禁止多次调用工具，必须且只能调用一个工具。
+
+分配的任务：
+{assignedTask}
+
+用户最新请求：
+{userRequest}
+
+之前的步骤：
+{priorSteps}
+
+以分配的任务作为主要指令，这里不会再次重复问题。
+需要时，将用户最新请求作为辅助上下文。
+只有分配的任务明确依赖之前的结果时，才参考之前的步骤。
+
+识别到的意图：
+{intent}
+
+{bookmarksSection}
+
+{layersSection}
+
+{fieldsSection}
+
+当前缩放级别：{currentZoom}
+
+规则：
+- 只调用一个导航工具。
+- 如果提供了 layerIds 和字段，只能使用提供的值。
+- 不得虚构 layerIds 或字段名。
+- 缺少必要上下文时，退回到一个有效且不依赖图层的工具。
+`;
+export {
+  e as default
+};