支持插件 API routing 结构化配置

src/api/agents.ts

@@ -33,6 +33,12 @@ export interface SkillDetail extends SkillBrief {
   config: string;
 }
 
+export interface ExternalToolApiRouting {
+  summary: string;
+  useWhen: string[];
+  doNotUseWhen?: string[];
+}
+
 export interface ExternalToolApi {
   id?: string;
   name: string;
@@ -41,6 +47,7 @@ export interface ExternalToolApi {
   path: string;
   headers?: Record<string, string> | null;
   parametersSchema: Record<string, unknown>;
+  routing: ExternalToolApiRouting;
   createdAt?: number;
 }
 
@@ -120,4 +127,3 @@ export const AgentAPI = {
   deletePlugin: (agentId: string, pluginId: string) =>
     api.delete(`/agents/${agentId}/plugins/${pluginId}`).then((r) => r.data)
 };
-

src/components/ExternalToolEditor.tsx

@@ -1,6 +1,6 @@
 import { CopyOutlined, MinusCircleOutlined, PlusOutlined } from '@ant-design/icons';
 import { App as AntApp, Button, Card, Form, Input, Modal, Select, Space } from 'antd';
-import { AgentAPI, ExternalToolApi, ExternalToolPlugin, ExternalToolPluginPayload } from '../api';
+import { AgentAPI, ExternalToolApi, ExternalToolApiRouting, ExternalToolPlugin, ExternalToolPluginPayload } from '../api';
 
 interface Props {
   open: boolean;
@@ -10,9 +10,12 @@ interface Props {
   onSaved?: () => void | Promise<void>;
 }
 
-interface ToolApiFormValue extends Omit<ExternalToolApi, 'headers' | 'parametersSchema'> {
+interface ToolApiRoutingFormValue extends ExternalToolApiRouting {}
+
+interface ToolApiFormValue extends Omit<ExternalToolApi, 'headers' | 'parametersSchema' | 'routing'> {
   headers?: string;
   parametersSchema: string;
+  routing: ToolApiRoutingFormValue;
 }
 
 interface ToolPluginFormValue extends Omit<ExternalToolPluginPayload, 'authConfig' | 'apis'> {
@@ -27,6 +30,11 @@ const EMPTY_API: ToolApiFormValue = {
   path: '',
   headers: '{}',
   parametersSchema: JSON.stringify({ type: 'object', properties: {} }, null, 2),
+  routing: {
+    summary: '',
+    useWhen: [''],
+    doNotUseWhen: [],
+  },
 };
 
 function parseJsonObject(value: string | undefined, fieldName: string, optional = false) {
@@ -83,6 +91,53 @@ function parseJsonObject(value: string | undefined, fieldName: string, optional
   }
 }
 
+function normalizeStringList(values?: string[]) {
+  return Array.from(new Set((values ?? []).map((item) => item?.trim()).filter((item): item is string => Boolean(item))));
+}
+
+function validateTrimmedText(message: string) {
+  return async (_: unknown, value: string | undefined) => {
+    if (!value?.trim()) {
+      throw new Error(message);
+    }
+  };
+}
+
+function validateRoutingList(message: string, min = 0) {
+  return async (_: unknown, value: string[] | undefined) => {
+    const normalized = normalizeStringList(value);
+    if (normalized.length < min) {
+      throw new Error(message);
+    }
+
+    if ((value ?? []).some((item) => !item?.trim())) {
+      throw new Error('列表项不能为空');
+    }
+  };
+}
+
+function normalizeRouting(value: ToolApiRoutingFormValue | undefined, apiName: string): ExternalToolApiRouting {
+  if (!value) {
+    throw new Error(`API ${apiName} 的路由规则不能为空`);
+  }
+
+  const summary = value.summary?.trim();
+  if (!summary) {
+    throw new Error(`API ${apiName} 的路由摘要不能为空`);
+  }
+
+  const useWhen = normalizeStringList(value.useWhen);
+  if (useWhen.length < 1) {
+    throw new Error(`API ${apiName} 的 useWhen 至少保留一项`);
+  }
+
+  return {
+    summary,
+    useWhen,
+    doNotUseWhen: normalizeStringList(value.doNotUseWhen),
+  };
+}
+
 export default function ExternalToolEditor({ open, agentId, plugin, onClose, onSaved }: Props) {
   const { message } = AntApp.useApp();
   const [form] = Form.useForm<ToolPluginFormValue>();
@@ -104,6 +159,7 @@ export default function ExternalToolEditor({ open, agentId, plugin, onClose, onS
           path: item.path.trim(),
           headers: parseJsonObject(item.headers, `API ${item.name} 的请求头`, true),
           parametersSchema: parseJsonObject(item.parametersSchema, `API ${item.name} 的依赖参数`),
+          routing: normalizeRouting(item.routing, item.name.trim() || '未命名 API'),
         })),
       };
 
@@ -153,6 +209,11 @@ export default function ExternalToolEditor({ open, agentId, plugin, onClose, onS
                     path: item.path,
                     headers: JSON.stringify(item.headers || {}, null, 2),
                     parametersSchema: JSON.stringify(item.parametersSchema || { type: 'object', properties: {} }, null, 2),
+                    routing: {
+                      summary: item.routing?.summary || '',
+                      useWhen: item.routing?.useWhen?.length ? item.routing.useWhen : [''],
+                      doNotUseWhen: item.routing?.doNotUseWhen || [],
+                    },
                   })),
                 }
               : {
@@ -259,11 +320,15 @@ export default function ExternalToolEditor({ open, agentId, plugin, onClose, onS
                   <Form.Item
                     label="description（描述）"
                     name={[field.name, 'description']}
-                    rules={[{ required: true, message: '请输入描述' }]}
+                    rules={[{ validator: validateTrimmedText('请输入描述') }]}
                   >
                     <Input.TextArea rows={2} placeholder="描述调用时机和工具能力" />
                   </Form.Item>
-                  <Form.Item label="path（API 地址）" name={[field.name, 'path']} rules={[{ required: true, message: '请输入 API 地址' }]}>
+                  <Form.Item
+                    label="path（API 地址）"
+                    name={[field.name, 'path']}
+                    rules={[{ validator: validateTrimmedText('请输入 API 地址') }]}
+                  >
                     <Input placeholder="/v1/products/hot-selling" />
                   </Form.Item>
                   <div className="agent-editor-tool-grid">
@@ -278,6 +343,77 @@ export default function ExternalToolEditor({ open, agentId, plugin, onClose, onS
                       <Input.TextArea rows={7} className="agent-editor-code-input" />
                     </Form.Item>
                   </div>
+                  <Card size="small" title="routing（路由规则）">
+                    <Form.Item
+                      label="summary"
+                      name={[field.name, 'routing', 'summary']}
+                      rules={[{ validator: validateTrimmedText('请输入路由摘要') }]}
+                    >
+                      <Input placeholder="查询商品维度数据" />
+                    </Form.Item>
+                    <Form.List name={[field.name, 'routing', 'useWhen']} rules={[{ validator: validateRoutingList('至少添加一条 useWhen', 1) }]}>
+                      {(routingFields, { add: addUseWhen, remove: removeUseWhen }, { errors }) => (
+                        <Space direction="vertical" size={8} className="agent-editor-tool-list">
+                          <div className="agent-editor-tool-list-header">
+                            <div>
+                              <strong>useWhen</strong>
+                              <div className="agent-editor-tool-help">至少一项，描述什么情况下应该调用这个 API。</div>
+                            </div>
+                            <Button type="dashed" icon={<PlusOutlined />} onClick={() => addUseWhen('')}>
+                              添加条件
+                            </Button>
+                          </div>
+                          {routingFields.map((routingField) => (
+                            <Space key={routingField.key} align="start" className="agent-editor-tool-list">
+                              <Form.Item
+                                name={routingField.name}
+                                className="flex-1 mb-0"
+                                rules={[{ validator: validateTrimmedText('条件不能为空') }]}
+                              >
+                                <Input placeholder="用户明确要求商品数据" />
+                              </Form.Item>
+                              <Button
+                                danger
+                                type="text"
+                                icon={<MinusCircleOutlined />}
+                                onClick={() => removeUseWhen(routingField.name)}
+                                disabled={routingFields.length <= 1}
+                              />
+                            </Space>
+                          ))}
+                          <Form.ErrorList errors={errors} />
+                        </Space>
+                      )}
+                    </Form.List>
+                    <Form.List name={[field.name, 'routing', 'doNotUseWhen']} rules={[{ validator: validateRoutingList('列表项不能为空') }]}>
+                      {(routingFields, { add: addDoNotUseWhen, remove: removeDoNotUseWhen }, { errors }) => (
+                        <Space direction="vertical" size={8} className="agent-editor-tool-list" style={{ marginTop: 16 }}>
+                          <div className="agent-editor-tool-list-header">
+                            <div>
+                              <strong>doNotUseWhen</strong>
+                              <div className="agent-editor-tool-help">可为空，描述什么情况下不要调用这个 API。</div>
+                            </div>
+                            <Button type="dashed" icon={<PlusOutlined />} onClick={() => addDoNotUseWhen('')}>
+                              添加条件
+                            </Button>
+                          </div>
+                          {routingFields.map((routingField) => (
+                            <Space key={routingField.key} align="start" className="agent-editor-tool-list">
+                              <Form.Item
+                                name={routingField.name}
+                                className="flex-1 mb-0"
+                                rules={[{ validator: validateTrimmedText('条件不能为空') }]}
+                              >
+                                <Input placeholder="当前问题只需要其他维度数据" />
+                              </Form.Item>
+                              <Button danger type="text" icon={<MinusCircleOutlined />} onClick={() => removeDoNotUseWhen(routingField.name)} />
+                            </Space>
+                          ))}
+                          <Form.ErrorList errors={errors} />
+                        </Space>
+                      )}
+                    </Form.List>
+                  </Card>
                 </Card>
               ))}
             </Space>