Практычныя нарады: Стварэнне эфективных агентаў ШІ: шаблоны архітектуры.

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

1. Чаму ёсць агент AI?

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

2. Архітектура ядровага агента

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

Інтэрфейс корыстніка або системы

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

Час выканання агента

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

3. Шар модэля

Этап „3. Шар модэля“ працюе найкраща, калі яго розглядаць як вимерную паверхню. Запісаўце адна ідеальная транскрыпцыя, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расширваць масштабы. Дакументаваць трэба як шлях успеху, так і шлях вяснавання. Перапрыбуткі, людзкія контралі і обработка некоректных паведамленняў є частью продукту, а не чымсь, што дадаецца пазней. Закладзіце бюджет на токены на кожны раунд і на кожную сесію. Інструменты-агенты агрэсывна расширваюць контекст; строгі ліміты не дазволяюць дэм-версіям ператварыцца на неспакоўлівыя рахункі.

4. Інструменты, якія ператвараюць модэлі на агенты

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

search_leads()
get_account()
get_customer_history()
get_recent_emails()
create_opportunity()
schedule_meeting()
generate_proposal()

5. Шаблон 1: Агент, які выкарыстоўвае інструменты

Для стадіі 5 Патэрна 1 неабяцкова практычна ваказваць параметры выхаду, адпаведальнага за крок і крэтыяры выхаду пры змены коду. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю, не падозрываючы схованы стан. Конфігурацыю трэба знаходзіць за межамі коду прыемлікі. Файлы сяродавішняе сераўісу, хранілішчы секрэтных дадзеных і флагі функцый канальныя ў аднам месца, якое аператары можаць пераглядаць без чытання всей структуры. Автентыфікацыя выканаліваеца ў шлюзе, а паўтарная автарызацыя — у роўні дадзеных. Толькі токэн-носіцель не є межай адпаведнае часткі системы.

User
  ↓
Agent
  ↓
LLM
  ↓
Choose Tool
  ↓
Execute Tool
  ↓
Tool Result
  ↓
LLM
  ↓
Final Response

get_weather("Chicago", "tomorrow")

6. Патэрн 2: ReAct

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

Goal
 ↓
Reason
 ↓
Action
 ↓
Observation
 ↓
Reason
 ↓
Action
 ↓
Observation
 ↓
Final Answer

User Goal:
Find our highest-value customer with an unresolved support case.

Reason:
I need customer revenue data.Action:
query_customer_database()Observation:
Customer A has the highest revenue.Reason:
Now I need unresolved support cases.Action:
search_support_cases(customer_a)Observation:
Two unresolved cases found.Final Answer:
Customer A is the highest-value customer currently
associated with unresolved support cases.

7. Pattern 3: Plan-and-Execute

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

сераўнах.

Goal:
Prepare me for tomorrow's meeting with Acme Corp.

1. Retrieve account information
2. Review recent opportunities
3. Retrieve previous meeting notes
4. Review recent emails
5. Identify unresolved issues
6. Find relevant company news
7. Generate meeting briefing

User Goal
   ↓
Planner
   ↓
Task Plan
   ↓
Executor
   ↓
Tools
   ↓
Results
   ↓
Evaluator
   ↓
Final Output

8. Шаблон 4: Архітектура рутэра

Калі працюеце над 8-м этапам Шаблона 4 для рутэра, спачатку запісайце умовы викорыстання: неабяжлівыя данні, сигнал успеху і тое, што выходзіць на падчасныя неудачы. Такі чарт дапамагае залічваць змяны ў кодзе чыста. Зберагайце настройкі паза кодам прыемліка. Файлы сераўна, хранільнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, якое аператары можаць пераглядаць без неабяжлівага чытання всей структуры. Робіце перапаказ пасля дорогіх крокаў. Система вярнення не должна занова ставіць плату за той самы вызов LLM, калі аператар перапрыяўляе роботу да наступнага вузла.

┌── HR Agent
                  │
User → Router ────┼── Finance Agent
                  │
                  ├── IT Support Agent
                  │
                  └── Sales Agent

9. Шаблон 5: Агенты-надзірнікі і працоўнікі

Калі працуеце над 9-м стадзіям Pattern 5 Supervisor, спачатку запісайце угоду: неабяжлівыя даны, сигнал успеху і тое, што выходзіць у разе частковага неяксамоства. Такі список пераконтролю дапамагае заліцварыць пазнейшыя змены коду. Документавайце як шлях успеху, так і шлях вярнення. Перапрыбуткі, людзкіе етапы перагляду та обробка некоректных паведамленняў ёсць часткай продукту, а не пазнейшым дапрацоўкам. Зробіце пераконтроль пасля дорогіх крокаў. Система вярнення не павінна знову ставіць плату за той самы вызов LLM, калі аператар перапрыбуе пазнейшы вузел.

Research Agent
                     ↑
                     │
User → Supervisor → Data Agent
                     │
                     ↓
                 Report Agent

10. Pattern 6: Agentic RAG

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

Question
 ↓
Vector Search
 ↓
Relevant Documents
 ↓
LLM
 ↓
Answer

Question
 ↓
Agent
 ↓
Do I need retrieval?
 ↓
Which source?
 ↓
Search
 ↓
Evaluate results
 ↓
Enough information?
   ↓        ↓
  Yes       No
   ↓         ↓
Answer    Search Again

11. Шаблон 7: Размышленні і самаўцэнка

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

Generate Answer
     ↓
Evaluate Answer
     ↓
Is it sufficient?
  ↓          ↓
 Yes         No
  ↓           ↓
Return       Improve

12. Архітектура памяці

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

Рабочая памяць

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

Памяць размовы

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

Даўгастраўная памяць

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

Эпізодычная памяць

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

13. Стан частае важнейшы за памяц

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

state = {
    "goal": "",
    "user_id": "",
    "plan": [],
    "completed_tasks": [],
    "tool_results": {},
    "approval_status": None,
    "errors": [],
    "final_answer": None
}

14. Архітектуры агентаў на базе графа

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

Start
  ↓
Classify Request
  ↓
Retrieve Data
  ↓
Analyze
  ↓
Risk Check
  ↓
Need Approval?
 ↓          ↓
Yes         No
 ↓           ↓
Human       Execute
Approval      ↓
 ↓          Finish
Execute
 ↓
Finish

15. Архітектура з участю чалавека

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

Agent Recommendation
       ↓
Policy Check
       ↓
High-Risk Action?
    ↓        ↓
   Yes       No
    ↓         ↓
Human       Execute
Approval
    ↓
Execute

16. Абсаргія агента

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

Абсаргія вхідных дадзеных

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

Інструментальныя правілы

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

Нормы выходных дадзеных

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

Засобы контролю выканання

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

17. Фрамворкі рэалізацыі

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

сераўнах.

Python
+
LLM API or local model
+
Functions
+
FastAPI
+
Database

Фрэймворкі на аднойчынных схемах

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

Фрэймворкі з калькуляцыямі

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

Платформы кіравання AI для корпаратыў

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

18. Фрамворк практычнай рэалізацыі

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

Шаг 1: З’явіце мету

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

Урадок 2: Адзначэнне абавясців агента

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

Retrieve account information
Retrieve opportunities
Analyze customer communication
Retrieve open support issues
Generate meeting briefing
Recommend discussion topics

Cannot modify CRM records
Cannot send email
Cannot change pricing
Cannot create contracts

19. Этап 3: Апрацоўка інструментаў

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

get_account(account_id)
get_opportunities(account_id)
get_support_cases(account_id)
get_email_history(account_id)
search_company_news(company_name)

manage_customer()

get_customer_profile()

20. Крок 4: Проектаванне прабегу керавання

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

21. Крок 5: Дадаць стан і памяць

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

Conversation state
Task state
User preferences
Long-term knowledge
Audit history

22. Крок 6: Дадзенне можлівасця абсарбавання

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

Request
Agent decision
Model used
Prompt version
Tool selected
Tool input
Tool output
Execution time
Token usage
Cost
Errors
Retries
Final response
Human overrides

Request ID: 78425

Step 1:
Intent → Customer Meeting PreparationStep 2:
Tool → get_account()Step 3:
Tool → get_opportunities()Step 4:
Tool → search_support_cases()Step 5:
LLM → Generate briefingTotal execution: 4.8 seconds
Tool calls: 3
Model calls: 2

23. Крок 7: Ацэнка агента

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

Завершэнне задання

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

Выбір інструментаў

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

Точнасць адынстоў

Апарэнчасць

Безпека

Эфектыўнасць

Затрымка

Косц

24. Вярнэнне пасля неудачы

Tool Call
   ↓
Success?
 ↓      ↓
Yes     No
 ↓       ↓
Continue Retry
          ↓
       Still Fails?
        ↓       ↓
       Yes      No
        ↓        ↓
     Fallback  Continue
        ↓
     Escalate

25. Сістэмы з калькамі агентаў: іспользоўваць іх адзяйна

Supervisor
 ├── Financial Analysis Agent
 ├── Legal Analysis Agent
 ├── Market Research Agent
 └── Report Generation Agent

Search Agent
Thinking Agent
Tool Agent
Summary Agent
Response Agent

26. Архітэктура корпаратыўных агентаў

User
                     ↓
               Agent Gateway
                     ↓
             Identity / Access
                     ↓
                  Router
                     ↓
       ┌─────────────┼─────────────┐
       ↓             ↓             ↓
   Sales Agent    HR Agent    Finance Agent
       ↓             ↓             ↓
             Agent Runtime
                   ↓
        ┌──────────┼──────────┐
        ↓          ↓          ↓
       RAG       Tools      Memory
        ↓          ↓          ↓
    Knowledge    APIs     Databases
      Base
                   ↓
             Policy Engine
                   ↓
          Human Approval Layer
                   ↓
              Observability
                   ↓
              Evaluation

27. Дэтэрміністычны програмнае забезпечэнне і верагатыстычны ІІ

Probabilistic Intelligence
          +
Deterministic Control
          =
Reliable Agentic System

28. Пачніце з рабочых прайсэптов, а потым дадзіце автонамію

Этап 1 — Асистэнт

Этап 2 — Асистэнт, які іспользоўвае адынсты

Этап 3 — Кераваны агент

Этап 4 — Аўтонамны рабочы процес

Этап 5 — Система з калькольнікаў

29. Чы гэта робіць AI-агентаефектываў?

30. Заключныя меркі

Кантракцыя архітэктуры

AI Agent
│
├── Model
├── Instructions
├── Context
├── Tools
├── Retrieval
├── Memory
├── State
├── Planning
├── Orchestration
├── Guardrails
├── Human Oversight
├── Observability
└── Evaluation

Спіс пераканальных крокаў