feat: add toolDescription field across various schemas and update related functions (#5452)

Author: ctrlz526

packages/global/core/workflow/runtime/type.d.ts

@@ -101,6 +101,7 @@ export type RuntimeNodeItemType = {
   name: StoreNodeItemType['name'];
   avatar: StoreNodeItemType['avatar'];
   intro?: StoreNodeItemType['intro'];
+  toolDescription?: StoreNodeItemType['toolDescription'];
   flowNodeType: StoreNodeItemType['flowNodeType'];
   showStatus?: StoreNodeItemType['showStatus'];
   isEntry?: boolean;

packages/global/core/workflow/runtime/utils.ts

@@ -252,6 +252,7 @@ export const storeNodes2RuntimeNodes = (
         name: node.name,
         avatar: node.avatar,
         intro: node.intro,
+        toolDescription: node.toolDescription,
         flowNodeType: node.flowNodeType,
         showStatus: node.showStatus,
         isEntry: entryNodeIds.includes(node.nodeId),

packages/global/core/workflow/type/index.d.ts

@@ -37,6 +37,7 @@ export type WorkflowTemplateType = {
   avatar: string;
   name: I18nStringType | string;
   intro?: I18nStringType | string;
+  toolDescription?: string;
 
   author?: string;
   courseUrl?: string;

packages/global/core/workflow/type/node.d.ts

@@ -56,6 +56,7 @@ export type FlowNodeCommonType = {
   avatar?: string;
   name: string;
   intro?: string; // template list intro
+  toolDescription?: string;
   showStatus?: boolean; // chatting response step status
 
   version?: string;

packages/service/core/app/plugin/controller.ts

@@ -314,7 +314,11 @@ export async function getChildAppPreviewNode({
                       }))
                   }
                 }
-              : { systemTool: { toolId: app.id } })
+              : {
+                  systemTool: {
+                    toolId: app.id
+                  }
+                })
           },
           showSourceHandle: app.isFolder ? false : true,
           showTargetHandle: app.isFolder ? false : true
@@ -368,6 +372,7 @@ export async function getChildAppPreviewNode({
     avatar: app.avatar,
     name: parseI18nString(app.name, lang),
     intro: parseI18nString(app.intro, lang),
+    toolDescription: app.toolDescription,
     courseUrl: app.courseUrl,
     userGuide: app.userGuide,
     showStatus: true,
@@ -462,8 +467,17 @@ export async function getChildAppRuntimeById({
 }
 
 const dbPluginFormat = (item: SystemPluginConfigSchemaType): SystemPluginTemplateItemType => {
-  const { name, avatar, intro, version, weight, templateType, associatedPluginId, userGuide } =
-    item.customConfig!;
+  const {
+    name,
+    avatar,
+    intro,
+    toolDescription,
+    version,
+    weight,
+    templateType,
+    associatedPluginId,
+    userGuide
+  } = item.customConfig!;
 
   return {
     id: item.pluginId,
@@ -475,6 +489,7 @@ const dbPluginFormat = (item: SystemPluginConfigSchemaType): SystemPluginTemplat
     name,
     avatar,
     intro,
+    toolDescription,
     weight,
     templateType,
     originCost: item.originCost,
@@ -556,6 +571,7 @@ export const getSystemTools = async (): Promise<SystemPluginTemplateItemType[]>
         name: item.name,
         avatar: item.avatar,
         intro: item.description,
+        toolDescription: item.toolDescription,
         author: item.author,
         courseUrl: item.courseUrl,
         instructions: dbPluginConfig?.customConfig?.userGuide,

packages/service/core/app/plugin/type.d.ts

@@ -17,6 +17,7 @@ export type SystemPluginConfigSchemaType = {
     name: string;
     avatar: string;
     intro?: string;
+    toolDescription?: string;
     version: string;
     weight?: number;
     templateType: string;

packages/service/core/workflow/dispatch/ai/agent/functionCall.ts

@@ -189,7 +189,7 @@ export const runToolWithFunctionCall = async (
 
     return {
       name: item.nodeId,
-      description: item.intro,
+      description: item.toolDescription || item.intro,
       parameters: {
         type: 'object',
         properties,

packages/service/core/workflow/dispatch/ai/agent/promptCall.ts

@@ -193,7 +193,7 @@ export const runToolWithPromptCall = async (
 
       return {
         toolId: item.nodeId,
-        description: item.intro,
+        description: item.toolDescription || item.intro,
         parameters: {
           type: 'object',
           properties,

packages/service/core/workflow/dispatch/ai/agent/toolChoice.ts

@@ -246,7 +246,7 @@ export const runToolWithToolChoice = async (
       type: 'function',
       function: {
         name: item.nodeId,
-        description: item.intro || item.name,
+        description: item.toolDescription || item.intro || item.name,
         parameters: {
           type: 'object',
           properties,

packages/service/package.json

@@ -3,7 +3,7 @@
   "version": "1.0.0",
   "type": "module",
   "dependencies": {
-    "@fastgpt-sdk/plugin": "^0.1.8",
+    "@fastgpt-sdk/plugin": "^0.1.9",
     "@fastgpt/global": "workspace:*",
     "@modelcontextprotocol/sdk": "^1.12.1",
     "@node-rs/jieba": "2.0.1",