Tanyakan kepada pengguna

ask_user memungkinkan agen mengajukan satu hingga tiga pertanyaan terstruktur kepada manusia dan menunggu jawabannya. Fitur ini ditujukan untuk keputusan yang benar-benar berada di tangan pengguna, bukan konfirmasi rutin atau informasi yang dapat disimpulkan agen dari permintaan, kode, atau nilai default yang masuk akal.

Alat ini hanya tersedia dalam sesi utama. Subagen dan proses nonutama lainnya tidak menerimanya.

Menjawab pertanyaan

Anda dapat menjawab dari permukaan percakapan apa pun yang didukung:

• Control UI web menambatkan panel pertanyaan tepat di atas penyusun pesan. Untuk prompt dengan beberapa pertanyaan, panel menampilkan satu pertanyaan pada satu waktu dan bergerak maju melalui indikator langkah singkat. Setelah selesai, panel ditutup dan percakapan hanya menyimpan ringkasan jawaban yang ringkas.
• Telegram, Discord, dan Slack merender tombol bawaan untuk prompt satu pertanyaan dengan satu pilihan.
• Balasan teks biasa dapat digunakan di kanal apa pun. Balas dengan angka, label opsi, atau jawaban Anda sendiri.

OpenClaw selalu mengaktifkan jawaban teks bebas Lainnya. Agen tidak boleh menambahkan opsi Other ke daftar opsi yang dibuat.

Perilaku platform

Jawaban dapat digunakan pada setiap permukaan percakapan yang didukung. Control UI web menggunakan indikator langkah tertambat yang menggantikan penyusun pesan saat diperluas; menciutkannya akan memulihkan penyusun pesan lengkap di bawah bilah pertanyaan ramping. iOS, macOS, dan Android menampilkan kartu sebaris; beberapa pertanyaan tetap ditumpuk sebagai pola yang sengaja dibuat ramah sentuhan. Setiap platform mempertahankan ringkasan pertanyaan dan jawaban dalam linimasa percakapan aktif tanpa penghapusan berbasis waktu, dan Lewati tersedia di mana saja.

Prompt yang tidak dapat menggunakan tombol bawaan, termasuk prompt dengan beberapa pertanyaan dan beberapa pilihan, diturunkan menjadi teks yang mudah dibaca di kanal. Control UI mempertahankan indikator langkah terstruktur lengkap.

Batas waktu dan tanpa jawaban

Batas waktu default adalah 900 detik. timeoutSeconds dibatasi pada rentang 30 hingga 3600 detik.

Jika pertanyaan kedaluwarsa atau dibatalkan sebelum jawaban diterima, alat mengembalikan status: "no_answer". Agen kemudian melanjutkan dengan pertimbangan terbaiknya. Proses agen yang dihentikan membatalkan pertanyaan Gateway yang tertunda.

Skema alat

{  questions: Array<{    id: string; // kunci jawaban snake_case yang unik    header: string; // label singkat; dipotong menjadi 12 karakter    question: string; // satu kalimat    options: Array<{      label: string;      description?: string;    }>; // 2-4 opsi    multiSelect?: boolean;  }>; // 1-3 pertanyaan  timeoutSeconds?: number; // bilangan bulat; default 900, dibatasi pada 30-3600}

Dengan multiSelect: true, pengguna dapat memilih lebih dari satu opsi. Nilai jawaban dikembalikan sebagai larik untuk setiap pertanyaan.

Contoh hasil yang telah dijawab:

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

Panduan model

Kontrak yang ditujukan kepada model menginstruksikan agen untuk:

• bertanya hanya ketika terhambat oleh keputusan yang benar-benar berada di tangan pengguna;
• mengutamakan satu pertanyaan dan tidak menggunakan lebih dari tiga;
• menempatkan opsi yang direkomendasikan terlebih dahulu dan menambahkan (Recommended) pada akhir labelnya;
• tidak menyertakan opsi Other yang dibuat karena teks bebas ditambahkan secara otomatis;
• melanjutkan dengan pertimbangan terbaik setelah no_answer.

Agen tidak boleh menggunakan ask_user untuk menanyakan apakah boleh melanjutkan atau untuk mengonfirmasi rencananya sendiri.