Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Űrlapok kitöltése és kattintás

6. lecke 14 közül Frissítve 2026. november 3. Fejlesztő
Ezen az oldalon
  1. A leggyakoribb interakció
  2. Kattints, mielőtt gépelsz
  3. Törölj egy mezőt, mielőtt kitöltöd
  4. Menük, jelölőnégyzetek és választógombok
  5. Többképernyős űrlapok
  6. Reakció a validálási hibákra
  7. Fájlfeltöltés, egy speciális eset
  8. Főbb megállapítások

Lecke frissítve: 2026. november 3. az OpenAI megerősítési irányelvei és a Playwright dokumentációja alapján: a gépelési késleltetést már nem botellenes védelem kijátszásának eszközeként tüntetjük fel; a kijelölés a ControlOrMeta+a billentyűkombinációt használja, amely macOS alatt is működik; a page.screenshot() nem rögzíti a natív fájlmegnyitó párbeszédpanelt, ellentétben a korábbi verzió állításával; az irányelveket az instructions paraméteren keresztül adjuk át. Források: Megerősítés és beleegyezés · Playwright, Billentyűzet.

A leggyakoribb interakció

Ha csak egyetlen gesztust sajátítasz el, ez legyen az. Kapcsolatfelvételi kérelem beküldése, árajánlat kitöltése, ügyféladat bevitele egy API-val nem rendelkező CRM-be: az űrlapok a legtöbb automatizálás kötelező ellenőrző pontjai. Egyben ez az a terület, ahol a rosszul konfigurált ügynökök a leggyakrabban kudarcot vallanak, nagyon konkrét okok miatt, amelyeket ez a lecke egyesével tárgyal.

Kattints, mielőtt gépelsz

A type művelet nem ír közvetlenül egy mezőbe; hanem a jelenleg fókuszált mezőbe ír. Csak egyszer felejtsd el ezt a nüanszt: előzetes kattintás nélkül a szöveged a semmibe vész, vagy ami még alattomosabb, hozzáfűződik az előző mező tartalmához. A sorrend tehát változatlan: egy kattintás a fókuszáláshoz, majd a gépelés.

# A műveletvégrehajtódban
def execute_type(page, text: str):
    """Szöveget ír a fókuszált mezőbe."""
    page.keyboard.type(text, delay=50)

A delay=50 beállítás figyelmet érdemel. A keyboard.type már eleve billentyűzeteseményeket küld karakterenként, de késleltetés nélkül ezeket a lehető leggyorsabban láncolja össze; ötven milliszekundum késleltetéssel a billentyűleütések között az arány másodpercenként húsz karakterre csökken. Így azok a mezők, amelyek minden billentyűleütésre reagálnak – mint az automatikus kiegészítés vagy a telefonszám-beviteli maszkok – képesek tartani a lépést. Ez a beállítás nem arról szól, hogy embernek áldozd ki magad: ha egy oldal blokkolni kívánja a botokat, az egy akaratnyilvánítás, amelyet tiszteletben kell tartani (14. lecke).

Törölj egy mezőt, mielőtt kitöltöd

Egy előre kitöltött űrlap – munkamenet folytatása, alapértelmezett érték, böngésző automatikus kiegészítése – abszurd összefűzéssé változtatja a beviteledet: ha a „Martin“ után beírod a „Dupont“-ot, az eredmény „MartinDupont“ lesz, és az űrlap hiba nélkül elfogadja. Gépeltetés előtt jelöld ki az összes szöveget.

def clear_and_type(page, text: str):
    """Kijelöli a mező teljes tartalmát, majd gépel."""
    page.keyboard.press("ControlOrMeta+a")  # Ctrl+A, vagy Cmd+A macOS alatt
    page.keyboard.type(text, delay=50)

A modell a prompt alapján dönt a műveleteiről: emlékeztesd a szabályra, különben közvetlenül a foglalt mezőbe kezd gépelni.

task = """
Töltsd ki a kapcsolatfelvételi űrlapot:
- „Név“ mező: Dupont
- „E-mail“ mező: [email protected]
- „Üzenet“ mező: Árajánlatkérés 50 licencre

FONTOS: Minden mezőbe gépelés előtt 
jelöld ki a meglévő szöveget (Ctrl+A), hogy felülírd azt.
Miután kitöltötted az összes mezőt, kattints a „Küldés“ gombra.
"""

Menük, jelölőnégyzetek és választógombok

Egy <select> legördülő menü három lépést igényel: egy kattintás a megnyitáshoz, egy várakozás, amíg a lehetőségek megjelennek, majd egy második kattintás a kívánt opción. A jó hír az, hogy az egyedi JavaScript menüket – amelyek nem valódi <select> elemek, és sok gondot okoznak a klasszikus szkripteknek – pontosan ugyanígy kezeljük, mivel az ügynök csak a vizuális megjelenítést látja: kattint, a következő képernyőképen felfedezi a lehetőségeket, majd a megfelelőre kattint.

A jelölőnégyzetek és választógombok egyszerűbbnek tűnnek, egyetlen kattintás elég az aktiválásukhoz. A csapda máshol rejlik: egy már bejelölt jelölőnégyzet kattintásra kijelölődik, és az ügynököd éppen visszavonta azt a beleegyezést, amelyet meg kellett volna adnia. Ezért cselekvés előtt le kell olvasnia az állapotot, és ezt neked is expliciten kérned kell tőle. Ne feledd azt sem, hogy a feltételek elfogadása vagy fiók létrehozása elkötelezi azt a személyt, akinek az ügynök dolgozik: csak akkor bízd rá ezeket a műveleteket, ha az érintett személy kifejezetten kérte őket.

task = """
A regisztrációs űrlapon:
1. Pipáld ki a „Elfogadom a feltételeket“ négyzetet, ha még nincs bejelölve
2. Válaszd a „Cég“ lehetőséget a fiók típusánál
3. Kattints a „Fiók létrehozása“ gombra

Minden elem állapotát ellenőrizd KATTINTÁS előtt.
"""

Többképernyős űrlapok

Egy háromoldalas regisztrációs folyamat nem háromszor nehezebb egy egyszerű űrlapnál, feltéve, hogy oldalanként strukturálod az utasításokat, és jelölöd az átmeneteket. Az ügynök így tudja, mikor zárult le egy szakasz, és melyik gomb visz tovább a következőhöz. A példa kitalált személyes adatokat kezel; valós adatok esetén ne feledd, hogy az OpenAI szerint érzékeny információk űrlapba történő bevitele továbbításnak minősül, amelyhez az érintett személy jóváhagyása szükséges.

task = """
Töltsd ki a 3 lépésből álló regisztrációs űrlapot:

1. LÉPÉS – Személyes adatok:
- Keresztnév: Jean
- Vezetéknév: Dupont
- Születési dátum: 1985.03.15.
→ Kattints a „Tovább“ gombra

2. LÉPÉS – Elérhetőségi adatok:
- E-mail: [email protected]
- Telefon: 06 12 34 56 78
- Cím: 12 rue de la Paix, 75002 Paris
→ Kattints a „Tovább“ gombra

3. LÉPÉS – Megerősítés:
- Ellenőrizd, hogy minden adat helyes
- Pipáld ki az „Elfogadom a Szolgáltatási Feltételeket“ négyzetet
→ Kattints a „Jóváhagyás“ gombra
"""

Reakció a validálási hibákra

Elutasított telefonszám-formátum, hiányzó kötelező mező, túl rövidnek ítélt jelszó: az űrlap üzenettel tér vissza, és javítást vár. Pontosan itt múlja felül a Computer Use a hagyományos szkripteket, mivel az ügynök képes elolvasni a megjelenített hibaüzenetet ahelyett, hogy beletörődne. Neked még mindig meg kell kérned, hogy keressen hibákat, és korlátoznod kell a próbálkozásait, hogy egy véglegesen elutasított mező miatt ne kerüljön végtelen ciklusba. Ezeket a szabályokat az instructions paraméterbe kell foglalnod, amelyet minden kéréssel visszaküldesz (5. lecke).

INSTRUCTIONS = """
Űrlap beküldése után:
1. Készíts képernyőképet az eredmény megtekintéséhez
2. Ha hibaüzenetek jelennek meg (piros színben, keretben), 
   olvasd el őket, és javítsd az érintett mezőket
3. Küldd be újra az űrlapot
4. Ismételd addig, amíg az űrlapot el nem fogadják, 
   vagy el nem éred a 3 próbálkozást
"""

Fájlfeltöltés, egy speciális eset

Van egy korlát, amelyet egyetlen prompt sem léphet át: a fájlmegnyitó párbeszédpanel az operációs rendszerhez tartozik, nem az oldalhoz. Az ügynök még csak nem is látja – a page.screenshot() csak az oldal tartalmát rögzíti –, és az általa generált koordináták az oldalra vonatkoznak, nem egy natív ablakra. Bízd a műveletet a Playwright-ra, amely teljesen megkerüli ezt a párbeszédpanelt.

def handle_file_upload(page, file_path: str, selector: str):
    """Fájlt tölt fel a Playwright segítségével (nem a Computer Use-szal)."""
    page.locator(selector).set_input_files(file_path)

Azt is teheted, hogy hagyod az ügynököt rákattintani a „Tallózás“ gombra, mint egy felhasználó, és elfogod a fájlválasztót abban a pillanatban, amikor megnyílik: a munkafolyamat így végig természetes marad, a rendszer részét pedig a háttérben intézzük. Mindkét esetben a kódod választja ki a fájlt, soha nem a modell; a fájlok küldése pedig azon műveletek közé tartozik, amelyeket az OpenAI lehetővé tesz, hogy előzetesen jóváhagyj a kezdeti kérésben, vagy másképpen megerősíts.

# Az ügynök rákattint a „Tallózás“ gombra, majd te elfogod az eseményt
page.on("filechooser", lambda fc: fc.set_files("/path/to/file.pdf"))

Főbb megállapítások

  • Mindig kattints egy mezőre, mielőtt gépelnél bele
  • Használd a Ctrl+A (ControlOrMeta+a a Playwrightban) billentyűkombinációt a mező törléséhez gépelés előtt
  • A legördülő menük megnyitásához egy kattintás, a kiválasztáshoz egy újabb kattintás szükséges
  • Tervezd meg a validálási hibák kezelését a promptban
  • A fájlfeltöltést a Playwrightnak kell kezelnie, nem a Computer Use-nak