Кіраванне AI-агентамі па рамцы CARE: яснасць, аўтаномія і іншае
Кіраванне AI-агентамі па рамцы CARE: яснасць, аўтаномія, адносіны і справядлівасць у дэлегаванні, кантрактах агентаў, выбары мадэлі і кантэксце.
Крыніцы: You Already Know How to Manage Agents: The CARE Framework for AI Engineering
Адміністратыўныя трэнінгі іноды навчаюць таму, што паўтараецца ў програмнай апаратнай частцы больш безпасова, чым можна было спадзявацца. Канструкцыя CARE з трэнінгаў лідарства, якая складаецца з чатырох прынцыпаў — Яснасці, Автаноміі, Стосункоў і Равнасці, — практычна адпавядае ствароўным практыкам керавання агентамі AI. Даследаванне тых сабе прынцыпаў пад час работы з агентамі — граматычны спосаб здобыць лепшыя рэзультаты. Ёсць ніжэй, кожны прынцып адносіцца да агента AI, які выступае ў ролі члена каманды, якому паставяюць задачу.
Тэкучая сітуацыя
Адзін-два гады тыму, працаванне з асістэнтамі для напісання коду выглядала як серыя маленькіх заповедзей: стварыць функцыю, вылечыць бяг, дадзіць тэсты. Сёння агенты можаць пераглядаць рэпазітары, запускаць каманды шэлу, шукаць інфармацыю ў дакументацыі, рэдагаваць калькі файлоў адразу, выкананыць тэсты і перадаць работу саб-агентам. Аднак іх часта яшчэ керуе як автодапоўненнем. Проблема ўсё больш не ў запытаннях, а ў дэлегаванні.
Чатыры запытанні CARE, кратка:
- Яснасць: як выглядае успех?
- Аўтонамія: насколькі можа сам стаць адпаведальным чалавек?
- Связь: хто павінен выконваць гэту работу?
- Равнасць: што ў іх трэба, каб досягнуць успеху?
Тэхнічныя менеджэры і керавальнікі вялікі час ведаюць, насколькі кожна з гэтых аспектаў важна для досягнення хорашых рэзультатаў, не трэбаючы стаяць прыкладзенымі да таго, хто яе выкананыць.
Ясна формуліраванне: неабяжна апісанне рэзультатаў, а не запыткаў
Падазроўваючы, што адносіб, уплывальны на праект, хочаць кэшаванне на тэрмінацыі профілю карыстальніка, а выкананне задачы будзе адданае агенту на базе GenAI. Тыповая слабая запытка выглядае так: «Застаўце кэшаванне для тэрмінацыі профілю карыстальніка». Для чалавека, які знае сістэму, гэта звучыць ясна. Але на самай працы так не ёсць. У агента з’яўляецца дзесяткі незадаўжаных пытанняў: якая саме тэрмінацыя? Што будзе кэшавана? На які час? Што выключае актуальнасць даных? Якая інфраструктура кэшавання вялікі ўжо? Шта счываецца за завершанае?
Ясна формуліраванне не значыць дыяўольскую дужы запытку. Гэта значыць, што бажаны рэзультат і абмежэнні ёсць бездвусмысловыя. Моцнейшая версія такой задачы:
Goal:
Reduce repeated database reads from GET /users/{id}.
Constraints:
- Use the existing Redis abstraction.
- Do not introduce a new dependency.
- Cache only successful responses.
- TTL: 10 minutes.
- Existing public API behavior must not change.
Before implementing:
- Inspect similar caching implementations in the repository.
- Identify how cache invalidation is handled elsewhere.
Validation:
- Existing tests must pass.
- Add tests for cache hit, cache miss, and invalidation.
Definition of done:
The implementation is complete when the endpoint behaves identically
from the client's perspective and repeated reads no longer hit MSSQL.
Інжынірынг запытоў — гэта толькі адна з ступеняў яснасці. Асалівая спэцыяльнасць — гэта насталяк добра апісацыя задання, каб іншы могаў яго выконаць, што керавальнікі і лідэры робяць ўсё дзень.
Автаномія: абавесцьба, а не толькі інструкцыі
Можа здавацца, што мікракераванне не існуе для агентаў, але яно існуе. Калі агент залежыць ад постаўных падказак, зазвычай прычына — нехватка яснасці і інструкцый. Уявіце сабе такую сесію:
Find the problem.
Okay, fix it.
Now run the tests.
There's an error. Fix that.
Run them again.
Пользоватэль сам керуе кожным крокам, і гэта вымучвае обе стороны.
Агент можа ідэальна разумець задачу, але ўсё раве не маць автонаміі. Автонамія — гэта права на самастоятэльнае прыняцце рашэнняў: што агент можа адлучыць, што можа змяніць, насколькі далека ён можа дзеяць сам і калі ёму трэба прызваць дапамогу. Контракт агента чыста выражае гэта:
You own this task until it is implemented and validated.
You may:
- inspect any file in the repository
- modify files related to this feature
- run builds, tests and static analysis
- create focused subagents for research or validation
After implementation:
1. Run the relevant test suite.
2. Inspect your diff for unintended changes.
3. Validate the implementation against the acceptance criteria.
4. Fix issues you discover before returning.
Escalate only if:
- the requested behavior conflicts with existing architecture
- required credentials/access are unavailable
- the change would require modifying a public API
Ясна мета вялічыць парадакс палявання, а автаномія вялічыць тое, насколькі з усьго палявання контролюе агент. Аднак автаномія не значыць можлівасць робіць все, што захочацца. Здаровая автаномія супакоўваецца з межамі.
Связь: пазнайоміцца з агентамі
Тут пад связзю разумецца калібруванне, а не антропоморфізм. Цэла — адзінутыя знанні пра сілы, слабасці, способы неудач і практычны дазналік модэляў і агентаў, якія вікорыстоўваюцца. Менеджэр вывучае, дзе кожны чалавек выканае сваю найкрашчую работу, і тое ж самае розумеўне павінна развівацца і для сістэмы AI:
| Work | Agent/model characteristic |
| ------------------------------------- | ----------------------------------- |
| Repository-wide architecture research | Strong reasoning + large context |
| Small mechanical refactor | Fast, inexpensive model |
| UI implementation from screenshots | Strong vision model |
| Test generation | Fast coding specialist |
| Final architecture critique | Independent high-reasoning reviewer |
Схема, у якой ёсць адзэнт на адзэнт, вялікі кантэкст і кожны заводзек, які яму даваюць, здалека не ідэальная. Работа павінна выпаліць на агентаў, якія да гэтага прыстосаваны. Дызайн з калькой агентаў не значыць наявнасць большай калькі агентаў. Гэта значыць перадачу чытка абмежанай працы агенту, які найлепшыя падходзіць да яе:
Main Agent
│
├── Research Agent
│ └── Investigate existing caching patterns
│
├── Implementation Agent
│ └── Make the code change
│
└── Reviewer Agent
└── Validate implementation independently
Связь павышаецца ў меры, як сістэма накаплівае ведомась пра архітэктурныя рашэнні, стандарты кодавання, часта з’являюцыяся моды працы, пакананыя рашэнні і пра тое, якія мадэлі добра справляюцца з якімі задачамі. Корача, гэта — розумеўце мадэлі плюс накапліваны кантэкст.
Равнасць: задаваць тое, што патрэбна агенту
Звычныя скаргі звучаць так: «Штучны інтэлект зноў створыў халюцынацію» або «Ён створыў некалітэтнае рашэнне». Але пагляньце, што на самай працэ было дана агенту. Не было ні документаў API, ні трыбутаў карточак, ні логаў, ні прыкладоў коду, ні прымітак пра архітэктуру, і не было можнасці падключыцца да запускаемага прыемніка. Чы гэта была неудача мадэлі, чы ў каго-то прасілі рашыць проблему без неабходных ведамасей?
Падазроўваючы, што агент мог бы знайсці або атрымаць усё гэта:
.agent/
│
├── context/
│ ├── architecture.md
│ ├── domain.md
│ └── conventions.md
│
├── skills/
│ ├── debug-production.md
│ ├── review-mr.md
│ └── implement-feature.md
│
├── references/
│ ├── api-spec/
│ ├── examples/
│ └── decisions/
│
└── tools/
├── git
├── jira
├── logs
├── browser
└── tests
Точны ўпорадак мае меньшое значэнне, чым сама практыка. Агентам патрэбны правільныя інструкцыі і інструменты. Агент для дыягностыкі працы можа патрабаваць код, логі, следы дзеяння, няўзначныя абнаўленні і історыю змян у Git. Агент для інтэрфейсу можа патрабаваць код, скрыншот, сістэму дызайну, прыгледчык і дакументацыю да компанентаў. Аднаўлячый можа патрабаваць разлікі змян, цэлы файл, тэсты, заявку, сэрагодны код і правілы рэпазітарыя. Інтэлект застаецца тым жа, а патрэбныя рэсурсы разныя. Перш чым вырашыць, што модэль неспроможна, спытайцеся, чы была ў яе можлівасць так рабіць.
CARE як інструмент для дыягностыкі
Направленасць працы выклікаеецца ад стварэння праблемы да дэлегавання задач і ўпорадкування ўсіх процэсаў, а роль лідэра зменшваецца ў меру гэтага. Талантаваныя людзі ужо паспелі парадкаваць пад час выпання задач, калі цілі неясныя, ўсё кантролюецца занадта блізка, задачы не паспраўданыя або не хапае рэсурсаў. Застосаванне гэтых знанняў да агентаў значыць, што тыя ж прыемы керавання цяпер працуюць для всіх, хто стварае рашэнні ў командзе, незалежна ад таго, чыя то людзі, чы нея.
Усе чатыры элементы ў адзінай вялічыні агента
У разных сістэмах схемы разныя, але стандартная вялічыня агента зазвычай уключае элементы CARE ў такі фармат:
---
name: implementation-agent
description: Implements scoped repository changes end-to-end. Use proactively for feature, bug-fix, and refactor tasks that require code changes and validation.
tools: Read, Grep, Glob, Edit, Write, Bash
model: inherit
---
You are an implementation agent responsible for completing scoped coding tasks end-to-end.
When given a task:
1. **Investigate**
- Read the relevant code before changing it.
- Search for similar implementations and existing project conventions.
- Do not guess when repository evidence is available.
2. **Plan**
- Form a short plan covering the files to change, the implementation approach, and validation.
3. **Implement**
- Make the smallest change that fully satisfies the task.
- Reuse existing patterns and dependencies.
- Do not modify unrelated code.
4. **Validate**
- Run the relevant tests, build/type-check, and lint/static analysis when available.
- If your change causes a failure, fix it and validate again.
5. **Review**
- Inspect the final diff.
- Remove accidental or unrelated changes.
- Confirm the requested behavior and acceptance criteria are satisfied.
Continue autonomously until the task is complete.
Escalate only when required access is unavailable, requirements materially conflict, or the task would require a destructive action or a public API/architecture change outside the requested scope.
The task is done only when the implementation is complete, relevant validation passes, and the final diff has been reviewed.
Дэлегаванне — гэта навык, які развіваецца
Агенты не ўсё тое ж, што людзі, але сістэмы, створаныя навакола іх, страждаюць ад настолькі знайомых проблем у керуванні. Калі даты агенту нечыстаю цель, кераваць кожным крокам, выдазваць некарэктны мадэль чы прыховаць кантэкст і інструменты, робіцца гірша яго праца. Калі агенты стануць болей спроможнымі, прычыны ўспеху не будуць абмежаны толькі сільнейшымі мадэлямі чы болей тэкстовымі запітамі. Команды, якія навучыцца правільна дэлегаваць задачы, зможуць максымальна скорыстацца тэхналогіямі ШЫ.