vue-agent-start 0.1.0

package/src/agent-flow/workflow/utils/node_card_form.ts

@@ -0,0 +1,335 @@
+/**
+ * Per-node default `data` shape, keyed by the SAME identifier the FlowDesigner
+ * registers its `#node-XXX` slot under and stores on `node.type`. Aligned with
+ * the backend `NodeType` enum (UPPER_SNAKE) so a saved graph round-trips
+ * cleanly — no adapter translation needed between the designer and the engine.
+ *
+ * Designer-only entries with no backend {@code NodeType} equivalent
+ * ({@code USER_INPUT}, {@code FILE_UPLOAD}, {@code HUMAN_INPUT}, {@code LOOP})
+ * still use the UPPER_SNAKE convention for consistency; the backend's
+ * {@code NodeType.fromJson} maps them onto the closest engine node at run
+ * time (USER_INPUT/FILE_UPLOAD/HUMAN_INPUT → START, LOOP → ITERATION).
+ */
+const nodeCardForm: any = {
+  START: {
+    variables: [],
+    sysVariables: [
+      { name: 'query', type: 'String', required: true },
+      { name: 'files', type: 'Array[File]' },
+      { name: 'dialogue_count', type: 'Number' },
+      { name: 'conversation_id', type: 'String' },
+      { name: 'user_id', type: 'String' },
+      { name: 'app_id', type: 'String' },
+      { name: 'workflow_id', type: 'String' },
+      { name: 'workflow_run_id', type: 'String' },
+    ],
+    triggers: {},
+    triggersEnabled: false,
+    structOutput: {
+      schema: {},
+      data: [
+        {
+          id: '0',
+          type: 'object',
+          name: 'triggers',
+          value: '',
+          description: '触发器输出',
+          hidden: true,
+          children: [],
+        },
+      ],
+    },
+    output: [{ type: 'string', name: 'query', value: '', label: '用户查询' }],
+  },
+  ANSWER: {
+    answer: '',
+  },
+  AGENT: {
+    modelId: '',
+    context: '',
+    system: '',
+    selectOptions: [],
+    required: false,
+    memory: {
+      window: {
+        enabled: true,
+        size: 10,
+        user: '0',
+        assistant: '0',
+      },
+    },
+    model: {
+      completionParams: {},
+      modelId: 'chat',
+    },
+    systemPrompt: {
+      id: 'prompt_template',
+      role: 'system',
+      text: '',
+    },
+    userPrompt: {
+      id: 'user_prompt_template',
+      role: 'user',
+      text: '用户查询：{{#var.query#}}',
+    },
+    tools: [],
+    agentParameters: {},
+    output: [
+      { type: 'string', name: 'text', value: '', label: '生成内容' },
+      { type: 'file', name: 'file', value: null, label: '生成文件' },
+      { type: 'object', name: 'json', value: {}, label: '生成Json' },
+    ],
+  },
+  LLM: {
+    temperature: 0.7,
+    max_tokens: 1000,
+    prompt: '',
+    model: {
+      completionParams: {},
+      modeId: '',
+      mode: 'chat',
+    },
+    systemPrompt: {
+      id: 'prompt_template',
+      role: 'system',
+      text: '',
+    },
+    userPrompt: {
+      id: 'user_prompt_template',
+      role: 'user',
+      text: '用户查询：{{#var.query#}}',
+    },
+    memory: {
+      query_prompt_template: '{{#sys.query#}}',
+      role_prefix: {
+        assistant: '',
+        user: '',
+      },
+      window: {
+        enabled: true,
+        size: 10,
+        user: '0',
+        assistant: '0',
+      },
+    },
+    structOutputEnabled: false,
+    structOutput: {
+      schema: {},
+      data: [
+        {
+          id: '0',
+          type: 'object',
+          name: 'struct',
+          value: '',
+          description: '结构化内容',
+          hidden: true,
+          children: [],
+        },
+      ],
+    },
+    output: [{ type: 'string', name: 'text', value: '', label: '生成内容' }],
+  },
+  QUESTION_CLASSIFIER: {
+    categories: ['正面', '负面', '中性'],
+    model: {
+      completionParams: {},
+      modeId: '',
+      mode: 'chat',
+    },
+    classes: [
+      {
+        id: 1,
+        name: '',
+      },
+    ],
+  },
+  IF_ELSE: {
+    cases: [],
+    output: {},
+  },
+
+  CODE: {
+    modelId: '',
+    context: '',
+    system: '',
+    variables: [],
+    selectOptions: [],
+    required: false,
+    memory: { windows: 1 },
+    code_language: 'python',
+    code: '\ndef main(arg1: str, arg2: str) -> dict:\n    return {\n        "result": arg1 + arg2,\n    }\n',
+  },
+  KNOWLEDGE_RETRIEVAL: {
+    label: '知识检索',
+    description: '知识库检索节点',
+    queryVariableSelector: [],
+    required: false,
+    memory: { windows: 1 },
+    metadataFilter: 'disabled',
+    metadataConditions: [{ name: '', value: '', operator: 'IS' }],
+    dataset: {
+      useAnnotation: false,
+      dynamic: false,
+      dynamicVariableSelector: [],
+      datasets: [],
+    },
+    output: [
+      {
+        type: 'Array[Object]',
+        name: 'result[]',
+        value: '',
+        label: '召回分段',
+        children: [
+          {
+            type: 'string',
+            name: 'text',
+            value: '',
+            label: '分段内容',
+          },
+          {
+            type: 'object',
+            name: 'metadata',
+            value: '',
+            label: '元数据',
+          },
+        ],
+      },
+    ],
+  },
+  USER_INPUT: {
+    variable: '',
+    required: true,
+  },
+  FILE_UPLOAD: {
+    allowedTypes: ['pdf', 'txt', 'doc'],
+    maxSize: 10,
+  },
+  LOOP: {
+    maxIterations: 10,
+    condition: '',
+  },
+  VARIABLE_AGGREGATOR: {
+    variables: [],
+    operation: 'combine',
+    output: [
+      {
+        type: 'Object',
+        name: 'result',
+        value: '',
+        label: '聚合变量',
+        children: [],
+      },
+    ],
+  },
+  HTTP_REQUEST: {
+    method: 'GET',
+    url: '',
+    timeoutSeconds: 30,
+    maxRetries: 0,
+    authorization: {
+      auth_type: 'none',
+      api_key_header: 'Authorization',
+      api_key_header_prefix: 'bearer',
+      api_key_value: '',
+    },
+    headers: [{ name: '', value: '' }],
+    parameters: [{ name: '', value: '' }],
+    bodyType: 'NONE',
+    body: {
+      NONE: null,
+      BINARY: '',
+      FORM_DATA: [{ name: '', value: '', type: 'TEXT' }],
+      X_WWW_FORM_URLENCODED: [{ name: '', value: '' }],
+      JSON: '',
+      RAW: '',
+    },
+    output: [
+      { type: 'number', name: 'status', value: 0, label: '响应状态码' },
+      { type: 'string', name: 'body', value: '', label: '响应体' },
+      { type: 'object', name: 'headers', value: {}, label: '响应头' },
+    ],
+  },
+  SERVICE_API: {
+    method: 'GET',
+    url: '',
+    timeoutSeconds: 30,
+    headers: [{ name: '', value: '' }],
+    parameters: [{ name: '', value: '' }],
+    output: [
+      { type: 'number', name: 'status', value: 0, label: '响应状态码' },
+      { type: 'string', name: 'body', value: '', label: '响应体' },
+    ],
+  },
+  TEMPLATE_TRANSFORM: {
+    template: '',
+    variables: [],
+  },
+  END: {
+    output: [],
+  },
+  ITERATION: {
+    iteratorVariableSelector: [],
+    outputVariableSelector: [],
+    childrenNodes: [],
+    parallelSize: 1,
+    errorMode: 'terminate',
+    output: [
+      { type: 'array', name: 'result', value: [], label: '迭代结果' },
+    ],
+  },
+  PARAMETER_EXTRACTOR: {
+    parameters: [
+      { name: 'param1', type: 'string', description: '', required: false },
+    ],
+    model: { modelId: '', modelName: '', mode: 'chat', completionParams: {} },
+    reasoning_mode: 'function_call',
+    inputVariableSelector: [],
+    systemPrompt: {
+      id: 'prompt_template',
+      role: 'system',
+      text: '',
+    },
+    output: [
+      { type: 'object', name: 'result', value: {}, label: '抽取结果' },
+    ],
+  },
+  LIST_OPERATOR: {
+    inputVariableSelector: [],
+    operation: 'filter',
+    filterConditions: [],
+    mapExpression: '',
+    offset: 0,
+    limit: 100,
+    sortField: '',
+    sortOrder: 'asc',
+    output: [
+      { type: 'array', name: 'result', value: [], label: '结果列表' },
+    ],
+  },
+  DOCUMENT_EXTRACTOR: {
+    variableSelector: [],
+    extractMode: 'text',
+    splitMode: 'none',
+    chunkSize: 1000,
+    output: [
+      { type: 'string', name: 'text', value: '', label: '提取文本' },
+    ],
+  },
+  HUMAN_INPUT: {
+    approvalType: 'approve',
+    prompt: '请审批以下内容',
+    formFields: [],
+    timeout: 3600,
+    output: [
+      { type: 'string', name: 'response', value: '', label: '人工响应' },
+      { type: 'boolean', name: 'approved', value: false, label: '是否批准' },
+    ],
+  },
+  VARIABLE_ASSIGNER: {
+    assignments: [
+      { target: '', source: [], writeMode: 'overwrite' },
+    ],
+    output: [],
+  },
+};
+export default nodeCardForm;

package/src/agent-flow/workflow/utils/node_config.ts

@@ -0,0 +1,63 @@
+/**
+ * 节点元数据目录 —— 内置节点的清单
+ *
+ * 对外通过默认导出。宿主项目可以：
+ *   - 直接读取本清单渲染扩展面板
+ *   - 通过 `.concat(...)` 追加自己的节点条目
+ *
+ * {@link NodeCatalogItem.type} 与 backend `spring-agent-workflow` 的
+ * {@code NodeType} 枚举一致（UPPER_SNAKE），也是 FlowDesigner 里
+ * `<template #node-{type}>` 注册的 slot 名 —— 单一标识贯穿画布、持久化、
+ * 引擎执行三层。设计器独有的类型（USER_INPUT / FILE_UPLOAD / HUMAN_INPUT /
+ * LOOP）没有严格对应的 backend NodeType，backend 的
+ * {@code NodeType.fromJson} 会把它们映射到最接近的引擎节点（前三者 → START，
+ * LOOP → ITERATION），使得设计器保存的图仍能跑起来。
+ */
+
+export interface NodeCatalogItem {
+  /**
+   * 唯一标识 —— 同时是 VueFlow slot 名和 backend `NodeType` 枚举名，
+   * 保证画布 / 存储 / 引擎三处对齐。
+   */
+  type: string;
+  name: string;
+  icon: string;
+  category: '输入' | 'AI 模型' | '逻辑' | '工具' | '输出' | '其他';
+  description?: string;
+}
+
+const nodeItems: NodeCatalogItem[] = [
+  // 输入
+  { type: 'START', name: '开始', icon: 'start', category: '输入' },
+  { type: 'USER_INPUT', name: '用户输入', icon: 'user', category: '输入' },
+  { type: 'FILE_UPLOAD', name: '文件上传', icon: 'file', category: '输入' },
+
+  // AI 模型
+  { type: 'LLM', name: 'LLM', icon: 'llm', category: 'AI 模型' },
+  { type: 'AGENT', name: 'Agent', icon: 'agent', category: 'AI 模型' },
+  { type: 'KNOWLEDGE_RETRIEVAL', name: '知识检索', icon: 'knowledge', category: 'AI 模型' },
+  { type: 'QUESTION_CLASSIFIER', name: '问题分类', icon: 'classifier', category: 'AI 模型' },
+
+  // 逻辑
+  { type: 'IF_ELSE', name: '条件分支', icon: 'condition', category: '逻辑' },
+  { type: 'LOOP', name: '循环', icon: 'loop', category: '逻辑' },
+  { type: 'ITERATION', name: '迭代', icon: 'loop', category: '逻辑' },
+  { type: 'LIST_OPERATOR', name: '列表操作', icon: 'variable', category: '逻辑' },
+  { type: 'VARIABLE_AGGREGATOR', name: '变量聚合', icon: 'variable', category: '逻辑' },
+  { type: 'VARIABLE_ASSIGNER', name: '变量赋值', icon: 'variable', category: '逻辑' },
+  { type: 'PARAMETER_EXTRACTOR', name: '参数提取', icon: 'variable', category: '逻辑' },
+  { type: 'HUMAN_INPUT', name: '人工介入', icon: 'user', category: '逻辑' },
+
+  // 工具
+  { type: 'HTTP_REQUEST', name: 'HTTP 请求', icon: 'http', category: '工具' },
+  { type: 'SERVICE_API', name: '服务接口', icon: 'service', category: '工具' },
+  { type: 'CODE', name: '代码执行', icon: 'code', category: '工具' },
+  { type: 'TEMPLATE_TRANSFORM', name: '模板转换', icon: 'template', category: '工具' },
+  { type: 'DOCUMENT_EXTRACTOR', name: '文档提取', icon: 'file', category: '工具' },
+
+  // 输出
+  { type: 'ANSWER', name: '直接回复', icon: 'answer', category: '输出' },
+  { type: 'END', name: '结束', icon: 'end', category: '输出' },
+];
+
+export default nodeItems;

package/src/agent-flow/workflow/utils/workflow_utils.ts

@@ -0,0 +1,151 @@
+import { useWorkflowStore } from '@/stores/workflow';
+import langUtils from '@/utils/langUtils';
+import nodeCardForm from '@/workflow/utils/node_card_form';
+
+const workflowStore = useWorkflowStore();
+export default {
+  conditionOperators: [
+    { value: 'CONTAINS', label: '包含' },
+    { value: 'NOT_CONTAINS', label: '不包含' },
+    { value: 'STARTS_WITH', label: '开始是' },
+    { value: 'ENDS_WITH', label: '结束是' },
+    { value: 'IS', label: '是' },
+    { value: 'IS_NOT', label: '不是' },
+    { value: 'IS_EMPTY', label: '为空' },
+    { value: 'IS_NOT_EMPTY', label: '不为空' },
+  ],
+  agentStrategy: [
+    { value: 'AGENT_REACT', label: 'Agent React' },
+    { value: 'AGENT_FUNCTION_CALLING', label: 'Agent Function Calling' },
+    { value: 'MCP_FUNCTION_CALLING', label: 'Mcp Function Calling' },
+  ],
+  getOperator(value: string) {
+    for (const it of this.conditionOperators) {
+      if (it.value === value) {
+        return it.label;
+      }
+    }
+  },
+  initNodeDefaultData: (nodes: any) => {
+    function deepMerge(obj1: any, obj2: any) {
+      const result = { ...obj1 };
+
+      for (const key in obj2) {
+        if (Object.prototype.hasOwnProperty.call(obj2, key)) {
+          result[key] =
+            typeof obj2[key] === 'object' &&
+            obj2[key] !== null &&
+            !Array.isArray(obj2[key])
+              ? deepMerge(obj1[key] || {}, obj2[key])
+              : obj2[key];
+        }
+      }
+
+      return result;
+    }
+
+    if (nodes && nodes.length > 0) {
+      for (const node of nodes) {
+        const configFormData = nodeCardForm[node.type];
+        const nodeData = node.data;
+        const configData = langUtils.clone(configFormData);
+        nodeData.id = node.id;
+        // nodeData.structOutput = undefined;
+        nodeData.headers = undefined;
+        const newData = deepMerge(configData, nodeData);
+        Object.assign(node.data, newData);
+      }
+    }
+  },
+  getOutputItem(data: any, name: string) {
+    const outputList = this.getOutputList(data);
+    const findRecursively = (items: any[]): any => {
+      if (!items) {
+        return [];
+      }
+      for (const item of items) {
+        if (item.name === name) {
+          return item;
+        }
+        if (item.children && Array.isArray(item.children)) {
+          const found = findRecursively(item.children);
+          if (found) return found;
+        }
+      }
+      return undefined;
+    };
+
+    return findRecursively(outputList);
+  },
+  getOutputList: (data: any) => {
+    const outputList = [];
+    if (!data) {
+      return [];
+    }
+
+    if (data.structOutput && data.structOutputEnabled) {
+      outputList.push(...data.structOutput?.data);
+    } else if (data.output && Array.isArray(data.output)) {
+      outputList.push(...data.output);
+    }
+    if (data.triggersEnabled) {
+      outputList.push(...data.structOutput?.data);
+    }
+    if (data.id === '1') {
+      outputList.push(...data.variables);
+    }
+    return outputList;
+  },
+  getVariableLabel(variableSelector: any[]) {
+    if (!variableSelector || variableSelector.length === 0) {
+      return '';
+    }
+    const list = variableSelector;
+    const node = workflowStore.getNodeById(list[0]);
+    const labels = [];
+    if (node && node.data) {
+      labels.push(node.data.label);
+    }
+    for (let i = 1; i < list.length; i++) {
+      const v = list[i];
+      const item = this.getOutputItem(node.data, v);
+      if (item) {
+        labels.push(item.label || item.description);
+      }
+    }
+    return labels.join('.');
+  },
+  splitExpressions(input: string) {
+    const result: any[] = [];
+    if (!input) {
+      return result;
+    }
+
+    // 定义匹配 {{#...#}} 格式的正则表达式
+    const pattern = /\{\{#.*?#\}\}/g;
+    let lastEnd = 0;
+    let match;
+
+    while ((match = pattern.exec(input)) !== null) {
+      // 添加表达式左侧的文本
+      const left = input.substring(lastEnd, match.index);
+      if (left) {
+        result.push(left);
+      }
+
+      // 添加表达式本身
+      const expression = match[0];
+      result.push(expression);
+
+      lastEnd = pattern.lastIndex;
+    }
+
+    // 添加最后一个表达式右侧的剩余文本
+    const right = input.slice(Math.max(0, lastEnd));
+    if (right) {
+      result.push(right);
+    }
+
+    return result;
+  },
+};