Эфектыўныя AI-агенты: архітэктурныя патэрны

У гэтым карыце парадоксу перакладзеныя ад сыр'ём да рабочай сістэмы для кнігі «Стварэнне эфектыўных агентаў 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

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