Fill Form

When to Use

Activate when the user asks to fill out a form, complete an application, enter data into fields, or submit information on a web page.

Steps

1. Collect the data to fill. Ask the user for the information if not already provided. Organize it as key-value pairs.

2. Take a snapshot using

   take_snapshot

   to see the form fields and understand the layout.

3. Map data to fields. Match the user's data keys to form field labels. Handle common variations:

   • "Name" may map to "Full Name", "Your Name", or separate "First Name" + "Last Name" fields
   • "Phone" may map to "Phone Number", "Mobile", "Tel"
   • "Address" may need to split into Street, City, State, Zip

4. Fill fields in order. For each field:

   • Text inputs: Use

     fill

     with the field selector and value
   • Dropdowns/selects: Use

     select_option

     with the appropriate value
   • Checkboxes: Use

     check

     to toggle on/off
   • Radio buttons: Use

     click

     on the correct option
   • Date pickers: Try

     fill

     first; if that fails, interact with the date picker UI using

     click

   • File uploads: Use

     upload_file

     for attachment fields

5. Handle multi-step forms. After filling visible fields:

   • Look for "Next", "Continue", or "Step 2" buttons
   • Use

     click

     to advance
   • Take a new snapshot to see the next step's fields
   • Repeat the fill process

6. Review before submission. Take a final

   take_snapshot

   and present the filled form to the user for confirmation before clicking Submit.

Tips

• Fill fields top-to-bottom, left-to-right to match natural tab order.
• For auto-complete fields (like address), type slowly and wait for suggestions to appear, then select.
• If a field has validation errors after filling, read the error message and adjust the value.
• Never submit payment forms without explicit user confirmation.
• For CAPTCHA fields, inform the user they need to complete it manually.