Практычныя прытамулі: 21 шаблон дизайна агентавання паспрацоўна пояснены

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

Агентныя шаблоны дзеянаў — Дыяграмы архітектуры + Практычны падказкі (21 шаблон)

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

Змест

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

1) Ланцужок запытак (Pipeline)

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

flowchart TD
A[Input] --> B[Step 1 Prompt e.g. summarize ]
B --> C[Step 2 Prompt e.g. extract structured data ]
C --> D[Step 3 Prompt e.g. format output ]
D --> E[Final Output]

2) Маршрутызацыя

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

flowchart TD
I[User Request Input] --> R{Router intent and confidence }
R --> A[Workflow A e.g. Q&A ]
R --> B[Workflow B e.g. coding ]
R --> C[Workflow C e.g. retrieval ]
R --> Q[Ask Clarifying Question]
A --> O[Output]
B --> O
C --> O
Q --> I

3) Паралелізацыя

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

flowchart TD
I[Input] --> F[Fork]
F --> A[Task A e.g. retrieve source 1 ]
F --> B[Task B e.g. retrieve source 2 ]
F --> C[Task C e.g. retrieve source 3 ]
A --> J[Join Merge]
B --> J
C --> J
J --> O[Output]

4) Размышленне (Стварэнне → Крітыка → Удосконаленне)

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

flowchart TD
D[Draft Output] --> C[Critique Review check requirements errors ]
C --> R[Revise using critique]
R --> D
C --> O[Final Output]

5) Апыткаінструментаў (Выклік функцый)

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

sequenceDiagram
autonumber
participant U as User
participant L as LLM Agent
participant T as Tool API
U->>L: Request
L->>L: Decide tool and arguments
L->>T: Call tool args
T-->>L: Tool result
L-->>U: Answer using result

6) Планаванне

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

flowchart TD
G[Goal] --> P[Create Plan steps and dependencies and tools ]
P --> S1[Execute Step 1]
S1 --> C1{Step success }
C1 --> S2[Execute Step 2]
C1 --> RP[Revise Plan Recover]
RP --> P
S2 --> C2{Done }
C2 --> S3[Next Steps ]
C2 --> O[Output]
S3 --> C2

7) Спавяленнае дзейство калькі агентаў

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

граф.

flowchart LR
G[Goal] --> C[Coordinator]
C --> R[Research Agent]
C --> B[Builder Agent]
C --> V[Verifier Reviewer Agent]
R --> S[Synthesis]
B --> S
V --> S
S --> O[Final Output]

8) Адміністрацыя памяці

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

flowchart TD
E[Events Conversation] --> STM[Short-term Memory session buffer ]
E --> LTM[Long-term Memory Store vector DB ]
Q[Current Query] --> RET[Retrieve relevant memory]
LTM --> RET
STM --> CTX[Assemble Context]
RET --> CTX
CTX --> L[LLM Agent]
L --> O[Output]

9) Навчанне & адаптация

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

flowchart TD
R[Run Agent] --> L[Log outcomes success fail and user edits ]
L --> A[Analyze patterns where it fails ]
A --> U[Update prompts routes retrieval or fine-tune ]
U --> E[Evaluate before rollout]
E --> R
E --> A

10) Протакол контэкста моделі (MCP)

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

flowchart LR
A[Agent LLM] --> C[MCP Client]
C <--> S[MCP Server]
S --> T1[Tool: Documents]
S --> T2[Tool: DB]
S --> T3[Tool: Tickets]
T1 --> S
T2 --> S
T3 --> S
S --> C --> A

11) Выканек целей і стэрагаванне

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

flowchart TD
G[Define Goal and Success Criteria] --> X[Execute steps]
X --> M[Monitor state metrics progress budget risk ]
M --> X
M --> A[Adjust plan change route escalate]
A --> X
M --> O[Output]

12) Обработка асаблівых ситуацыяў і вярнэнне да нормальнага стану

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

flowchart TD
A[Action Tool Call] --> E{Error }
E --> N[Next Step]
E --> R[Retry with backoff]
R --> S{Recovered }
S --> N
S --> F[Fallback route tool]
F --> T{Still failing }
T --> N
T --> H[Escalate to Human Safe Stop]

13) Чалавек у ланцюгу (HITL)

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

sequenceDiagram
autonumber
participant U as Human
participant A as Agent
participant S as System Tools
A->>U: Proposal and rationale
U-->>A: Approve Edit Reject
A->>S: Execute approved action
S-->>A: Result
A-->>U: Confirmation and summary

14) Адзыскванне ведамаў (RAG)

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

flowchart TD
Q[Question] --> E[Embed Rewrite Query]
E --> R[Retrieve top-k chunks vector keyword hybrid ]
R --> RR[Rerank Filter optional ]
RR --> C[Compose grounded prompt question and context ]
C --> L[LLM]
L --> O[Answer and citations quotes optional ]

15) Комунікацыя межа агентамі (A2A)

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

sequenceDiagram
autonumber
participant A as Agent A
participant B as Agent B
participant C as Agent C
A->>B: Task request schema and constraints
B-->>A: Result or stream updates
A->>C: Verification request
C-->>A: Verified flagged findings
A-->>A: Merge and decide next step

16) Оптымізацыя з урахоўваннем рэсурсаў

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

цэлага графіка.

flowchart TD
I[Request] --> S[Score difficulty and risk and SLA]
S --> D{Choose compute level}
D --> L1[Fast Cheap path small model and minimal tools]
D --> L2[Balanced path hybrid retrieval and standard model]
D --> L3[Strong path best model and RAG and Reflection]
L1 --> O[Output]
L2 --> O
L3 --> O

17) Тэхнікі разумавання

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

flowchart TD
P[Problem] --> D[Decompose choose reasoning strategy]
D --> A[Act: tool calls sub-steps optional ]
A --> V[Verify constraints checks tests cross-check]
V --> D
V --> O[Answer]

18) Меры захоплення / Шаблоны безпекі

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

flowchart TD
IN[User Input] --> IV[Input Validation policy risk checks ]
IV --> PC[Policy Constraints system rules and boundaries ]
PC --> TR[Tool Restrictions allowlist and sandbox and rate limits]
TR --> L[LLM Agent]
L --> OV[Output Validation PII leak checks and format checks]
OV --> OUT[Safe Output]
OV --> ESC[Escalate Refuse Human review]

19) Ацэнка і манітарынг

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

flowchart TD
RUN[Agent Runs] --> LOG[Log traces inputs tools outputs latency cost ]
LOG --> EVAL[Evaluate quality golden set and metrics ]
EVAL --> DRIFT[Drift Anomaly detection]
DRIFT --> IMP[Improve prompts routes retrieval model ]
IMP --> DEP[Deploy and A B test]
DEP --> RUN

20) Прыорітэзаванне

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

flowchart TD
T[Incoming tasks] --> N[Normalize into task objects]
N --> S[Score tasks urgency impact risk deps cost ]
S --> Q[Queue Scheduler]
Q --> X[Execute next task]
X --> U[Update scores new info failures deadlines ]
U --> S
X --> O[Outputs Results]

21) Адкрыцція новага

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

flowchart TD
S[Start: unknown space] --> H[Generate hypotheses options]
H --> G[Gather evidence search tools experiments ]
G --> E[Evaluate findings rank eliminate]
E --> R[Refine hypotheses]
R --> G
E --> O[Best answer strategy]

Звычныя шаблоны (тае, што насправды выкладваюць команды)

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

Чэк-ліст для эксплуатацыі

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

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

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

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

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

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

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

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