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

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": {        "answers": ["Staging (Recommended)"]      }    }  }}

मॉडल संबंधी मार्गदर्शन

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

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

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