Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Imla l-formoli u kklikkja

Lezzjoni 6 / 14 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. L-aktar interazzjoni komuni
  2. Ikklikkja qabel ma tikteb
  3. Neħħi kamp qabel ma timlah
  4. Menus, kaxxi tal-għażla, u buttuni tar-radju
  5. Formoli multi-skreen
  6. Reazzjoni għal żbalji ta’ validazzjoni
  7. Tlugħ ta’ fajl, każ speċjali
  8. Punti Ewlenin

Lezzjoni aġġornata fit-3 ta’ Novembru 2026 abbażi tal-linji gwida ta’ konferma ta’ OpenAI u d-dokumentazzjoni ta’ Playwright: id-dewmien fit-tajp ma għadux ippreżentat bħala mod biex tevadi d-detezzjoni tal-anti-bot; l-għażla tuża ControlOrMeta+a, li taħdem ukoll fuq macOS; page.screenshot() ma turix id-djalogu nativ tal-ftuħ tal-fajl, kuntrarjament għal dak li kienet tafferma l-verżjoni preċedenti; il-linji gwida jgħaddu permezz tal-parametru instructions. Sorsi: Konferma u kunsens · Playwright, Keyboard.

L-aktar interazzjoni komuni

Jekk trid timmasterizzja ġest wieħed biss, agħmel dan. Sottomissjoni ta’ talba ta’ kuntatt, mimlija ta’ kwotazzjoni, daħla ta’ rekord ta’ klijent f’CRM mingħajr API: il-formoli huma l-punt ta’ kontroll obbligatorju għall-biċċa l-kbira tal-awtomazzjonijiet. Dan huwa wkoll fejn l-aġenti kkunfigurati ħażin ifallu l-aktar spiss, għal raġunijiet konkreti ħafna li din il-lezzjoni tindirizza wieħed wieħed.

Ikklikkja qabel ma tikteb

L-azzjoni type ma tiktebx f’kamp; tikteb fil-kamp iffukat attwalment. Tinsej din in-nuansa darba biss: mingħajr klikk minn qabel, it-test tiegħek imur fil-vojt jew, b’mod aktar insidjuż, jiżdied mal-kamp preċedenti. Is-sekwenza għalhekk hija invarjanti: klikk biex tiffoka, imbagħad it-tajp.

# Fl-eżekutor tal-azzjoni tiegħek
def execute_type(page, text: str):
    """Jikteb test fil-kamp iffukat."""
    page.keyboard.type(text, delay=50)

Il-delay=50 jistħoqqilha attenzjoni. keyboard.type diġà jibgħat avvenimenti tat-tastiera karattru b’karattru, iżda mingħajr dewmien iħabbathom malajr kemm jista’ jkun; b’ħamsin millisekonda bejn kull pressjoni tat-tast, ir-rata tinżel għal għoxrin karattru kull sekonda. Il-kampi li jirreaġixxu għal kull pressjoni tat-tast—awtokompletament, maskri ta’ input għan-numri tat-telefown—għalhekk ikollhom il-ħin biex iħarsu pass magħhom. Din l-impostazzjoni mhix dwar li tgħaddi bħala bniedem: sit li jfittex li jimblokja l-bots jesprimi rieda li trid tiġi rrispettata (Lezzjoni 14).

Neħħi kamp qabel ma timlah

Formola mimlija minn qabel—kompliment tas-sessjoni, valur default, awtokompletament tan-navigatur—tbiddel l-input tiegħek f’konkatenazzjoni assurda: it-tajp ta’ “Dupont” wara “Martin” jagħti “MartinDupont”, u l-formola taċċettaha mingħajr żball. Agħżel kollox qabel ma tikteb.

def clear_and_type(page, text: str):
    """Jagħżel il-kontenut kollu fil-kamp imbagħad jikteb."""
    page.keyboard.press("ControlOrMeta+a")  # Ctrl+A, jew Cmd+A fuq macOS
    page.keyboard.type(text, delay=50)

Il-mudell jiddeċiedi l-azzjonijiet tiegħu abbażi tal-prompt: fakkruh fir-regola, inkella se jikteb direttament fil-kamp okkupat.

task = """
Imla l-formola tal-kuntatt:
- Kamp "Isem": Dupont
- Kamp "Email": [email protected]
- Kamp "Messaġġ": Talba għal kwotazzjoni għal 50 liċenzja

IMPORTANT: Qabel ma tikteb f'kull kamp, 
agħżel it-test eżistenti kollu (Ctrl+A) biex tibdlu.
Wara li timla l-kampi kollha, ikklikkja l-buttuna Ibghat.
"""

Dropdown <select> jeħtieġ tliet passi: klikk biex tiftaħu, stennija biex jidhru l-għażliet, u t-tieni klikk fuq l-għażla mixtieqa. L-aħbar tajba hija li l-menus personalizzati ta’ JavaScript—dawk li mhumiex elementi reali ta’ <select> u li jagħtu tant problemi lill-iskrits klassiċi—jiġu ttrattati bl-istess mod eżatt, peress li l-aġent jara biss ir-rendering viżiv: jikklikkja, jiskopri l-għażliet fl-iskrinshot li jmiss, u jikklikkja dik it-tajba.

Il-kaxxi tal-għażla u l-buttuni tar-radju jidhru aktar sempliċi, bi klikk waħda biżżejjed biex jiġu attivati. L-insidja tinsib band’oħra: kaxxa tal-għażla li diġà hija mmarkata ssir mhux immarkata bil-klikk, u l-aġent tiegħek għadu kemm irrevoka l-kunsens li kellu l-intenzjoni jagħti. Għalhekk irid jaqra l-istat qabel ma jaġixxi, u int trid titloblu espliċitament li jagħmel dan. Żomm f’moħħok ukoll li l-aċċettazzjoni ta’ termini jew il-ħolqien ta’ kont jimpenjaw lill-persuna li għaliha jaħdem l-aġent: fidal dawn l-azzjonijiet lilu biss jekk dik il-persuna tkun talbithom espliċitament.

task = """
Fil-formola tar-reġistrazzjoni:
1. Ipponta l-kaxxa "Naċċetta t-termini" jekk mhijiex ippuntata
2. Agħżel "Kumpanija" fit-tip ta' kont
3. Ikklikkja "Oħloq kont"

Ivverifika l-istat ta' kull element QABEL ma tikklikkja.
"""

Formoli multi-skreen

Tunnel ta’ reġistrazzjoni ta’ tliet paġni mhuwiex tliet darbiet aktar diffiċli minn formola sempliċi, sakemm tistruttura l-istruzzjonijiet paġna b’paġna u timmarka t-tranżizzjonijiet. L-aġent imbagħad jmeta sezzjoni tintemm u liema buttuna tmexxi għall-waħda li jmiss. L-eżempju jittratta data personali fittizja; b’data reali, ftakar li OpenAI tqis id-dħul ta’ informazzjoni sensittiva f’formola bħala trażmissjoni, li teħtieġ approvazzjoni mill-persuna kkonċernata.

task = """
Imla l-formola ta' reġistrazzjoni f'3 passi:

PASS 1 - Informazzjoni personali:
- Isem: Jean
- Kunjom: Dupont
- Data tat-twelid: 15/03/1985
→ Ikklikkja "Li jmiss"

PASS 2 - Dettalji tal-kuntatt:
- Email: [email protected]
- Telefown: 06 12 34 56 78
- Indirizz: 12 rue de la Paix, 75002 Paris
→ Ikklikkja "Li jmiss"

PASS 3 - Konferma:
- Ivverifika li l-informazzjoni kollha hija korretta
- Ipponta "Naċċetta t-Termini tas-Servizz"
→ Ikklikkja "Ivvalida"
"""

Reazzjoni għal żbalji ta’ validazzjoni

Format tat-telefown miċħud, kamp meħtieġ nieqes, password meqjusa qasira wisq: il-formola tirritorna messaġġ u tistenna korrezzjoni. Dan huwa eżattament fejn Computer Use jaqbeż l-iskritt, peress li l-aġent jaf kif jaqra l-iżball muri minflok ma jitfixkal fuqu. Għadek trid titloblu jfittex l-iżbalji u tillimita t-tentattivi tiegħu sabiex kamp miċħud b’mod definittiv ma jġegħlux idur bla tmiem. Dawn ir-regoli jidħlu fil-parametru instructions, irritornat ma’ kull talba (Lezzjoni 5).

INSTRUCTIONS = """
Wara li tissottometti formola:
1. Ħu screenshot biex tara r-riżultat
2. Jekk jidhru messaġġi ta' żball (bl-aħmar, f'kaxxa), 
   aqrahom u rranġa l-kampi rilevanti
3. Erġa' ssottometti l-formola
4. Irrepeti sakemm il-formola tiġi aċċettata 
   jew tkun ippruvajt 3 darbiet
"""

Tlugħ ta’ fajl, każ speċjali

Hemm limitu wieħed li l-ebda prompt ma jaqbeż: id-djalogu tal-ftuħ tal-fajl jappartjeni lis-sistema operattiva, mhux lill-paġna. L-aġent lanqas biss jarah—page.screenshot() jaqbad biss il-kontenut tal-paġna—u l-koordinati li jipproduċi japplikaw għall-paġna, mhux għal tieqa nativa. Agħti l-operazzjoni lil Playwright, li jbiegħed dan id-djalogu kompletament.

def handle_file_upload(page, file_path: str, selector: str):
    """Itella' fajl permezz ta' Playwright (mhux permezz ta' Computer Use)."""
    page.locator(selector).set_input_files(file_path)

Tista’ wkoll tħalli lill-aġent jikklikkja “Browse” bħal utent u tintervaċċja s-selettur tal-fajls fil-mument li jiftaħ: il-fluss tax-xogħol jibqa’ naturali minn tarf għal tarf, bil-parti tas-sistema ttrattata wara x-xena. Fiż-żewġ każijiet, il-kodiċi tiegħek jagħżel il-fajl, qatt mhux il-mudell; u l-ibgħat ta’ fajls huwa fost l-azzjonijiet li OpenAI tippermettilek tapprova minn qabel fit-talba inizjali, jew tikkonferma mod ieħor.

# L-aġent jikklikkja "Browse", imbagħad tintervaċċi
page.on("filechooser", lambda fc: fc.set_files("/path/to/file.pdf"))

Punti Ewlenin

  • Dejjem ikklikkja kamp qabel ma tikteb fih
  • Uża Ctrl+A (ControlOrMeta+a f’Playwright) biex tnaddaf kamp qabel ma tikteb
  • Il-menus dropdown jeħtieġu klikk biex tiftaħ, imbagħad klikk biex tagħżel
  • Ippjana t-trattament tal-iżbalji ta’ validazzjoni fil-prompt
  • It-tlugħ tal-fajls irid jiġi ttrattat minn Playwright, mhux minn Computer Use