Брифинг: как се дава задача на агент
Под-агентът не вижда разговора ти и знае само това, което пише в задачата. Добрият бриф казва какво искаш, защо, докъде да стигне и какво да върне.
В този урок
Агентът започва от нула
Това е най-важното нещо за под-агентите и най-лесно се забравя. Когато главният агент пусне под-агент, вторият не вижда разговора ви. Той не знае какво сте изяснили преди час, кои файлове вече са прочетени и какво сте отхвърлили.
Той получава само задачата, която оркестраторът му е написал. Тази задача се казва бриф.
Естествено, има едно изключение. Повечето под-агенти четат твоя CLAUDE.md, значи общите правила стигат до тях. Всичко за конкретната задача обаче трябва да е в брифа.
Какво пише в добър бриф
- Целта и защо ти трябва. Ако агентът знае за какво ще ползваш резултата, избира по-добре сам.
- Какво вече е направено. Така не повтаря работа и не предлага нещо, което вече си отхвърлил.
- Къде са нещата. Посочи файловете с път, вместо да преписваш съдържанието им.
- Обхватът. Какво да пипа и какво да не пипа.
- Как изглежда готовото. Нещо, което може да се провери, например „страницата се отваря без грешка“.
- Какво да върне. Кратък отчет, списък или само едно число.
Шаблон в четири реда
Това е скелетът, с който пускам агента си за проучване:
ЗАДАЧА: [какво да направи]
КОНТЕКСТ: [защо ми трябва и какво решение зависи от това]
ОБХВАТ: [кои файлове или източници; какво е извън задачата]
ВЪРНИ: [какво точно искам обратно и в какъв вид]Същата задача по двата начина
Слаб бриф:
Провери защо формата не работи.Агентът не знае коя форма, какво значи „не работи“ и какво вече си пробвал. Той ще прочете половината проект и ще се върне с предположение.
Добър бриф:
ЗАДАЧА: Намери защо формата за контакт в kontakt.html не праща съобщение.
КОНТЕКСТ: Спря да работи след вчерашната промяна на бутона. Адресът,
на който се праща, е проверен и работи.
ОБХВАТ: Само kontakt.html и js/forma.js. Не променяй нищо, само намери причината.
ВЪРНИ: Причината с номер на ред и какво предлагаш да се смени, до десет реда.Кой пише брифа
Ти рядко пишеш брифа сам. Ти говориш с оркестратора, а той го пише за агента. Затова правилото стои в CLAUDE.md, за да го спазва всеки път:
Давай на всеки агент пълен бриф.
Той не помни нищо от предишните съобщения.Ако след първия отчет трябва уточнение, кажи на Claude да продължи същия агент. Той си пази историята и не започва пак от нула, а новият агент би започнал.
Грешката, която направих
Един път казах „хайде да направим ново видео с всичко, което подобрихме по агентите“. Имах предвид старото видео, направено наново с подобренията. Claude разбра, че искам видео за самите подобрения, и пусна агент да го изгради. Сценарият, гласът и планът бяха готови, когато видях, че темата е друга, и всичко отиде в коша.
Правило
Ако задачата може да значи две различни неща, оркестраторът ми я повтаря с едно изречение, преди да пусне агент: „значи X, а не Y“. Един въпрос струва едно съобщение, а сбъркана задача струва цялата работа.
В Codex
Брифът се пише по същия начин и четирите реда работят и там. Сменя се само къде стои правилото за оркестратора: в AGENTS.md вместо в CLAUDE.md.
Запомни
- Под-агентът не вижда разговора и знае само каквото пише в брифа.
- Кажи целта, обхвата, как изглежда готовото и какво да върне.
- Посочвай файловете с път, вместо да ги преписваш.
- При двусмислена задача един въпрос е по-евтин от сбъркана работа.
Искаш да стане по-бързо?
Вземи шаблоните готови. Наръчникът ти дава CLAUDE.md, brain.md и AGENTS.md за попълване и план за първите 30 дни.19 € Нека го настроя вместо теб. Изграждам ти мозъка, паметта и първите агенти и после ти показвам как да ги караш сам.от 250 €Ако нещо в урока не е ясно, пиши ми в Instagram на @bravis.ai.