Практычныя прытамулкі: Как выкарыстаць Gemini Managed Agents разам з Google Apps
Практычныя прыказкі: як выкарыстаць Gemini Managed Agents з Google Apps — контракты, пераконтрэнне та месцы для додавання коду для команд, якія викорыстоўваюць гэты патэрн.
Наступныя прытамкі паказваюць практычны падход да рэшэнкі задачы «Адпрацоўка Gemini Managed Agents з Google Apps Script». Акцэнт ставіцца на кантракты, пераконтрацыі і месца для коду, а не на мотывацыйныя аспекты.
Абстракт
Калі працуеце над стадзіяй абстрактнага опису, спачатку запісайце кантракт: неабяжныя даны, сігнал успеху і тое, што выканаецца у разы частковага нявыполнення. Такі список пераконтрацый дапамагае залічыць пазнейшыя змены ў кодзе. Валіце маленькія, тэставаныя елементы замест амаль неканчатых скрыптав. Калі якісь крок не выйшае, прычына нявыполнення павінна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцюг задач. Запісвайце ідэнтыфікатор запиту, ідэнтыфікатор моделі і час адпаведзення праз кожны вызов. Без такога лёгкага следу періядычныя проблэмы падрыхтавальніка выглядаюць як багі самай аплікацыі.
Введэнне
Калі працюеце над стадзіяй введэння, спачатку запісайце контракт: неабяжлівыя даннэ, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі список пераконтроўвае чыстасць пазнейшых змян у кодзе. Спрыймайце гэтую стадзію як контракт межа даннэмі і перакананымі выходамі. Дайце назву рэзультатам, задаце критэрыя успеху і не падзволяйце частковаму завершэнню без паведамлення. Зявляйце логі з ідэнтыфікаторам запросу, ідэнтыфікаторам моделі і часам затрымкі праз кожны вызов. Без такога следу періодычныя памылкі прадастаўця выглядаюць як багі ў прыемніку.
Архітэктурны парадыгм: Чаму самэ працяванне з хмарамі напрасцо?
Калі працуеце над стадзіяй «Прычыны прымусовага спосабу» ў архітектурным парадыгме, спачатку запісайце умовы: неабяжныя вхідныя даны, сигнал успеху і тое, што выканаецца у разы частковага нявучнасці. Такі список контроля дапамагае заставіць пазнейшыя змены коду быць чыстымі. Запісвайце час выканання і кост токена або запиту праза функцыональнымі рэзультатамі. Відразувая візуабельнае прадставлення костаў, ухілваецца ад неспакою, калі процес пераходзіць з дэмаверсіі ў спяльныя среды. Запісвайце ID запиту, ID модэлю і час затрымкі праз кожны вызов. Без такога лёгасу періядычныя памылкі прадаўцу выглядаюць як багі ў самай прыемлівай.
Значныя заўтрэчкі костаў вхідных токенаў за дапамогою двунаправленага стрімування
Калі працюеце над стадзіяй «Рэштычна еканомія токенаў вводу», спачатку запісайце контракт: неабходныя даны вводу, сігнал успеху і тое, што выходзіць пад частым неудачам. Такі список пераканае ў тым, што пазнейшыя змены коду будуць чыстымі. Зберагайце настройкі параду ўнутры коду аплікацыі. Файлы сераўнавання, хранільнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаць адбавіць аудыт без неабходнасці чытання всей структуры. Зяўляйце логі з ідэнтыфікаторам запиту, ідэнтыфікаторам моделі і часам затрымкі праз кожны вызов. Без такога следу періадычныя бяги прадастальніка выглядаюць як багі аплікацыі.
Скорачэнне вартасці працэсу за дапамойю спяльных, стаячых сандбоксаў
Калі працуеце над скасоўванням витак у процесе паэтапна, спачатку запішыце угоду: неабходныя даны, сигнал успеху і тое, што відбываецца у разы частковага невдачы. Такі список пераконвае ў тым, што пазнейшыя змены коду будуць чыстымі. Запісуйце адночасна шлях успеху і шлях вярнення. Перапрыбуткі, людзкі контроль і обработка некоректных паведамленняў є частью продукту, а не пазнейшым дапрацоўкам. Зявляйце логі з ідэнтыфікаторам запиту, ідэнтыфікаторам моделі і часам затрымкі праз кожны вызов. Без такога следу періодычныя памылкі прадавца выглядаюць як багі прыложэння. Калі працуеце над скасоўванням витак у процесе паэтапна, спачатку запішыце угоду: неабходныя даны, сигнал успеху і тое, што відбываецца у разы частковага невдачы. Такі список пераконвае ў тым, што пазнейшыя змены коду будуць чыстымі. Спрыймайце гэты этап як угоду між вхіднымі данымі і перакананымі выходнымі рэзультатамі. Даўце назвы артыфактам, задаце критэрыя успеху і не падтрымайце тых, хто вяршыць роботу часткова без паведамлення.
Рабочы процес
Этап рабочага практыкуму працюе наяўней, калі яго спрыяваць як мерыемую плошчу. Запісаўце адна ідеальная транскрыпцыя, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расширваць масштабы. Запісвайце часы выканання і косты токеноў або запытаў разам з функцыйнаімі рэзультатамі. Відразлівае прадставленне костаў з’являецца перашкоду неспакойным рахункам, калі процес пераходзіць з дэмавайнага режыма ў спяльныя среды. Закрепіце інтэрпретара і файл з правіламі залежнасцяў пры навучэнні циклу. Разлік межаў між ноутбукам і системай CI ёсць найчастэйшым таямным перывам у дэмавайных працэсах API.
Репазітарый
Этап Repository працюе найкраща, калі яго розглядаць як меркавыя плошча. Запісайце адна ідеальная версія, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расширваць сферу дзеяння. Зберагаюце настройкі пазыроўна ад коду прыемлівача. Файлы сераўнавання сяродовішча, хранілішчы секрэтных данных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаць адбавіць аудыт без неабяжнага чытання всіх дадзеных. Закрепіце інтэрпретара і файл з блокаванням залежнасцей перш чым выкладзаць матэрыял пра ціклы. Разніця межу лептапам і системай CI ёсць найчастэйшым таямным факторам, які спрабоўвае зламаць дэманстрацыі API.
Іспользованне
Этап выкарыстоўвання працюе наякша, калі яго спрыяваць як мерыемую плошчу. Зафіксавайце адны ідеальны прыклад работы, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расширваць сферу дзеяння. Дакументавайце як шлях успеху, так і шлях вярнэння да нормальнага стану. Перапрыбуткі, людзкі контроль і обработка некоректных паведамленняў є частью продукту, а не етапамі далейшай наладкі. Зафіксавайце інтэрпретара і файл з правамі на выкарыстоўвання зависімасцей пры тэставанні циклаў. Разлікі межы ноутбука і системы CI є найпашчэрэйшым безследным нарушэнням пад час деманстрацый API.
1. Атрымайце ключ Gemini API
Этап 1: Адаптаванне Gemini API працюе наяўней, калі яго розглядаць як мерыемую структуру. Зафіксавайце адну успешную транскрыпцыю, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану, перш чым расширваць сферу прыемлівання. Валідзіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выйшае, прычына неудачы павінна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцюг задач. Зафіксавайце версію інтэрпретара та файлы з правіламі залежнасцяў прыштою, перш чым выучаць циклы. Разніця ў версіях між ноутбукам і системай CI — гэта самая частая прычына непрацясці пад час дэманстрацый API.
2. Стварэнне проекта Google Apps Script
Этап 2 «Стварэнне Google Apps» работае наяўней, калі яго спрыяваць як мерыемую плошчу. Зафіксавайце адны ідеальны прыклад, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расширваць масштабы. Спрыяйце гэтаму этапу як кантракту межаў вхідных дадзеных і перакананых выходных рэзультатаў. Дайце назвы артыфактам, задаць критэрыя успеху і адмовіцеся ад тыхоўскага частковага завершэння. Закрепіце інтэрпретара і файл з правамі на завісу залежнасцяў пры выкладчэнні циклу. Адхіленне межаў ноутбука і системы CI ёсць найпашчэрэйшым тыхоўскім нарушэнням пад час дэманстрацый API.
3. Развярнуць кліентскія скрыпты і задаць ўласті скрыптам
Этап 3 «Развяроць кліентскія скрыпты» работае наўлучней, калі яго спрыяваць як мерыемую плошчу. Зафіксавайце адны ідеальны прыклад роботы, адзін прыклад неудачы і запіс пра абратку змян перш чым расширваць сферу дзеяння. Запісвайце часы выконання і вартасць токена або запиту разам з функцыональнымі рэзультатамі. Відразлівае паказанне вартасцей запобегае неспадзячым рахункам, калі процес пераходзіць з дэмаверсіі ў спяльныя сераўы. Закрепіце інтэрпретара і файл з правамі на выкарыстоўванне залежнасцей пры навучэнні циклу. Разлікі межаў лептапа і системы CI ёсць найпашчэрэйшым таямным абаранкам для дэмаверсій API.
4. Неабяжныя дыяпазоны автарызаціі
Этап 4 «Неабяжлівыя сферы аўтарызацыі» работае наякрацэ, калі яго спрыяваць як мерыемую плошчу. Зафіксавайце адны ідеальны прыклад роботы, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расширваць сферу. Зберагаюце настройкі пазырочна ад коду прыемлівання. Файлы сераўнавальнага сераўса, хранілішчы секрэтных дадзеных і флагі функцый должны знаходзіцца ў аднам месцы, куда аператары можуць адбавляць контроль без неабяжлівага чытання всей структуры. Закрепіце інтерпрэтара і файл з правамі на залежнасці пры пачатку роботы з цикламі. Разніця ў настройках межаў лептапа і сераўса CI ёст тыповай прычынай непазначальных бядаў у дэманстраціях API.
Тэставанне ў хмаре (Google Apps Script)
Этап тэставання на платформе Google Cloud працюе найкраща, калі яго спрыяваць як меркаваную плошчу. Зберагачыце адны ідеальны прыклад роботы, адзін кейс неудачы і прыметкі па адвярненню перад расшырэнням масштаба. Дакументавайце як успішны, так і варыянт вярнення да нормальнага стану. Перапрыбуткі, людзкі контроль і обработка некоректных паведамленняў ёсць часткай продукту, а не элементамі пазнейшага дапрацоўкі. Закрепіце інтэрпретара і файлы з правіламі залежнасцяў прытым, калі ўчыцеся пра циклы. Разніця межу лэптопам і системай CI ёсць найчыстае, але частае нарушэння падчас деманстрацый API. Этап тэставання на платформе Google Cloud працюе найкраща, калі яго спрыяваць як меркаваную плошчу. Зберагачыце адны ідеальны прыклад роботы, адзін кейс неудачы і прыметкі па адвярненню перад расшырэнням масштаба. Спрыявайце гэты этап як кантракт межу вхіднымі даннымі і перакананымі выходнымі рэзультатамі. Даўце назвы артыфактам, задаць критэрыя успеху і адмовіцеся ад непазначальнага частковага завершэння.
1. Абеспечэнне едынай сандбокс-сістэмы Linux
Для першага «Падчырэж адзінавочнай стадзіі» неабяжна ўскладніць вхідныя даны, адпаведальную особу за кожны крок і критэрыі завершэння пры перадзеяванні коду. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю, не прабуючы спадарацца пра схованы стан. Запісваюць час выконання і вартасць токена або запыту разам з функцыйнальнымі рэзултатамі. Відразы вартасці з самага пачатку запобегае неспакоўным рахункам, калі процес пераходзіць з дэмовай среды ў спакульную. Раздзеляйце стварэнне кліента ад цыклу паведамленняў, каб было можна змяніць прадаўцаў без перапісвання машыны стану дыялогу.
2. Тэст 1: Адзінавочка User-Agent і перакананне POSIX Socket (runTest1_UserAgentComparison)
Для стадіі 2 Test 1 User-Agent неабяжна ўзначыць вхідныя даны, адпаведальнага за крок і крэтыяры завершэння пры перадзеіснаванні коду. Аператары должны магчымаць перзапуск кроку з вядомай точкі контролю, не спрабоўваючы здагадвацца пра схованы стан. Конфігурацыю трэба залічыць паза кодам прыкладнення. Файлы сераўіса, хранільнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, якое аператары можаць пераглядаць, не чытаяўшы весь ланцуг. Аддзельнай трэба залічыць стварэнне кліента ад циклу паведамленняў, каб можна было змяніць прадаўцоў без перапісвання машыны стану размовы.
3. Тэст 2: ggsrun – развяртанне і перакранчэнне верыфікацыі прымітання безпосередньага доступу (runTest2_GgsrunDirectDeployment)
Для стадіі 3 Test 2 ggsrun неабяжна ўзначыць вхідныя даны, адпаведальнага за крок і крэтыяры завершэння пры зміне коду. Аперацыйныя працавнікі должны магчымае перайсці на выкананне кроку з вядомага пункта контролю, не спрабоўваючы здагадвацца пра схованы стан. Неабяжна задокументаваць як шлях успеху, так і шлях вярнення да нормальнага стану. Перапрыбуткі, людзкія перакрыцця і обробка некоректных паведамленняў є часткай продукту, а не чымсь, што дадаецца пазней. Аддзельнаюць стварэнне кліента ад цыклу паведамленняў, таким чынам дазволяючы змініць прадаўцаў без перапісвання машыны стану размовы. Для стадіі 3 Test 2 ggsrun неабяжна ўзначыць вхідныя даны, адпаведальнага за крок і крэтыяры завершэння пры зміне коду. Аперацыйныя працавнікі должны магчымае перайсці на выкананне кроку з вядомага пункта контролю, не спрабоўваючы здагадвацца пра схованы стан. Спрыяйце цій стадіі як кантракту межаў вхідных дадзеных і перакананых выходных рэзультатаў. Даць назвы артыфактам, узначыць перакрыцці успеху і адмовіцца ад беззвучнага частковага завершэння.
4. Тэст 3: Абрабатка дадзеных за дапамою Playwright без адмінскага інтерфейсу для аплодзення на прымойны драйв (runTest3_PlaywrightDirectUpload)
Калі працуеце над 4-м тэстам 3 стадіі Playwright, спачатку запісайце умовы: неабяжлівыя даннэ, сігнал успеху і тое, што выходзіць на падзею частковага няўспэху. Такі список дапамагае заліцьварыцца пад пазнейшыя змены коду. Запісвайце час выканання і вартасць токена або запытку празаўсёды разам з рэзультатамі функцыйнасці. Відразлівая вартасць з самага пачатку запобегае неспакою, калі працэс пераходзіць з дамоўнага режыму ў спяльныя среды. У кожнам запытку лічуце ідэнтыфікатор запытку, ідэнтыфікатор моделі і час затрымкі. Без такога лёгкага стэйтусу перыядычныя канфлікты з прадаўцам выглядаюць як багі ў самай аплікацыі.
5. Тэст 4: Сінтэза аудыя за дапамою FFmpeg і транскодаванне для аплодзення на прымойны драйв (runTest4_FFmpegAudioDirectUpload)
Калі працюеце над 5-м прабамом 4-й стадзіі FFmpeg, спачатку запісайце умовы: неабяжлівыя даннэ, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі список дапамагае заліцьваты чыстасцю пазнейшых змян у кодзе. Храніце настройкі параду ўнутры коду прыемлі. Файлы сераўіснага сэрвісу, храненні секретных данных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаць пераглядаць іх без неабяжлівага чытання всей структуры. Запісвайце ID запытку, ID модэлю і час адклікання па кожным вызове. Без такога лёгкага стэйт-хісторыя періодычныя кантынгенты прабавальнага сервісу выглядаюць як багі ў самай прыемлі.
6. Прабам 5: Выяўленне AST у TypeScript і пакетаванне з esbuild для адразовага заваносу на дрыў (runTest5_TypeScriptASTDirectUpload)
Калі працюеце над стадзіяй 6 Test 5 TypeScript, спачатку запісайце контракт: неабяжлівыя данні, сигнал успеху і тое, што выходзіць пад частковым нявыпаннем. Такі список пераконвае ў тым, што пазнейшыя змены коду будуць чыстымі. Документавайце як шлях успеху, так і шлях вярнення. Перапрыбуткі, людзкія контралі і обработка некоректных паведамленняў ёсць частью продукту, а не пазнейшым дапрацоўкам. Зявляйце логі з ідэнтыфікатарам запиту, ідэнтыфікатаром моделі і часам затрымкі праз кожны вызов. Без такога следу періодычныя памылкі прадастаўця выглядаюць як багі ў прыемніку. Калі працюеце над стадзіяй 6 Test 5 TypeScript, спачатку запісайце контракт: неабяжлівыя данні, сигнал успеху і тое, што выходзіць пад частковым нявыпаннем. Такі список пераконвае ў тым, што пазнейшыя змены коду будуць чыстымі. Спрыймайце гэтую стадзію як контракт межа даннімі і перакананымі выходнымі даннымі. Даўайце назвы элементам, задаць правілы пераканання успеху і не падтрымайце тыхню частковую завершэння.
7. Тэст 6: Кантрольныя показнікі выконвальных спроможнасцей: адказычны заванос ggsrun протык упакавання Base64 через GAS (runTest6_DriveUploadPerformanceComparison)
Этап выконвальных спроможнасцей 7 Тэст 6 дае найлепыя рэзультаты, калі яго спрыяваць як меравальную плошчу. Запісаўце адна ідеальная транскрыпцыя, адзін прыклад неудачы і прыметку па адвярнуцьці перад расшырэнням масштаба. Запісвайце часы выканання і косты токена або запытку празаўсёды з функцыйнальнымі рэзультатамі. Відразлівае паказанне костаў запобегае неспадзяваным счыткам, калі працэс пераходзіць з дэмавайнага режыма ў спяльныя среды. Закрепіце інтэрпретара і файл з правіламі завіскі залежнасцяў прычыму вучэння ціклу. Разлік межаў між ноутбукам і CI ёсць найчастэйшым таямным абрывам дэмавайных працэсаў API.
================================================================================
PERFORMANCE BENCHMARK REPORT: 10,000 BYTES FILE TRANSFER TO GOOGLE DRIVE
================================================================================
| Metric | Approach A: Direct ggsrun Upload | Approach B: Base64 via Gemini API -> GAS |
| :--------------------------- | :------------------------------- | :--------------------------------------- |
| Transfer Method | Direct Sandbox-to-Drive (Go CLI) | Base64 Stream -> GAS -> Drive |
| Drive File Name | benchmark_10kb_ggsrun.bin | benchmark_10kb_gas.bin |
| Verified File Size | 10,000 bytes (9.77 KB) | 10,000 bytes (9.77 KB) |
| API Turns Required | 1 Turn (Direct Offload) | 1 Turn (Base64 Retrieval) |
| Local GAS Processing Time | 0.00 s (Zero CPU overhead) | 1.23 s (Base64 Decode & Blob Creation) |
| Total End-to-End Duration | 16.20 s | 32.13 s |
| Effective Throughput | 0.60 KB/s | 0.30 KB/s |
| Performance Multiplier | 1.98x FASTER | Baseline (Higher Latency & Token Usage) |
================================================================================
Тэставанне на локальных рабочых станцыях (Node.js Stream Runner)
Этап тэставання на локальных рабочых станцыях дае найкращыя результаты, калі яго розглядаць як меравальную плошчу. Зафіксавце адна ідеальная версія выходу, адзин случай неудачы і прыметкі па поверненню да пачатковага стану пры розширэнні масштаба. Зберагайце настройкі пазначыта ўнутрь аплікацыйскага коду. Файлы сэрава, хранільнікі секретных данных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куда аператары можуць адрабатваць контроль без неабяжнага чытання всіх дадзеных. Закрепіце інтэрпретара і файлы з інформацыяй пра залежнасці пры практыкуванні циклаў. Разлікы межу ноутбукам і системай CI ёсць найчастэйшым таямным факторам, які спрабоюе зламаць працэс деманстрацыі API.
1. Мэта і прыямнікі локальнага виконавца стрымаў
Этап «1. Мэтас і прыямліванні» работае наўзярэджэй, калі яго спрыягаць як мерымабельную паверхню. Запісаць адны ідеальны транскрыпт, адзін прыклад неудачы і прыметку па адвярненню перад расшырэнням масштаба. Дакументаваць як шлях успеху, так і шлях вярнення. Перапрыбуткі, людзкія контралі і обработка некоректных паведамленняў ёсць часткаю продукту, а не пасляднім дапрацоўкам. Зафіксаваць інтэрпретара і файл заблокавання залежнасцяў прычыму навучэння ціклу. Разлік меж лептапа і CI — гэта найчастэйшыя таямніцкія збоі пад час дэманстрацый API. Этап «1. Мэтас і прыямліванні» работае наўзярэджэй, калі яго спрыягаць як мерымабельную паверхню. Запісаць адны ідеальны транскрыпт, адзін прыклад неудачы і прыметку па адвярненню перад расшырэнням масштаба. Спрыягаць гэты этап як кантракт межа вхіднымі дадзеннямі і паверынутымі выхіднымі рэзультатамі. Даць назвы артыфактам, задаць перакананні на успех і адмовіцца ад таямнічага частковага завершэння.
2. Локальная наладка і адклэянне тэстаў
Для локальнай наладкі і стадыю працы неабяжна прадзеўначыць вхідныя даны, адпаведальнага за кожны крок і крэтыяры завершэння працы перад зменым коду. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю, не прабуючы спадарацца пра схованы стан. Запісваць час выконання і кост токена або запыту разам з функцыйнальнымі рэзултатамі. Відразы коста з самага пачатку запобегае неспакоўным рахункам, калі праця пераходзіць з дэмаверсіі ў спакульнаныя сераўысы. Аддзельна трэба выконваць стварэнне кліента і цыкл перадачы паведамленняў, каб можна было змяніць прадстаўніка без перапісвання машыны стану размовы.
Дадатак: Шаблоны выкарыстоўвання API Gemini Managed Agents
Для стадіі Appendix Gemini Managed Agents неабяжна ўзначыць вхідныя даны, адпаведальнага за крок і крэтыяры завершэння пры змены коду. Аператары должны магчымаць перзапуск кроку з вядомай точкі контролю, не падозрываючы схованы стан. Конфігурацыю трэба залічыць пазначальна ад коду прыкладнення. Файлы сераўіса, хранільнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, якое аператары можаць пераглядаць, не чытаяўшы весь граф. Аддзельнай трэба выконванне канструявання кліента ад цыклу паведамленняў, каб можна было зменіць прадаўцоў без перапісвання машыны стану размовы.
Базавы канец
Для стадіі Base Endpoint неабяжна ўзначыць вхідныя даны, адпаведальнага за крок і крэтыры завершэння пры змяне коду. Аператары должны магчымаць перзапуск кроку з вядомай точкі контролю, не падозрываючы схованы стан. Неабяжна задокументаваць як шлях успеху, так і шлях вярнення. Перапрыбуткі, людзкіе перакрыцця і обробка некоректных паведамленняў є часткай продукту, а не чымсь, што дадаецца пазней. Раздзеліце стварэнне кліента ад цыклу паведамленняў, каб можна было змяніць прадаўцаў без перапісвання машыны стану размовы.
POST https://generativelanguage.googleapis.com/v1beta/interactions?key=${API_KEY}
Content-Type: application/json
Сцэнарый 1: Адна стойкая сандбокс-сераўерная среда для кальколька кліентаў
Для сцэнарыю 1 «Адзіна сцэна» неабяжна прадзефінаваць вхідныя даны, адпраўніка крока і критэрыя завершэння пры перадзеўранні коду. Аператары должны магчымае перзапускать крок з вядомай точкі контролю, не падозрываючы прыхованы стан. Лепш выбіраць маленькія, тэставаныя елементы заместо велікіх скрыптав. Калі крок не выйшоў, прычына неудачы павінна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцужок задач. Раздзеляйце стварэнне кліента ад цыклу перадачы паведамленняў, каб было можна змяніць прадаўцоў без перапісвання машыны стану размовы.
{
"agent": "antigravity-preview-05-2026",
"input": "Run task in shared container...",
"environment": "environments/env-12345"
}
Сцэнарыю 2: Іспытанне ізольаванных сэндбоксаў для кожнага выканання
Для сцэнарыю 2 з выкарыстоўванням ізольаванага этапу неабходна прадзефініраваць вхідныя даны, адпаведальнага за крок і критэрыя завершэння пры перадзмене коду. Аператары должны магчыма было перзапускаць крок з вядомай точкі контролю, не спрабоўваючы здогадвацца пра схованы стан. Спрыяйце цэму этапу як даговору між вхіднымі данымі і паўнастацэннымі выходнымі результатамі. Дайце назвы артыфактам, прадзефініруйце перакананняя пра успех і адмовіцеся ад беззвучнага частковага завершэння. Аддзельце стварэнне кліента ад цыклу паведамленняў, каб было можна змяніць прадастаўцаў без перапісвання машыны стану дыялогу.
{
"agent": "antigravity-preview-05-2026",
"input": "Execute client-specific isolated task...",
"environment": {
"type": "remote"
}
}
Сцэнарыю 3: Зберагчэнне контексту багатапартійнага дыялогу
Для стадіі «Зберагчэнне кантэкста пасля калькоў» у сцэнарыі 3 неабходна пазначыць вхідныя даны, абавесця крока і крэтынія выходу пры перадзеўці коду. Аператары должны магчымае запускаваць крок з вядомай точкі контролю, не прабуючы спадарацца пра схованы стан. Запісваць час выконання і кост токенаў або запытаў разам з функцыйнальнымі рэзультатамі. Відразлівая видавальнасць костаў з’являецца перашкодай неспакойным рахункам, калі траекторыя пераходзіць з дэмавай версіі ў спяльныя сераўы. Раздзеляць стварэнне кліента ад цыклу паведамленняў, каб было можна змяніць прадаўцаў без перапісвання машыны стану размовы.
{
"agent": "antigravity-preview-05-2026",
"input": "Based on the previous output, proceed to step 2...",
"environment": "environments/env-12345",
"previous_interaction_id": "interaction-prev-67890"
}
Сцэнарый 4: Перадзеўжанне піскулярнай среды з чыстым кантэкстам (freshInteraction)
Для стадіі парадыгмы 4 «Павтарэнне выкарыстоўвання Sandbox» неабходна прадзефінаваць вхідныя даны, адпаведальную особу за кожны крок і крэтыяры завершэння працы перад зменым коду. Аператары должны магчымае павтараць виконанне крока з вядомай точкі контролю, не падозрываючы прыхованы стан. Конфігурацыю трэба залічыць паза кодам прыемліка. Файлы сэрאве, храненні секретных данных і флагі функцый кануць у аднам месца, якое аператары можаць пераглядаць, не чытаяўшы весь лянцуг задач. Трэба аддзеліць стварэнне кліента ад цыклу перадачы паведамленняў, каб было можна змяніць прадаючыхася сервісы без перапісвання машыны стану размовы.
{
"agent": "antigravity-preview-05-2026",
"input": "Execute a completely new task in the existing sandbox...",
"environment": "environments/env-12345"
}
Матрыца падсумкаў
У стадії матрыцы падзеяў неабходна з’явіць вхідныя даны, адпаведальнага за крок і критэрыя завершэння прычым перад змінайом коду. Аператары должны магчымае запускаваць крок з вядомай точкі контролю, не прабуючы спадарацца пра схованы стан. Неабходна задокументаваць як шлях успеху, так і шлях вярнення. Перапрыбуткі, людзкіе перакрыцця і обробка некоректных паведамленняў є частью продукту, а не елементамі пазнейшай дапрацоўкі. Неабходна адсорваць стварэнне кліента ад цыклу паведамленняў, каб можна было зменіць прадаўцаў без перапісвання машыны стану размовы.
Падсумак
У стадії падробнага аналізу неабяжна ўважна вказаць інпуты, адпаведальную особу за крок і крэтынія выходу пры перадзеўці коду. Аператары павінны магчымаць перзапуск крока з вядомай точкі контролю без адгадванняя схованага стану.
Чэк-ліст для эксплуатацыі
У стадії чэк-ліста для эксплуатацыі неабяжна ўважна вказаць інпуты, адпаведальную особу за крок і крэтынія выходу пры перадзеўці коду. Аператары павінны магчымаць перзапуск крока з вядомай точкі контролю без адгадванняя схованага стану.
Лепшыя маленькія, тэставальныя елементы чым велікія скрыпты. Калі якісь крок не выйшае, адказка за гэта паталест на адну адпаведальнасць, а не на заплутаны ланцюг задач.
Раздзеліце стварэнне кліента ад цыклу обработкі паведамленняў, ўпрымкі можна будзе змяніць без перапісвання машыны стану дыялога.
Зробіце контрольны пункт пасля дорогіх крокаў. Функцыя продакцыі не должна зноў выклікаць той самы календар LLM, калі аператар прабуе зноў выконаць пазнейшы вузел.
Закрепіце версіі залежнасцяў і запісаце хэш адпрацоўванага зображэння. Возможнасць перадзвічання результатаў важлівей, чым традыцыйныя знання.
Зберагачыце настройкі параду ўнутры коду аплікацыі. Файлы сяродавысці, хранільнікі секрэтных дадзенняў і флагі функций должны знаходзіцца ў аднам месцы, якое аператары можаць пераглядаць без неабходнасці чытання всей структуры.
Перш чым запускать апгрэйд, заморозьце версіі, зафіксавце «золаты» транскрыпты для критычных шляхоў і паказваце способы атрыбуцыі. У спадзяльных средах неабходны ліміты частоты запуска, пераканання ў належнасці тэнантам і чысткі власнік для ротацыі секрэтных даных. Валіце надзейнасць працы над красавіми разовымі дэманстрацыямі.
Прымечанне для 19215ab8c61f: не кладзіце ключы прадастальніка ў репазітарый, задаце верхнюю межу токена на кожную сесію і зберагачыце транскрыпты празаўседы ў фіксы для ацэнкі, каб пазнейшыя замены моделяў заставаліся пораўнанымі.