Skip to content

Google Flights चलाना: 7 सेकंड में एक वास्तविक खोज पूरी करें ​

पिछले पाठ में वातावरण तैयार किया था; इस पाठ में agent से असली काम करवाएँ: आधिकारिक Jev Ultrafast Google Flights रिकॉर्डिंग को फिर से बनाना — वास्तविक Google Flights पर, एक प्राकृतिक भाषा लक्ष्य से Zürich → London की वन-वे खोज करना। आधिकारिक वीडियो में यह पूरी प्रक्रिया 7.073 सेकंड लेती है (1× गति को मूल गति पर चलाने पर), जिसमें मॉडल कॉल, शहरों के नाम बनाना, ब्राउज़र संचालन और लोड प्रतीक्षा शामिल हैं।

इस पाठ में एक ही लक्ष्य के साथ दो रास्ते चलेंगे: पहले inspector में हर निर्णय को समझें, फिर examples/flights.py से रिकॉर्डिंग फिर से बनाएँ और कोड से परिणाम का स्वतंत्र सत्यापन करवाएँ। इस दौरान आप बार-बार एक आधिकारिक चेतावनी देखेंगे — DONE पर्याप्त नहीं है, स्वतंत्र सत्यापन ही मायने रखता है — यही इस पाठ का मुख्य विषय है।

सीखने के बाद आप क्या कर सकेंगे ​

  • inspector के Google Flights · real web सीन में एक वास्तविक खोज पूरी करें, और Choose next से कदम-दर-कदम देखें कि संचालन और लक्ष्य कैसे चुने जाते हैं
  • uv run --env-file .env python examples/flights.py --keep-open से आधिकारिक रिकॉर्डिंग फिर से बनाएँ: खोज, स्वतंत्र सत्यापन, trace सहेजना — पूरे समय कोई चयन या बुकिंग नहीं
  • बता सकें कि verify() की 7 स्वतंत्र जाँचें क्या-क्या जाँचती हैं (जैसे origin फ़ील्ड का मान Zürich होना चाहिए), और DONE सफलता का प्रमाण क्यों नहीं माना जा सकता
  • स्पष्ट कर सकें कि 7.073 सेकंड की गिनती का आधार क्या है: पहली भविष्यवाणी से शुरू, DONE स्वीकारने पर खत्म — क्या इसमें शामिल है, क्या नहीं
  • जानें कि उदाहरण की तारीख़ समाप्त होने पर लक्ष्य और सत्यापन स्ट्रिंग में साथ-साथ कैसे बदलाव करें, और उदाहरण को अपना ब्राउज़र स्वचालित खोज प्रयोग बनाएँ

आपकी अभी की दिक्कत ​

  • आधिकारिक वीडियो में 7 सेकंड में उड़ानें खोजी जाती हैं, लेकिन खुद inspector चलाने पर पेज कुछ ही क्लिक में खत्म हो जाता है — हर कदम पर Jev ने क्या चुना और क्यों चुना, वह बिल्कुल साफ़ नहीं दिखा
  • दूसरों को बताना चाहते हैं कि «यह agent सच में चलता है», लेकिन «इसने DONE कह दिया» के अलावा कोई प्रमाण नहीं है — कहीं ऐसा तो नहीं कि उसने गलत खोज कर ली?
  • खुद वेबपेज फ़ॉर्म भरने की स्क्रिप्ट लिखना बहुत कष्टप्रद है: सिलेक्टर DOM खोंसकर निकालने पड़ते हैं, Google का लेआउट बदलते ही बड़े पैमाने पर टूट जाते हैं, और डेट पिकर व ऑटोकंप्लीट जैसे «पेज की प्रतिक्रिया का इंतज़ार करने वाले» नियंत्रणों से निपट नहीं पाते

यह तरीक़ा कब अपनाएँ ​

जब आपको यह चाहिए:

  • अपनी आँखों से पुष्टि करना कि Jev Ultrafast वास्तविक वेबसाइट पर (स्थानीय टेस्ट पेज पर नहीं) एक पूरी खोज पूरी कर सकता है
  • एक दोहराने-योग्य, सत्यापन-योग्य ultrafast flights बेंचमार्क चलाने का तरीक़ा, जिसे बाद में लक्ष्य या वेबसाइट बदलकर तुलनात्मक प्रयोग करने के लिए इस्तेमाल किया जा सके
  • टीम या दोस्तों को ब्राउज़र agent का डेमो देना, और verify() की 7 जाँचों true की ओर इशारा करके कह सकना कि «परिणाम जाँच लिया गया है»

और जब आप यह नहीं चाहते:

  • Google Flights के लिए हाथ से सिलेक्टर स्क्रिप्ट लिखना — पेज का लेआउट बदलते ही बेकार हो जाती है
  • केवल मॉडल के DONE कहने भर से कार्य सफल घोषित करना

🎒 शुरू करने से पहले की तैयारी ​

  • Ultrafast इंस्टॉल और चलाना पूरा किया हो: uv sync से डिपेंडेंसी लगाई हों, .env में TYPESAFE_API_KEY और TEXT_MODEL_API_KEY भरे हों, inspector 127.0.0.1:8766 खुलता हो
  • Chrome से कम से कम एक बार कनेक्ट किया हो (पहली बार Start demo पर रिमोट डिबगिंग की अनुमति दी हो; न हो तो पिछले पाठ पर लौटकर uv run browser-harness --doctor चलाएँ)
  • नेटवर्क से www.google.com और api.typesafe.ai तक पहुँच बनती हो — इस बार सच में इंटरनेट पर जाना है
  • Jev Ultrafast सिद्धांत की 8 प्रकार के संचालन और «एक राउंड-ट्रिप में दो निर्णय» देखे हों, ताकि inspector पैनल देखकर चकराएँ नहीं
  • एक गिलास पानी — 7 सेकंड बहुत जल्दी बीतते हैं, लेकिन आज आपको बहुत बार देखना है

मूल विचार ​

आधिकारिक तौर पर Google Flights को «फ़ाइनल परीक्षा» के रूप में बेतरतीबी से नहीं चुना गया था: फ़ॉर्म जटिल है (वन-वे टॉगल, ऑटोकंप्लीट वाले दो शहर बॉक्स, डेट पिकर, खोज बटन), लोडिंग वास्तविक है (परिणाम पेज का इंतज़ार करना पड़ता है), और परिणाम मशीन से सत्यापन योग्य है — URL, फ़ील्ड मान और उड़ानों की सूची सब परिणाम पेज पर मौजूद हैं।

इस पाठ के तीन काम:

**1. एक वाक्य का लक्ष्य ही पूरा इनपुट है। ** README के मूल शब्द: नीति में कोई साइट-विशिष्ट एक्शन स्क्रिप्ट नहीं, कोई पहले से तैयार फ़ील्ड स्ट्रिंग नहीं (There are no site-specific action scripts or prepared field strings in the policy)। आपको बस एक शुरुआती URL और एक लक्ष्य देना है, बाकी सब हर राउंड की अवलोकन से गतिशील रूप से बनने वाली क्रमांकित तत्व सूची पर निर्भर है — इसलिए वही नीति URL और लक्ष्य बदलकर Wikipedia भी खोल सकती है (पाठ 5 का उदाहरण)।

**2. 7 सेकंड «निर्णय लूप» (decision loop) के सेकंड हैं, जिनकी एक स्पष्ट परिभाषा है। ** आधिकारिक वीडियो 7,073 ms: पहली भविष्यवाणी से शुरू (प्रारंभिक पेज अवलोकन के बाद), DONE स्वीकार करने पर समाप्त; इसमें मॉडल कॉल, टेक्स्ट जनरेशन, ब्राउज़र ऑपरेशन, stale निर्णय और लोडिंग प्रतीक्षा शामिल हैं; इसमें ब्राउज़र स्टार्टअप, प्रारंभिक नेविगेशन और बाद का स्वतंत्र सत्यापन शामिल नहीं है। आपको जो सेकंड मिलते हैं वे इससे मेल न खाना बिल्कुल सामान्य है—परिभाषा के विवरण अगले पाठ परफ़ॉर्मेंस निर्वचन में तोड़े जाएँगे।

**3. DONE गिनती में नहीं आता, verify() ही गिनती में आता है। ** README इसे सीधे कहता है: A DONE choice still requires independent outcome verification (DONE चुनने के बाद भी स्वतंत्र परिणाम सत्यापन ज़रूरी है)। examples/flights.py में ऐसा ही एक verify() शामिल है—यह परिणाम पेज को स्वयं पढ़ता है, मॉडल का उत्तर नहीं।

एक ही लक्ष्य, दो तरीके, हर एक का अपना काम:

inspector (uv run jev)स्क्रिप्ट (examples/flights.py)
उद्देश्यआँखों से निर्णय देखनास्टॉपवॉच से मापना + स्वचालित सत्यापन
स्क्रीनशॉटचालू (demo स्पष्ट रूप से screenshots=True पास करता है)बंद (Agent डिफ़ॉल्ट screenshots=False)
परिणाम सत्यापनआप स्वयं देखेंverify() 7 चीज़ों की स्वचालित जाँच
traceपैनल Export trace ↓ मैन्युअल एक्सपोर्टस्वचालित रूप से artifacts/flights/latest/ में सहेजा जाता है
किसके लिए उपयुक्तपहली बार चलाना, चरण-दर-चरण धीमा प्लेबैकरिकॉर्डिंग पुनः उत्पन्न करना, लक्ष्य बदलकर प्रयोग करना

💡 inspector समय मापने के लिए उपयुक्त क्यों नहीं है

README स्पष्ट रूप से कहता है कि डिफ़ॉल्ट agent लूप स्क्रीनशॉट नहीं लेता, inspector वह है जिसने «स्क्रीनशॉट स्वयं चालू किए हैं» (The inspector opts into screenshots)। स्क्रीनशॉट के लिए रेंडरिंग और ट्रांसफ़र चाहिए, और वह भी लोकल HTTP सेवा के ज़रिए—आधिकारिक सेकंड पुनः उत्पन्न करने के लिए इस पाठ के चरण 4 की स्क्रिप्ट विधि अपनाएँ।

मेरे साथ करें ​

चरण 1: लक्ष्य समझें—इस बार Google Flights खोज को क्या पूरा करना है ​

क्यों: Ultrafast को आप जो इनपुट देते हैं वह केवल एक स्वाभाविक भाषा का लक्ष्य है (साथ में एक प्रारंभिक URL), कोई साइट स्क्रिप्ट नहीं, कोई फ़ील्ड सूची नहीं। लक्ष्य का हर वाक्यांश agent के लिए एक आवश्यकता है जिसे पूरा करना है (और जिनमें से अधिकांश सत्यापित भी होते हैं)—पहले इसे तोड़ें, तभी आगे के हर चरण पर पता चलेगा कि आप क्या देख रहे हैं।

उदाहरण लक्ष्य (examples/flights.py का GOALS, और यही वह टेक्स्ट है जो inspector के टास्क बॉक्स में पहले से भरा होता है):

text
Find one-way flights from Zurich to London on September 20, 2026,
for one adult in economy. Stop when matching flight options are visible.
Do not select or book a flight.

चीनी संस्करण: Zurich से London तक 2026 साल 9 महीने 20 तारीख़ का one-way उड़ान खोजें, एक वयस्क, इकोनॉमी क्लास; मिलते ही मैचिंग उड़ान विकल्प दिखाई दें तो रुक जाएँ; कोई उड़ान न चुनें और न ही बुक करें।

लक्ष्य को वाक्य-दर-वाक्य तोड़ें, हर आवश्यकता एक कार्य से मेल खाती है, और उनमें से अधिकांश पर verify() नज़र रखता है:

लक्ष्य की आवश्यकताएँagent को क्या करना हैverify() की संगत जाँच
one-way (एक तरफ़ा)ticket type को One way पर स्विच करेंone_way: फ़ील्ड मान == One way
from ZurichWhere from? बॉक्स में टाइप करें और ऑटोकंप्लीट सुझाव चुनेंorigin: फ़ील्ड मान == Zürich
to LondonWhere to? बॉक्स में टाइप करें और सुझाव चुनेंdestination: फ़ील्ड मान == London
September 20, 2026Departure खोलें, तारीख़ पर क्लिक करें और पुष्टि करेंdate: फ़ील्ड मान == Sun, Sep 20; year: URL या पेज टेक्स्ट में 2026-09-20 शामिल
one adult in economyनिर्देश «हर आवश्यक नियंत्रण सेट करें» के अनुसार यात्री और क्लास की पुष्टि करेंकोई संगत जाँच नहीं (7 चीज़ों में यह शामिल नहीं)
Stop when … visibleपरिणाम दिखाई दे और सभी आवश्यकताएँ पूरी हों तभी DONEresults: कम से कम एक Select flight, और सभी में Sunday, September 20
Do not select or bookपरिणाम पेज तक ही, किसी उड़ान पर क्लिक नहींउदाहरण डॉकस्ट्रिंग: never selects or books a flight

यात्री और क्लास के लिए कोई संगत verify जाँच नहीं है—इस चीज़ की पुष्टि करनी हो तो परिणाम पेज स्वयं देखना ही तरीका है।@@I18N_KEEP_000034@@

दो बारीकियाँ ध्यान देने योग्य हैं:

  • प्रारंभिक URL https://www.google.com/travel/flights?hl=en है—?hl=en इंटरफ़ेस को अंग्रेज़ी पर स्थिर रखता है। verify() द्वारा अभिकथित फ़ील्ड लेबल (Where from?, Select flight) अंग्रेज़ी में हैं; दूसरी भाषा में चलाने पर सत्यापन मेल नहीं खाएगा।
  • लक्ष्य में Zurich लिखा है (बिना डायक्रिटिक), verify अपेक्षित फ़ील्ड मान Zürich है (डायक्रिटिक के साथ)—बीच में «टाइप करें → ऑटोकंप्लीट सुझाव चुनें» का चरण है, सुझाव चुनने के बाद फ़ील्ड में Google का अपना लिखने का तरीका रह जाता है। मॉडल निर्देश भी माँगते हैं: A typed query still needs its matching autocomplete suggestion selected.

आपको यह दिखना चाहिए: लक्ष्य तोड़ने के बाद, अधिकांश आवश्यकताएँ किसी मशीन जाँच पर आती हैं—one-way, दोनों शहर, तारीख़, परिणाम सूची सबके लिए हैं; «एक वयस्क इकोनॉमी» के लिए कोई जाँच नहीं है, और «न चुनें, न बुक करें» की गारंटी उदाहरण के अपने डिज़ाइन से होती है (डॉकस्ट्रिंग के मूल शब्द: never selects or books a flight)।

  • लक्ष्य की कम से कम 3 आवश्यकताओं की संगत verify जाँच बता सकें

चरण 2: inspector में Jev Ultrafast Google Flights खोज शुरू करें ​

क्यों: पहली बार असली वेबसाइट चलाते समय, पहले inspector का उपयोग करना बेहतर है—यह चरण-दर-चरण रुक सकता है, हर उम्मीदवार की प्रायिकता दिखा सकता है, और समस्या होने पर पता चल जाता है कि किस चरण पर अटके हैं।

रिपॉज़िटरी की रूट डायरेक्टरी में शुरू करें (पिछले पाठ में इंस्टॉल किया गया वातावरण):

bash
cd jev-ultrafast
uv run jev

आपको यह दिखना चाहिए: टर्मिनल Jev Ultrafast: http://127.0.0.1:8766 प्रिंट करता है। ब्राउज़र यह पता खोलता है, और टास्क बॉक्स में चरण 1 वाला Zurich → London लक्ष्य पहले से भरा होता है।

फिर:

  1. परिदृश्य ड्रॉपडाउन में पुष्टि करें कि Google Flights · real web चयनित है (यही डिफ़ॉल्ट है; दूसरे दो · fixture परिदृश्य लोकल पेज हैं, नेट पर नहीं जाते)
  2. Start demo पर क्लिक करें, और संकेत मिलने पर Chrome रिमोट डिबगिंग की अनुमति दें (इंटरफ़ेस स्थिति Opening a fresh browser… दिखाएगी)
  3. Run automatically पर क्लिक करें और एक ही बार में पूरा चलाएँ, पहले एक पूरी खोज का अनुभव लें

आपको यह दिखना चाहिए (README की मूल भाषा में सूचीबद्ध चार चीज़ें): numbered elements, operation probabilities, target probabilities, executed actions। दाईं ओर के मीट्रिक्स क्षेत्र में हर निर्णय का Decision time, Target confidence और चुना गया Operation भी दिखेगा; ब्राउज़र पैनल में Google Flights पेज पर स्वचालित कार्रवाई शुरू हो जाती है। चलने के बाद स्टेटस बार में Jev reports complete · inspect the page दिखता है—पूरा इंटरफ़ेस आपको याद दिला रहा है: पेज की जाँच करें, केवल यह न देखें कि उसने पूरा कर दिया कहा।

  • inspector में numbered elements और दो कॉलम की probabilities दिखती हैं, Chrome में Google Flights पेज बदलना शुरू होता है

चरण 3: Choose next को धीमा चलाकर, 7 सेकंड की निर्णय-श्रृंखला स्पष्ट रूप से देखें ​

क्यों: 7 सेकंड बहुत तेज़ है, स्वचालित चलने पर कुछ समझ नहीं आता। Choose next निष्पादन से पहले रुकता है, और "candidates कैसे ranked हैं" दिखाता है—agent को समझने का यह सर्वोत्तम दृष्टिकोण है।

Start demo पर एक बार फिर क्लिक करके नया राउंड शुरू करें, इस बार कदम-दर-कदम चलें: Choose next पर एक बार क्लिक करने से केवल prediction होती है, निष्पादन नहीं—Indexed elements क्षेत्र probability के अनुसार क्रमबद्ध हो जाता है (इंटरफ़ेस संकेत Choose next to rank से बदलकर Ranked by Jev हो जाता है), NEXT ACTION क्षेत्र में चुना गया operation और target दिखता है; समझ जाने पर Execute choice पर क्लिक करें तभी वास्तव में निष्पादन होता है। और धीरे देखना चाहें तो Slow motion चुनकर Run automatically चलाएँ—हर कदम "prediction" और "execution" के बीच 450 ms रुकेगा।

लक्ष्य के अनुसार, एक विशिष्ट राउंड की निर्णय-श्रृंखला ऐसी दिखती है (action types मॉडल के निर्देशों और element तालिका से हैं; ठीक क्रम हर राउंड में भिन्न हो सकता है):

चरणआप क्या देखेंगेपर्दे के पीछे क्या होता है
एकतरफ़ा टिकट पर स्विच करेंCLICK प्रकार का element (जैसे Change ticket type, README के element तालिका उदाहरण की पहली पंक्ति)operation और target एक ही TypeSafe अनुरोध में एक साथ तय होते हैं
शहर दर्ज करेंTYPE_TEXT दिखता है, संक्षिप्त विराम के बाद बॉक्स में टेक्स्ट आता हैtext helper स्ट्रिंग बनाता है (आधिकारिक रिकॉर्डिंग: Zurich में 581 ms, London 346 ms); इनपुट के बाद autocomplete सुझावों की प्रतीक्षा (≤200 ms) करके चुनता है
तारीख़ चुनेंCLICK Departure → किसी दिन पर क्लिक → confirmation पर क्लिकनिर्देश का मूल पाठ: For date pickers, CLICK the field, date, then confirmation
सबमिट करेंCLICK Searchनिर्देश का मूल पाठ: If Search/Submit is visible and the required fields are ready, CLICK it immediately
परिणामों की प्रतीक्षाWAITनिर्देश का मूल पाठ: WAIT only when … submitted results are still loading
काम पूराDONEनिर्देश का मूल पाठ: DONE requires visible evidence that ALL requirements are satisfied

आधिकारिक रिकॉर्डिंग का बिल (performance.md): 17 Jev अनुरोध, 10 इंटरैक्शन और 1 स्पष्ट WAIT, 2 बार text generation; Jev के एकल निर्णय का median latency 178 ms; खोज 5.217 सेकंड पर निष्पादित हुई, 7.073 सेकंड में पूरी हुई।

आपको यह दिखना चाहिए: चलने के बाद पेज जल्दी बंद न करें, तीन जगहें देखने लायक हैं—

  • Decision trail: हर निष्पादित action की एक पंक्ति, latency, probability और Page changed / No change observed के साथ—यही इस रन का trace है, Export trace ↓ से typesafe-browser-trace.json के रूप में export किया जा सकता है

  • Decision trail शीर्षक के पास का counter: N actions · X.XX s—इस रन के action संख्या और cumulative सेकंड

  • पेज के नीचे का collapsible खंड What the model sees: Jev को भेजा गया structured state का मूल पाठ (screenshot नहीं); पैनल में इंटरफ़ेस की एक मूल पंक्ति याद रखने लायक है: Operation and target are separate choices in one request. Text is generated only for TYPE_TEXT.

  • Choose next से कम से कम 3 कदम चलें, हर कदम पर चुने गए operation और target बताएँ

  • What the model sees एक बार खोलें, देखें कि वहाँ screenshot नहीं बल्कि structured state है

चरण 4: examples/flights.py से आधिकारिक रिकॉर्डिंग को पुनः उत्पन्न करें ​

क्यों: inspector आपको दिखाने के लिए है (screenshot चालू), आधिकारिक सेकंड screenshot के बिना स्क्रिप्ट रन से आते हैं; flights.py दो काम और करता है—चलने के बाद स्वचालित सत्यापन, और trace को डिस्क पर सहेजना।

रिपॉज़िटरी की मूल निर्देशिका में:

bash
uv run --env-file .env python examples/flights.py --keep-open

दोनों पैरामीटर छोड़े नहीं जा सकते:

  • --env-file .env: flights.py स्वयं .env नहीं पढ़ता (यह logic केवल demo.py में है), Key पूरी तरह uv inject करता है—यह छूट जाए तो पहले ही निर्णय पर KeyError: 'TYPESAFE_API_KEY' throw होता है (model.py os.environ["TYPESAFE_API_KEY"] से सीधे मान लेता है)
  • --keep-open: चलने के बाद agent.close() call नहीं होता, Chrome का परिणाम पेज खुला रहता है ताकि आप खुद आँखों से जाँच सकें

आपको यह दिखना चाहिए: टर्मिनल पहले progress scroll करके छापता है, हर पंक्ति में तीन फ़ील्ड—cumulative milliseconds, स्थिति, अभी-अभी निष्पादित action (action label पेज element से आता है, हर राउंड में भिन्न):

text
<मिलीसेकंड> तैयार <अभी-अभी निष्पादित क्रिया का लेबल>
<मिलीसेकंड> तैयार <अभी-अभी निष्पादित क्रिया का लेबल>
……
<मिलीसेकंड> पूर्ण <अंतिम निष्पादित क्रिया का लेबल>

(सांकेतिक; milliseconds और action आपके इस रन के अनुसार होंगे, अंतिम पंक्ति की स्थिति done है)

फिर सत्यापन परिणाम का JSON छापता है (संरचना flights.py से है, visible_flights की सामग्री उस दिन की उपलब्ध flights पर निर्भर करती है):

json
{
  "passed": true,
  "checks": {
    "search_page": true,
    "one_way": true,
    "origin": true,
    "destination": true,
    "date": true,
    "year": true,
    "results": true
  },
  "visible_flights": [
    "…当天可选航班的 Select flight 按钮,每条都含 Sunday, September 20…"
  ]
}

यदि 7 आइटमों में से कोई भी false है, तो स्क्रिप्ट non-zero code से बाहर निकलती है, और अंत में यह पंक्ति होती है:

text
Final page did not satisfy the route/date checks

साथ ही, artifacts/flights/latest/ के नीचे दो नई फ़ाइलें आती हैं (निर्देशिका बदलना चाहें तो --output <目录> जोड़ें):

फ़ाइलसामग्री
state.jsonपूरा snapshot + verification परिणाम (7 आइटम जाँचें और दिखने वाली flights सब इसी में हैं)
session.jsonब्राउज़र target और session जानकारी

artifacts/ रिपॉज़िटरी की .gitignore में है, trace गलती से commit नहीं होगा।

  • टर्मिनल अंत में "passed": true का verification JSON प्रिंट करता है
  • artifacts/flights/latest/ के अंतर्गत state.json और session.json हैं
  • Chrome का परिणाम पेज अभी भी खुला है; प्रस्थान/गंतव्य/तारीख क्रमशः Zürich / London / Sep 20 हैं

चरण 5: verify() के 7 स्वतंत्र जाँचों को समझें—DONE गिनती में नहीं आता ​

क्यों: यह इस पाठ का सबसे महत्वपूर्ण चरण है। flights.py के verify() डॉकस्ट्रिंग में साफ़ लिखा है: Independent checks on the resulting page, not the model's DONE answer—यह परिणाम पेज की जाँच करता है, मॉडल की आत्म-रिपोर्ट की नहीं।

7 जाँचों को एक-एक करके देखें (की-नाम और अपेक्षित मान दोनों flights.py के सोर्स कोड से लिए गए हैं):

जाँच आइटमअभिकथनपास होने का अर्थ
search_pagehostname www.google.com है और पाथ /travel/flights/search हैवास्तव में सर्च परिणाम पेज पर पहुँच गए
one_wayChange ticket type. One way फ़ील्ड मान == One wayवन-वे सेटिंग लागू हो गई
originWhere from? फ़ील्ड मान == Zürichप्रस्थान शहर का सुझाव सही चुना गया
destinationWhere to? फ़ील्ड मान == Londonगंतव्य शहर का सुझाव सही चुना गया
dateDeparture फ़ील्ड मान == Sun, Sep 20तारीख माह 9 की 20 तारीख चुनी गई
yearURL के tfs पैरामीटर को base64 डिकोड करने पर 2026-09-20 मिलता है, या पेज टेक्स्ट में departing 2026-09-20 हैवर्ष भी 2026 है (दो निर्धारण पथ, कोई भी एक मेल खा जाए तो पर्याप्त)
resultsकम से कम एक एक्शन लेबल में Select flight है, और हर एक में Sunday, September 20 हैपरिणाम सूची वास्तव में रेंडर हुई, और सभी उसी दिन की उड़ानें हैं

तीन डिज़ाइन विवरण हैं, जिन्हें आप अपने कार्यों में लेना उचित है:

  • सत्यापन पेज पढ़ता है, मॉडल को नहीं। DONE केवल Jev का एक विकल्प है; verify() urlparse, फ़ील्ड मानों और पेज टेक्स्ट से परिणाम को दोबारा जाँचता है।
  • वर्ष जाँच के दो पथ हैं। परिणाम पेज के URL में एक tfs क्वेरी पैरामीटर होता है, verify() उसे base64 डिकोड करके 2026-09-20 ढूँढता है; डिकोड विफल होने पर यह पेज टेक्स्ट में departing 2026-09-20 ढूँढने पर लौट आता है। फ़ील्ड मान Sun, Sep 20 में वर्ष नहीं होता, इसलिए वर्ष अलग से जाँचा जाता है।
  • जाँचें हार्डकोडेड हैं। सभी 7 जाँचें उदाहरण की रूट और तारीख पर एंकर हैं—लक्ष्य बदलने पर verify() भी उसी के अनुसार बदलना होगा (देखें चेतावनी अनुभाग का नियम 2)।

कोई भी आइटम पास न हो, तो passed false हो जाता है और स्क्रिप्ट SystemExit के साथ बाहर निकलती है। इसी को मानक मानें, DONE को नहीं।

आपको यह दिखना चाहिए: artifacts/flights/latest/state.json खोलें, इसके अंदर के verification.checks ऊपर दी गई तालिका के 7 की-नामों से एक-से-एक मेल खाते हैं—हर true के पीछे परिणाम पेज पर एक अभिकथन है, मॉडल की आत्म-रिपोर्ट नहीं।

  • 7 जाँचों में से कम से कम 3 जाँचों के अभिकथन की सामग्री बता सकें

चेकपॉइंट ✅ ​

  • inspector का Google Flights · real web परिदृश्य पूरा चलने पर, Decision trail में निष्पादित एक्शन सूचीबद्ध होते हैं, और स्टेटस बार में Jev reports complete · inspect the page दिखता है
  • examples/flights.py --keep-open चलने के बाद, टर्मिनल "passed": true का verification JSON प्रिंट करता है
  • artifacts/flights/latest/ के अंतर्गत state.json और session.json हैं
  • पूरे दौरान कोई उड़ान नहीं चुनी गई, कोई बुकिंग नहीं हुई—उदाहरण केवल सर्च करता है, बुक नहीं करता (flights.py के डॉकस्ट्रिंग के मूल शब्द: never selects or books a flight)
  • यह स्पष्ट कर सकें कि DONE सफलता का प्रमाण क्यों नहीं है, और verify() परिणाम पेज की जाँच करता है या मॉडल के उत्तर की

चेतावनी अनुभाग ​

❌ DONE को सफलता का प्रमाण मानना ​

लक्षण: agent की स्थिति done हो जाती है, और आप समझते हैं कि कार्य सफल हो गया।

कारण: README में Evidence and limits के अंतर्गत सीधे लिखा है—A DONE choice still requires independent outcome verification। DONE मॉडल का विकल्प है, पेज की स्थिति नहीं; आधिकारिक स्रोत ने आगे भी कहा: एक वैध ऑपरेशन भी गलत हो सकता है (a valid operation can still be wrong)। inspector का स्टेटस संदेश भी स्वयं inspect the page लिखता है।

सही तरीका: verify() का passed देखें, या स्वयं परिणाम पेज की जाँच करें (रूट, तारीख, परिणाम सूची)। भविष्य में अपने ब्राउज़र कार्य लिखते समय (पाठ 5), उसमें भी एक स्वतंत्र सत्यापन जोड़ना चाहिए।

❌ उदाहरण की तारीख अतीत हो चुकी है, results जाँच पास नहीं होगी ​

लक्षण: flights.py चलाने पर results (या date/year) false है, और स्क्रिप्ट Final page did not satisfy the route/date checks के साथ बाहर निकलती है।

कारण: उदाहरण के GOALS और verify() दोनों 2026-09-20 पर एंकर हैं—verify() में चार तारीख अभिकथन हैं: Sun, Sep 20, 2026-09-20 (tfs डिकोड), departing 2026-09-20, Sunday, September 20। यह पेज 2026-11-04 को अपडेट किया गया था, और वह तारीख बीत चुकी है; Google Flights का पिछली तारीखों पर व्यवहार सूचना स्रोतों में नहीं बताया गया है।@@I18N_KEEP_000035@@

सही तरीका: यदि केवल आधिकारिक तरीके को दोहराना है, तो जैसा है वैसा ही चलाएँ (स्क्रिप्ट की प्रक्रिया और सत्यापन लॉजिक सामान्य रूप से चलेंगे; पास होना या न होना Google के पिछली तारीखों पर व्यवहार पर निर्भर है); यदि वास्तविक उपलब्ध उड़ाणें देखनी हैं, तो GOALS में तारीख भविष्य की तारीख से बदलें, और verify() के चार तारीख स्ट्रिंग भी उसी के अनुसार बदलें—ध्यान दें कि Sun, Sep 20 में सप्ताह-दिवस का संक्षेप होता है, नई तारीख का सप्ताह-दिवस वास्तविक रूप से मेल खाना चाहिए (2026-09-20 ठीक रविवार है, इसीलिए मूल पाठ Sun है)।

❌ --env-file .env के बिना स्क्रिप्ट चलाना ​

लक्षण: uv run python examples/flights.py शुरू होते ही KeyError: 'TYPESAFE_API_KEY' थ्रो होता है।

कारण: demo.py शुरू होने पर मौजूदा डायरेक्टरी का .env खुद पढ़ता है, लेकिन flights.py में यह लॉजिक नहीं है—पूरे एनवायरनमेंट वेरिएबल uv run --env-file .env से इंजेक्ट होते हैं। model.py os.environ["TYPESAFE_API_KEY"] से सीधे वैल्यू लेता है, गायब होने पर KeyError।

सही तरीका: कमांड को README के लिखे अनुसार शब्दशः इस्तेमाल करें—uv run --env-file .env python examples/flights.py --keep-open, और रिपॉजिटरी की रूट डायरेक्टरी से चलाएं।

❌ अपने मापे हुए सेकंड से «7 सेकंड» पर सवाल उठाना ​

लक्षण: आपको 8 सेकंड, 9 सेकंड मिलते हैं, inspector में तो दस-बीस सेकंड तक, और लगता है आधिकारिक आँकड़े में पानी है।

कारण: तीन मापदंडों का अंतर—① आधिकारिक टाइमिंग पहली प्रेडिक्शन से शुरू होती है (शुरुआती पेज अवलोकन के बाद) और DONE स्वीकार होने पर खत्म; ब्राउज़र स्टार्टअप, शुरुआती नेविगेशन और बाद का स्वतंत्र सत्यापन इसमें शामिल नहीं; ② Google, नेटवर्क, कैश—सब जीवित हैं, आधिकारिक तुलना के वास्तविक 3 ऑप्टिमाइज़्ड संस्करण रन 6.964–7.913 सेकंड के बीच फैले हैं; ③ inspector में स्क्रीनशॉट चालू है, वो मूलतः टाइमिंग का तरीका ही नहीं है।

सही तरीका: तुलना से पहले मापदंड संरेखित करें (स्क्रिप्ट का चलाने का तरीका, वही URL वही लक्ष्य); टाइमिंग सीमा का पूरा विश्लेषण अगले पाठ परफ़ॉर्मेंस व्याख्या में देखें।

एडवांस टिप्स (वैकल्पिक) ​

--output बदलकर कई रन सुरक्षित रखें। डिफ़ॉल्ट आउटपुट डायरेक्टरी artifacts/flights/latest है, बार-बार चलाने पर ओवरराइट होगा; --output artifacts/flights/run2 जैसा जोड़ने पर हर रन का trace अलग से सेव होगा, तुलना आसान होगी।

अपना खुद का «आधिकारिक वीडियो» रिकॉर्ड करें। रिपॉजिटरी में scripts/record_flights.py <新目录> है, README के निर्देशों से मूल ब्राउज़र टाइमस्टैम्प वाला रन कैप्चर किया जा सकता है। README की चेतावनी नोट करें: live उदाहरण और रिकॉर्डिंग स्क्रिप्ट दोनों पेड API कॉल करते हैं।

आधिकारिक वीडियो के साथ मिलाकर देखें। रिपॉजिटरी का docs/demo.mp4 ही 7,073 ms वाले रन की असली रिकॉर्डिंग है (1× गति); inspector पेज के ऊपर Watch the real Google Flights run लिंक सीधे उसी पर जाता है (demo सर्विस इसे /demo.mp4 पर रूट करती है)। वीडियो में एलिमेंट लेबल रेंडरिंग के समय बाद में जोड़े गए हैं, वे ब्राउज़र को चलाते नहीं।

लक्ष्य बदलकर दूसरी सर्च आज़माएं। inspector का टास्क बॉक्स 1–2000 वर्णों वाले कस्टम लक्ष्य सपोर्ट करता है (demo का सत्यापन नियम)—जैसे तारीख या रूट बदलें। गड़बड़ हो गई और डिफ़ॉल्ट पर वापस चाहते हैं? सीन ड्रॉपडाउन को हटाकर वापस लाएं, लक्ष्य बॉक्स में डिफ़ॉल्ट टेक्स्ट अपने आप भर जाएगा। ध्यान दें: inspector सत्यापन नहीं करता, लक्ष्य बदलने पर नतीजे खुद जाँचें; स्क्रिप्ट में सत्यापन चाहिए तो verify() भी साथ बदलें।

पाठ का सारांश ​

✅ Jev Ultrafast Google Flights रिकॉर्डिंग को दो रास्तों से दोहराया जा सकता है: inspector में स्क्रीनशॉट चालू करके आँखों से देखें (Choose next को धीरे-धीरे चलाएं, प्रोबेबिलिटी क्रम देखें); flights.py बिना स्क्रीनशॉट, स्टॉपवॉच से नापें + ऑटोमैटिक सत्यापन।

✅ एक साधारण भाषा का लक्ष्य ही पूरा इनपुट है—कोई साइट स्क्रिप्ट नहीं, कोई प्री-निर्मित फ़ील्ड स्ट्रिंग नहीं; ?hl=en इंटरफ़ेस को अंग्रेज़ी में पिन करता है, तभी verify() के असर्शन लेबल मैच होते हैं।

✅ 7.073 सेकंड का मापदंड: पहली प्रेडिक्शन से शुरू, DONE स्वीकार होने पर खत्म; इसमें मॉडल कॉल, टेक्स्ट जनरेशन, ब्राउज़र ऑपरेशन, stale निर्णय, लोड प्रतीक्षा शामिल; ब्राउज़र स्टार्टअप, शुरुआती नेविगेशन, बाद का सत्यापन शामिल नहीं।

✅ DONE पर्याप्त नहीं: verify() नतीजा पेज पर 7 स्वतंत्र जाँचें करता है (search_page / one_way / origin / destination / date / year / results), कोई एक भी फेल हो तो स्क्रिप्ट सीधे SystemExit करती है।

✅ उदाहरण 2026-09-20 पर एंकर है: तारीख़ बीत चुकी हो तो या तो स्वीकार करें कि results खाली हो सकते हैं, या लक्ष्य को verify() की चार तारीख़ स्ट्रिंग के साथ बदलें।

मुख्य कमांड और पैरामीटर की समीक्षा:

कमांड/पैरामीटरअनुशंसित मानविवरण
uv run jevरिपॉजिटरी रूट डायरेक्टरी से चलाएंinspector, सीन Google Flights · real web चुनें
uv run --env-file .env python examples/flights.py --keep-openशब्दशःरिकॉर्डिंग दोहराएं + ऑटोमैटिक सत्यापन + trace सेव, ब्राउज़र खुला रहने दिया जाए
--env-file .envअनिवार्यflights.py खुद .env नहीं पढ़ता, छूटने पर KeyError
--keep-openसाथ लेना बेहतरन दें तो रन पूरा होते ही ब्राउज़र बंद
--outputartifacts/flights/latest (डिफ़ॉल्ट)डायरेक्टरी बदलने पर कई रन सुरक्षित रहते हैं

अगले पाठ की झलक ​

सफलता के बाद, अगला पाठ परफ़ॉर्मेंस व्याख्या: 7.073 सेकंड कैसे नापा गया स्टॉपवॉच को खोलकर दिखाएगा। आप सीखेंगे:

  • टाइमिंग सीमा की पूरी परिभाषा: पहली प्रेडिक्शन से DONE स्वीकार होने तक, कौन से चरण शामिल, कौन से नहीं
  • एक रिकॉर्डिंग का पूरा बिल: 17 Jev रिक्वेस्ट, मीडियन लेटेंसी 178 ms, 2 टेक्स्ट जनरेशन, सर्च 5.217 सेकंड पर निष्पादित
  • आधिकारिक बनाम वास्तविक तुलना: टास्क समय 9.450 → 7.092 सेकंड, प्रोटोकॉल कॉल 1,092 → 101, और आधिकारिक खुद क्यों कहता है कि यह सिर्फ़ छोटा नमूना है
  • लागत का मापदंड: 90,558 इनपुट टोकन, टेक्स्ट हेल्पर की दो कॉल $0.00006272 (TypeSafe बिलिंग शामिल नहीं)

परिशिष्ट: सोर्स कोड संदर्भ ​

क्लिक करके सोर्स कोड स्थान देखें

अपडेट समय: 2026-11-04 (रिपॉजिटरी github.com/browser-use/jev-ultrafast, स्थानीय जानकारी स्रोत sources/jev/repo-ultrafast/)

फ़ंक्शनफ़ाइल पथमुख्य स्थान
उदाहरण लक्ष्य और शुरुआती URLexamples/flights.pyL11–15 URL (google.com/travel/flights?hl=en), GOALS (static/index.html के प्री-फ़िल्ड लक्ष्य से मेल)
स्वतंत्र सत्यापन 7 जाँचेंexamples/flights.pyL18–38 verify(): search_page / one_way / origin / destination / date / year (tfs डिकोड या पेज टेक्स्ट दो रास्ते) / results; L63–64 सत्यापन फेल होने पर SystemExit("Final page did not satisfy the route/date checks")
कमांड-लाइन तर्क और trace सहेजनाexamples/flights.pyL43 --output (डिफ़ॉल्ट artifacts/flights/latest); L44 --keep-open; L54–59 state.json / session.json सहेजता है
रन कमांड और "कोई उड़ान न चुनना/बुक न करना"README.md"Use the library": uv run --env-file .env python examples/flights.py --keep-open … does not select or book a flight
7,073 ms टाइमिंग मानदंड और DONE चेतावनीREADME.md, docs/performance.mdREADME "Evidence and limits": Timing starts after initial page observation…; A DONE choice still requires independent outcome verification; performance.md "Where the time went": टाइमिंग accepted DONE choice पर समाप्त होती है, browser setup / initial navigation / post-run verification तालिका से बाहर हैं
वास्तविक रिकॉर्डिंग आँकड़े और तुलनात्मक डेटाdocs/performance.md"Where the time went": 17 अनुरोध / 10 इंटरैक्शन + 1 WAIT / 2 बार helper / माध्यिका 178 ms / 5.217 s / 7.073 s; "Matched runtime comparison": 6.964 / 7.913 / 7.092
inspector परिदृश्य और पूर्व-भरा लक्ष्यjev_ultrafast/demo.pyL44–62 command(): scenario flights → Google Flights URL; goal 1–2000 वर्ण; screenshots=True; L88–91 /demo.mp4 रूट
पैनल नियंत्रण और स्थिति पाठjev_ultrafast/static/index.html + app.jsindex.html L33–37 परिदृश्य ड्रॉपडाउन, L40–44 पूर्व-भरा लक्ष्य और Start demo, L52–59 Slow motion / Choose next / Execute choice / Run automatically, L123–126 Decision trail और Export trace, L132–136 What the model sees; app.js L82–88 स्थिति पाठ (Jev reports complete · inspect the page), L160–168 Choose→predict / Execute→act, L173–186 Slow motion प्रत्येक चरण पर 450 ms रुकता है, L217–235 typesafe-browser-trace.json निर्यात
निर्णय लूप और स्थितिjev_ultrafast/agent.pyL163–165 run(); status ∈ ready/predicted/done/blocked; L102–104 MAX_STEPS=60 एक्शन बजट; L153–157 लगातार 3 बार अमान्य एक्शन पर blocked
मॉडल निर्देश का मूल पाठjev_ultrafast/questions.pyNEXT_ACTION (तिथि पिकर CLICK फ़ील्ड/तिथि/पुष्टि, ऑटोकंप्लीट सुझाव, DONE को दृश्य साक्ष्य चाहिए, WAIT शर्त, Search तुरंत क्लिक); MAX_STEPS = 60
Key पढ़ने का तरीकाjev_ultrafast/model.pyL119 os.environ["TYPESAFE_API_KEY"] (अनुपस्थित होने पर KeyError उठाता है); L160–168 की field_text() जाँच TEXT_MODEL_API_KEY
टेक्स्ट helper आउटपुट बाध्यताएँjev_ultrafast/model.pyL187–193 आउटपुट एकल-की {"text": …}, गैर-रिक्त, ≤2000 वर्ण होना चाहिए, अन्यथा टाइप नहीं करता
trace git में नहीं जाता.gitignore.env, .venv/, artifacts/ सभी उपेक्षित हैं
रिकॉर्डिंग स्क्रिप्टscripts/record_flights.pyREADME "Development": captures original browser timestamps; live उदाहरण और रिकॉर्डिंग स्क्रिप्ट सशुल्क API कॉल उत्पन्न करते हैं
gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.