उपयोगकर्ता से पूछें

ask_user एजेंट को मानव से एक से तीन संरचित प्रश्न पूछने और उत्तरों की प्रतीक्षा करने देता है। यह उन निर्णयों के लिए है जो वास्तव में उपयोगकर्ता के हैं, न कि नियमित पुष्टि या ऐसी जानकारी के लिए जिसे एजेंट अनुरोध, कोड या किसी विवेकपूर्ण डिफ़ॉल्ट से प्राप्त कर सकता है।

यह टूल केवल मुख्य सत्र में उपलब्ध है। उप-एजेंट और अन्य गैर-प्राथमिक रन को यह उपलब्ध नहीं होता।

किसी प्रश्न का उत्तर दें

आप किसी भी समर्थित वार्तालाप माध्यम से उत्तर दे सकते हैं:

• वेब Control UI, कंपोज़र के ठीक ऊपर एक प्रश्न पैनल डॉक करता है। एकाधिक प्रश्नों वाले प्रॉम्प्ट के लिए, पैनल एक बार में एक प्रश्न दिखाता है और एक छोटे स्टेपर के माध्यम से आगे बढ़ता है। समाधान के बाद, पैनल बंद हो जाता है और चैट में केवल उत्तरों का संक्षिप्त सारांश रहता है।
• Telegram, Discord और Slack एकल-विकल्प वाले, एकल-प्रश्न प्रॉम्प्ट के लिए नेटिव बटन रेंडर करते हैं।
• सादा-पाठ उत्तर किसी भी चैनल पर काम करता है। किसी संख्या, विकल्प लेबल या अपने उत्तर के साथ जवाब दें।

OpenClaw हमेशा मुक्त-पाठ वाला अन्य उत्तर सक्षम करता है। एजेंट को लिखित विकल्प सूची में Other विकल्प नहीं जोड़ना चाहिए।

प्लेटफ़ॉर्म व्यवहार

उत्तर प्रत्येक समर्थित वार्तालाप माध्यम पर काम करते हैं। वेब Control UI एक डॉक किया हुआ स्टेपर उपयोग करता है, जो विस्तृत होने पर कंपोज़र को प्रतिस्थापित करता है; इसे संक्षिप्त करने पर एक पतली प्रश्न पट्टी के नीचे पूरा कंपोज़र पुनर्स्थापित हो जाता है। iOS, macOS और Android इनलाइन कार्ड दिखाते हैं; एकाधिक प्रश्न जानबूझकर स्पर्श-अनुकूल शैली के रूप में एक के ऊपर एक बने रहते हैं। प्रत्येक प्लेटफ़ॉर्म सक्रिय चैट टाइमलाइन में प्रश्न-से-उत्तर सारांश को समयबद्ध निष्कासन के बिना बनाए रखता है और छोड़ें हर जगह उपलब्ध है।

जो प्रॉम्प्ट नेटिव बटन का उपयोग नहीं कर सकते, जिनमें एकाधिक-प्रश्न और बहु-चयन प्रॉम्प्ट शामिल हैं, वे चैनलों पर पठनीय पाठ में सरल हो जाते हैं। Control UI पूरा संरचित स्टेपर बनाए रखता है।

समय-सीमा और कोई उत्तर नहीं

डिफ़ॉल्ट समय-सीमा 900 सेकंड है। timeoutSeconds को 30 से 3600 सेकंड की सीमा में रखा जाता है।

यदि उत्तर आने से पहले प्रश्न की समय-सीमा समाप्त हो जाती है या उसे रद्द कर दिया जाता है, तो टूल status: "no_answer" लौटाता है। इसके बाद एजेंट अपने सर्वोत्तम विवेक से आगे बढ़ता है। निरस्त किया गया एजेंट रन अपने लंबित Gateway प्रश्न को रद्द कर देता है।

टूल स्कीमा

{  questions: Array<{    id: string; // अद्वितीय snake_case उत्तर कुंजी    header: string; // छोटा लेबल; 12 वर्णों तक छोटा किया जाता है    question: string; // एक वाक्य    options: Array<{      label: string;      description?: string;    }>; // 2-4 विकल्प    multiSelect?: boolean;  }>; // 1-3 प्रश्न  timeoutSeconds?: number; // पूर्णांक; डिफ़ॉल्ट 900, 30-3600 तक सीमित}

multiSelect: true के साथ, उपयोगकर्ता एक से अधिक विकल्प चुन सकता है। प्रत्येक प्रश्न के उत्तर मान एक ऐरे के रूप में लौटाए जाते हैं।

उत्तर दिए गए परिणाम का उदाहरण:

{  "status": "answered",  "answers": {    "answers": {      "deploy_target": ["Staging (Recommended)"]    }  }}

मॉडल मार्गदर्शन

मॉडल-सामना अनुबंध एजेंट को निर्देश देता है कि वह:

• केवल तभी पूछे जब वह वास्तव में उपयोगकर्ता के स्वामित्व वाले निर्णय पर अवरुद्ध हो;
• एक प्रश्न को प्राथमिकता दे और तीन से अधिक का उपयोग न करे;
• अनुशंसित विकल्प को पहले रखे और उसके लेबल के अंत में (Recommended) जोड़े;
• लिखित Other विकल्प को छोड़ दे क्योंकि मुक्त पाठ स्वतः जोड़ा जाता है;
• no_answer के बाद सर्वोत्तम विवेक से आगे बढ़े।

एजेंट को ask_user का उपयोग यह पूछने के लिए नहीं करना चाहिए कि क्या वह आगे बढ़ सकता है या अपनी योजना की पुष्टि करने के लिए नहीं करना चाहिए।