✨ ask_user 工具支持结构化选项（单选/多选）

- tool 定义增加 options 和 multiple 参数
- ChatStreamEvent ask_user 事件传递选项字段
- UI 支持 Radio 单选（点击即提交）和 Checkbox 多选（确认提交）
- 所有模式下保留文本输入框供自定义回答
- 新增 2 个单元测试覆盖选项传递

Author: CodFrm

src/app/service/agent/tools/ask_user.test.ts

@@ -77,4 +77,53 @@ describe("ask_user", () => {
     }
     await Promise.all([p1, p2]);
   });
+
+  it("should send options in ask_user event", async () => {
+    const events: ChatStreamEvent[] = [];
+    const sendEvent = (event: ChatStreamEvent) => events.push(event);
+    const resolvers = new Map<string, (answer: string) => void>();
+
+    const { executor } = createAskUserTool(sendEvent, resolvers);
+
+    const resultPromise = executor.execute({
+      question: "Pick a color",
+      options: ["Red", "Blue", "Green"],
+    });
+
+    expect(events).toHaveLength(1);
+    const askEvent = events[0] as Extract<ChatStreamEvent, { type: "ask_user" }>;
+    expect(askEvent.options).toEqual(["Red", "Blue", "Green"]);
+    expect(askEvent.multiple).toBeUndefined();
+
+    // Resolve
+    const [_id, resolve] = Array.from(resolvers.entries())[0];
+    resolve("Blue");
+    const result = JSON.parse((await resultPromise) as string);
+    expect(result).toEqual({ answer: "Blue" });
+  });
+
+  it("should send multiple flag in ask_user event", async () => {
+    const events: ChatStreamEvent[] = [];
+    const sendEvent = (event: ChatStreamEvent) => events.push(event);
+    const resolvers = new Map<string, (answer: string) => void>();
+
+    const { executor } = createAskUserTool(sendEvent, resolvers);
+
+    const resultPromise = executor.execute({
+      question: "Select languages",
+      options: ["JavaScript", "Python", "Rust"],
+      multiple: true,
+    });
+
+    expect(events).toHaveLength(1);
+    const askEvent = events[0] as Extract<ChatStreamEvent, { type: "ask_user" }>;
+    expect(askEvent.options).toEqual(["JavaScript", "Python", "Rust"]);
+    expect(askEvent.multiple).toBe(true);
+
+    // Resolve with multiple selections
+    const [_id, resolve] = Array.from(resolvers.entries())[0];
+    resolve(JSON.stringify(["JavaScript", "Rust"]));
+    const result = JSON.parse((await resultPromise) as string);
+    expect(result).toEqual({ answer: '["JavaScript","Rust"]' });
+  });
 });

src/app/service/agent/tools/ask_user.ts

@@ -4,11 +4,22 @@ import type { ToolExecutor } from "@App/app/service/agent/tool_registry";
 export const ASK_USER_DEFINITION: ToolDefinition = {
   name: "ask_user",
   description:
-    "Ask the user a question and wait for their response. Use this when you need clarification, a decision, or user input before proceeding. The user will see the question in the chat UI and can type a response.",
+    "Ask the user a question and wait for their response (text only, no image support). " +
+    "Use options for structured choices (single/multi-select). Times out after 5 minutes.",
   parameters: {
     type: "object",
     properties: {
       question: { type: "string", description: "The question to ask the user" },
+      options: {
+        type: "array",
+        items: { type: "string" },
+        description:
+          "Optional list of choices for the user. If provided, user selects from these instead of free text input.",
+      },
+      multiple: {
+        type: "boolean",
+        description: "Allow selecting multiple options (default: false, single-select).",
+      },
     },
     required: ["question"],
   },
@@ -30,10 +41,13 @@ export function createAskUserTool(
         throw new Error("question is required");
       }
 
+      const options = args.options as string[] | undefined;
+      const multiple = args.multiple as boolean | undefined;
+
       const askId = `ask_${Date.now()}_${++askCounter}`;
 
       // 通知 UI 显示提问
-      sendEvent({ type: "ask_user", id: askId, question });
+      sendEvent({ type: "ask_user", id: askId, question, options, multiple });
 
       // 等待用户回复
       return new Promise<string>((resolve) => {

src/app/service/agent/types.ts

@@ -91,7 +91,7 @@ export type ChatStreamEvent =
   | { type: "tool_call_complete"; id: string; result: string; attachments?: Attachment[] }
   | { type: "content_block_start"; block: Omit<ImageBlock | FileBlock | AudioBlock, "attachmentId"> }
   | { type: "content_block_complete"; block: ImageBlock | FileBlock | AudioBlock; data?: string }
-  | { type: "ask_user"; id: string; question: string }
+  | { type: "ask_user"; id: string; question: string; options?: string[]; multiple?: boolean }
   | { type: "sub_agent_event"; agentId: string; description: string; event: ChatStreamEvent }
   | { type: "new_message" }
   | {

src/pages/options/routes/AgentChat/AskUserBlock.tsx

@@ -1,17 +1,22 @@
 import { useState, useRef, useEffect } from "react";
-import { Button, Input } from "@arco-design/web-react";
+import { Button, Input, Radio, Checkbox } from "@arco-design/web-react";
 import { IconSend } from "@arco-design/web-react/icon";
 
 export default function AskUserBlock({
   id,
   question,
+  options,
+  multiple,
   onRespond,
 }: {
   id: string;
   question: string;
+  options?: string[];
+  multiple?: boolean;
   onRespond: (id: string, answer: string) => void;
 }) {
   const [answer, setAnswer] = useState("");
+  const [selectedOptions, setSelectedOptions] = useState<string[]>([]);
   const [submitted, setSubmitted] = useState(false);
   const inputRef = useRef<any>(null);
 
@@ -20,33 +25,104 @@ export default function AskUserBlock({
   }, []);
 
   const handleSubmit = () => {
-    if (!answer.trim() || submitted) return;
+    if (submitted) return;
+    if (!answer.trim()) return;
     setSubmitted(true);
     onRespond(id, answer.trim());
   };
 
+  // 单选：点击选项直接提交
+  const handleSingleSelect = (value: string) => {
+    if (submitted) return;
+    setSelectedOptions([value]);
+    setAnswer(value);
+    setSubmitted(true);
+    onRespond(id, value);
+  };
+
+  // 多选：确认提交
+  const handleMultiSubmit = () => {
+    if (submitted || selectedOptions.length === 0) return;
+    const result = JSON.stringify(selectedOptions);
+    setAnswer(result);
+    setSubmitted(true);
+    onRespond(id, result);
+  };
+
+  const displayAnswer = (() => {
+    if (!answer) return "";
+    // 多选时尝试解析为数组展示
+    if (multiple) {
+      try {
+        const arr = JSON.parse(answer);
+        if (Array.isArray(arr)) return arr.join(", ");
+      } catch {
+        // 用户自行输入的文本
+      }
+    }
+    return answer;
+  })();
+
   if (submitted) {
     return (
       <div className="tw-my-3 tw-px-4 tw-py-3 tw-rounded-lg tw-bg-[var(--color-fill-1)] tw-border tw-border-solid tw-border-[var(--color-border-1)]">
         <div className="tw-text-xs tw-text-[var(--color-text-3)] tw-mb-1">Agent asked:</div>
         <div className="tw-text-sm tw-text-[var(--color-text-2)] tw-mb-2">{question}</div>
         <div className="tw-text-xs tw-text-[var(--color-text-3)] tw-mb-1">Your answer:</div>
-        <div className="tw-text-sm tw-text-[var(--color-text-1)]">{answer}</div>
+        <div className="tw-text-sm tw-text-[var(--color-text-1)]">{displayAnswer}</div>
       </div>
     );
   }
 
+  const hasOptions = options && options.length > 0;
+
   return (
     <div className="tw-my-3 tw-px-4 tw-py-3 tw-rounded-lg tw-bg-[var(--color-fill-1)] tw-border tw-border-solid tw-border-[rgb(var(--arcoblue-3))]">
       <div className="tw-text-xs tw-text-[var(--color-text-3)] tw-mb-2">Agent is asking:</div>
       <div className="tw-text-sm tw-text-[var(--color-text-1)] tw-mb-3">{question}</div>
+
+      {/* 选项区域 */}
+      {hasOptions && !multiple && (
+        <div className="tw-mb-3">
+          <Radio.Group direction="vertical">
+            {options.map((opt) => (
+              <Radio key={opt} value={opt} onClick={() => handleSingleSelect(opt)}>
+                {opt}
+              </Radio>
+            ))}
+          </Radio.Group>
+        </div>
+      )}
+
+      {hasOptions && multiple && (
+        <div className="tw-mb-3">
+          <Checkbox.Group
+            direction="vertical"
+            value={selectedOptions}
+            onChange={(values) => setSelectedOptions(values as string[])}
+          >
+            {options.map((opt) => (
+              <Checkbox key={opt} value={opt}>
+                {opt}
+              </Checkbox>
+            ))}
+          </Checkbox.Group>
+          <div className="tw-mt-2">
+            <Button type="primary" size="small" onClick={handleMultiSubmit} disabled={selectedOptions.length === 0}>
+              Confirm
+            </Button>
+          </div>
+        </div>
+      )}
+
+      {/* 文本输入框（始终显示） */}
       <div className="tw-flex tw-gap-2">
         <Input
           ref={inputRef}
           value={answer}
           onChange={setAnswer}
           onPressEnter={handleSubmit}
-          placeholder="Type your response..."
+          placeholder={hasOptions ? "Or type a custom response..." : "Type your response..."}
           size="small"
         />
         <Button type="primary" size="small" icon={<IconSend />} onClick={handleSubmit} disabled={!answer.trim()}>

src/pages/options/routes/AgentChat/ChatArea.tsx

@@ -442,7 +442,13 @@ export default function ChatArea({
             )
           )}
           {askUserPending && (
-            <AskUserBlock id={askUserPending.id} question={askUserPending.question} onRespond={respondToAskUser} />
+            <AskUserBlock
+              id={askUserPending.id}
+              question={askUserPending.question}
+              options={askUserPending.options}
+              multiple={askUserPending.multiple}
+              onRespond={respondToAskUser}
+            />
           )}
           <div ref={messagesEndRef} />
         </div>

src/pages/options/routes/AgentChat/hooks.ts

@@ -132,7 +132,7 @@ export function useMessages(conversationId: string) {
 }
 
 // ask_user 待回复状态
-export type AskUserPending = { id: string; question: string };
+export type AskUserPending = { id: string; question: string; options?: string[]; multiple?: boolean };
 
 // 流式聊天 hook
 export function useStreamingChat() {
@@ -191,7 +191,12 @@ export function useStreamingChat() {
           const event = msg.data as ChatStreamEvent;
           // 处理 ask_user 事件
           if (event.type === "ask_user") {
-            setAskUserPending({ id: event.id, question: event.question });
+            setAskUserPending({
+              id: event.id,
+              question: event.question,
+              options: event.options,
+              multiple: event.multiple,
+            });
           }
           onEvent(event);
           if (event.type === "done" || event.type === "error") {