Практычныя прытамулкі: OKF ад Google: Адна польа, розумнейшыя AI-агенты

У гэтым керавану практычна перакладзець шлях ад сыр'ёў да рабочай системы для проекта Google OKF: One Field, Smarter AI Agents. Акцэнт ставіцца на практычныя крокі, чыстае перакананне ў правильнасці дзействаў і код, які можна проста дадаць у репазітарый без неабязковасці з'ясоўвання меты. У стадіі агульнага відзору неабходна з'явіць вхідныя даны, адпаведальнага за крок і критэрыя завершэння пры перамены коду. Аперацыйныя працавнікі должны магчымае перадзеяць крок з вядомай точкі контролю, не прабуючы здогадвацца пра схованы стан. Неабходна аддокументаваць як шлях успеху, так і шлях вяснавання проблем. Перапрыбуткі, людзкія перакананні і обробка некоректных паведамленняў є частью продукту, а не чымсь, што дадаецца пазней.

Проблема: агенты постаянна перавучаюцца тое ж самае

Калі працуеце над рашыяннем задачы, спачатку запісайце умовы кантракту: неабяжлівыя даны, сігнал успеху і тое, што выходзіць пад частым неудачам. Такі список пераканаець у тым, што пазнейшыя змены коду будуць чыстымі. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выйшае, неудача должна вказваць на адну адпаведальнасць, а не на заплутаны ланцужок задач. Зробіце перапактаванне пасля дорогіх крокаў. Програма не должна зноў выклікаць той самы LLM-званак, калі аператар прабуе зноў запрацаваць з пазнейшым вузлом.

Рашэнне: формат, а не большая модель

Калі працуеце над стадзіяй «Выправленне формата», спачатку запісайце контракт: неабяжлівыя даннэ, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі список перакладзець пазнейшыя змены коду ў правільны направленні. Спрытывайце гэту стадзію як контракт межа даннемі і перакананымі выходамі. Дайце назву рэзультатам, задаце критэрыя успеху і не падзволяйце частковаму завершэнню без паведамлення. Зберагаеце у кэшы стабільныя інструкцыі системы і схемы інструментаў. Перадача тых самых прамэры ёсць частым выклікам зайвых ресурсаў.

---
type: Metric   # required – tells the agent what kind of concept this is
---

| Field         | Purpose                      |
| ------------- | ---------------------------- |
| `title`       | Human-readable name          |
| `description` | Short summary                |
| `resource`    | Link to the underlying asset |
| `tags`        | Keywords for categorization  |

Супакі ператвараюць файлы на граф знанняў

Калі працуеце з Links turn files into stage, спачатку запісайте умовы викорыстоўвання: неабходныя даны, сігнал успеху і тое, што выходзіць, калі адбываецца частковая нявыплненасць. Такі список контролю дапамагае заставіць пазнейшыя змены коду быць чыстымі. Запісвайце час виконання і кост токена або запыту праза функцыйнальныя рэзултаты. Відразувая візуабельнасць костаў запобегае неспакойным рахункам, калі процес пераходзіць з дэмаверсіі ў спяльныя среды. Зробіце контрольную паўзу пасля дорогіх крокаў. Система адновлення не должна зноў нараховваць плата за той самы вызыв LLM, калі аператар прабуе зноў виконаць пазнейшы элемент. Калі працуеце з Links turn files into stage, спачатку запісайте умовы викорыстоўвання: неабходныя даны, сігнал успеху і тое, што выходзіць, калі адбываецца частковая нявыплненасць. Такі список контролю дапамагае заставіць пазнейшыя змены коду быць чыстымі. Дакументавайце як шлях успеху, так і шлях вярнення да нормы. Прабулі, людзкія контролі і обработка некоректных паведамленняў є частью продукту, а не чымсь, што дадаецца пазней.

---
type: Metric
title: Monthly Revenue
description: Total money earned each month.
resource: https://console.cloud.google.com/bigquery?p=project&d=dataset&t=revenue
tags: [finance, monthly]
---

Revenue is counted after refunds are removed.

See also: [customer_acquisition_cost.md](customer_acquisition_cost.md)

Спробуйце самі за пяць хвілін

Функцыя «Паспрабуй сам» у роўні этапа працюе найкраща, калі яе розглядаць як вимерную паверхню. Запісаўце адна «золатая» версія, адин прыклад неудачы і прыметку па вярнэнню да поперадней версіі пры расшырэнні масштаба. Волейце маленькія, тэставаныя елементы замест большых скрыптаў. Калі якісь крок не выйшоў, прычына неудачы павінна вказываць на адную адпаведальнасць, а не на заплутаны ланцюг задач. Рэзультаты роботы графа трэба зберагаць у простай форме з адзінаковым типам дадзеных. Вярсткаваныя блокі маскуюць інфармацыю пра тое, який вузел запісаў канкрэтны поле, і спакшуюць продажчыку роботу пасля перарываў.

git clone https://github.com/GoogleCloudPlatform/knowledge-catalog.git
cd knowledge-catalog/okf

# Add your own concept
cat > new_metric.md <<'EOF'
---
type: Metric
title: Net Promoter Score
description: Measure of customer loyalty.
resource: https://console.cloud.google.com/bigquery?p=company&d=metrics&t=nps
tags: [customer, loyalty]
---
EOF

Чаму вам насправды можа знадобіцца гэта (прыямныя выгоды)

Этап «Прычыны», калі яго расследаваць як вимерную плошчу, працюе найэфектывнейша. Запісаўце адна «золатая» транскрыпцыя, адзін прыклад неудачы і запіс пра вярнэнне да поперадньага стану, прычым расшырюючы масштабы. Расследавайце гэты этап як кантракт межа вхіднымі даннымі і паверыжанымі выхіднымі рэзультатамі. Даўце назвы артыфактам, задаце критэрыя успеху і не падзеўляйцеся частым, непূরным выкананнем задачы. Храніце стан графа ў простам і типаваным формате. Вкладзеныя блокі маскуюць інфармацыю пра тое, який вузел запісаў кожны поле, і спакойваюць працэс пасля перарываў.

- Revenue is recognized when an order is placed.
+ Revenue is recognized after delivery and the 30-day return window.

Якія ў яго недастаткі (недзе ён не падходзіць)

Этап «Дзеяныя недасткі» працуе наўсёрэдзей, калі яго спрыяваць як вимерную паверхню. Зафіксавайце адны ідеальны прыклад, адзін кейс неудачы і запіс пра вярнэнне да пачатковага стану перад расшырэнням масштаба. Запісвайце часы выканання і косты токеноў або запытак па боку ад функцыйнальных рэзультатаў. Візуабельнасць костаў з самага пачатку запобегае неспакойным рахункам, калі процес пераходзіць з дэмаверсіі ў спяльныя среды. Храніце стан графаў у простам і типаваным формате. Вярнутыя блокі маскуюць інфармацыю пра тое, який вузел запісаў канкрэтны поле, і спакшуюць продыранне пасля перарываў. Этап «Дзеяныя недасткі» працуе наўсёрэдзей, калі яго спрыяваць як вимерную паверхню. Зафіксавайце адны ідеальны прыклад, адзін кейс неудачы і запіс пра вярнэнне да пачатковага стану перад расшырэнням масштаба. Дакументавайце як шлях успеху, так і шлях вяснавання. Перапрыбуткі, людзкія контралі і обработка некоректных паведамленняў є часткай продукту, а не чымсь, што дадаецца пазней.

Як OKF адпавядае RAG і MCP

Ёнколі трэба визначыць, як OKF падходзіць да практычнага выкарыстоўвання, неабходна прадзефінаваць вхідныя даны, адпаведальную особу за кожны крок і крэтыніяя зняцья пры змены коду. Аператары должны магчымае перадзеўжваць крок з вядомага пункту контролю, не спрабоўваючы здагадвацца пра схованы стан. Лепш выбіраць маленькія, тэставаныя елементы замест большых скрыптов. Калі крок не выйшаў, прычына неудачы должна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны процес. Наводзіце тыя часткі тексту, якія фактычна падтрымлівалі адпаведную адказ. Без цых цытатаў аператары не зможуць разлічыць галюцинацію ад працягу ў індэксаванні.

OKF
↓
"What does this concept mean?"

RAG
↓
"Which pieces of knowledge should I retrieve?"

MCP
↓
"How does the agent interact with the tools and context?"

Чы трэба яго выкарыстоўваць у вашам наступным проекте?

У стадії «Чы гэта трэба выкорыстоўваць?» неабходна прадзефінаваць вхідныя даны, адпаведальную особу за выкананне крока і критэрыя завершэння прычынай змены коду. Аперацыйныя працавнікі должны магчымае перайсці на выкананне крока з вядомага пункта контролю, не прымуджаючыся з’ясаваць схованы стан. Спрыятлівае ставленне да гэтай стадіі трэба розглядаць як кантракт між вхіднымі данымі і перакананымі выходнымі рэзультатамі. Назваць всі неабходныя дасобы, прадзефінаваць критэрыя успеху і не падтрымляць беззвучнае часткова завершэння задання. Неабходна людская апрацоўка тых крокаў, якія ведуць да выдаткаў грошаў або змены данных у прыемнай сістэме. Компіляцыйныя налашчанні не є адпаведнікамі пачатковай цэлесообразнасі задання.

metrics/
  active-user.md
  revenue.md
  conversion-rate.md

systems/
  payments-api.md
  orders-api.md

runbooks/
  payment-failure.md

Заключэнне

У стадії заканчэння, пры змяне коду, неабходна ясная дэфініцыя вхідных дадзеных, адпаведнага адпаведальніка за крок і крэтарыў выходу. Аператары должны магчымае перзапускнуць крок з вядомага пункта контролю, не спрабоўваючы здагадвацца пра схованы стан. Запісвайце час выконання і кост токенаў або запытаў разам з функцыйнальнымі рэзультатамі. Відразлівае паказанне костаў запобегае неспадзяваным рахункам, калі процес пераходзіць з дэмовай среды ў спадзеленыя сераўеры. Пры кроках, якія витрачаюць грошы або зменяюць данні ў працэсе, неабходна людзкая апраўда. Компіляцыйны падход не є абавесцю цэліснасці продукту. У стадії заканчэння, пры змяне коду, неабходна ясная дэфініцыя вхідных дадзеных, адпаведнага адпаведальніка за крок і крэтарыў выходу. Аператары должны магчымае перзапускнуць крок з вядомага пункта контролю, не спрабоўваючы здагадвацца пра схованы стан. Дакументавайце як «шчаслівы» шлях, так і шлях вяснавання проблем. Перапрыбуткі, людзкія контрольныя пункты і обработка некоректных запытаў є часткай самага продукту, а не пасляднім дапрацоўкам.

Чэк-ліст аператыўнай роботы

Этап чэк-ліста аператыўнай роботы працюе наякша, калі яго спрыяваць як мерыемую структуру. Запісаўце адна ідеальная версія, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расширваць сферу дзеяння.

Зберагаўце настройкі праза код аплікацыі. Файлы сяродавішча, хранільнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, якое аператары можаць пераглядаць без неабяжнай чытанняў усіх элементаў структуры.

Зберагаўце стан структуры у простам і типаваным формате. Вялікія блакі дадзеных, якія знаходзяцца ўнутрь іншых блакоў, маскуюць інфармацыю пра тое, калькі вузел запісаў калькі поль, і спакойваюць працэс пасля перарываў.

Калі дозволяе бюджет, дадзіце тэст на працясную роботу, які пераглядае критычны маршрут у системе CI з викорыстаннем фіксатываў, а не рэальных платных API.

Документаваўце як шлях успеху, так і шлях вярнэння да нормальнага стану. Перапрыбуткі, людзкія контрольныя пункты і обработка некоректных дадзеных ўжо є часткай продукту, а не чымсь, што дадаецца пазней.

Зберагаюце стан графа ў простам і типаваным формате. Вкладаныя структуры маскаюць інфармацію пра тое, який вузол запісаў якое поле, і спакошуюць працю пасля перерываў.

Перш чым падняць стэк, заморажуйце версіі, зафіксавайце «золаты» транскрыпты для критичнага шляху і паказвайце крокі для відкату. У спадзяльных средах неабходны ліміты швайнаў, пераказы наявнасці праваў і чысткі власнік для змены секрэтных даных. Валіце надзейнасць працы над крэатіўными разовымі дэманстраціямі.

Прыметка для 1b21e57f41e5: не кладзіце ключы прадаўцаў у репазітарый, задаце максімальную кантитатыву токеноў на сесію і зберагаце транскрыпты празаўседы ў фіксатыях ацэнкі, каб пазнейшыя замены моделяў заставаліся порównаннэй.