Каманды агентаў у Claude Code: калі пераходзіць на некалькі агентаў і як
Калі хапае аднаго агента, чатыры прычыны дадаць яшчэ, патэрны аркестрацыі, стылі камунікацыі, восем тыповых збояў і выбар паміж убудаванымі камандамі Claude Code і самаробнымі.
Крыніцы: Claude Code agent teams: when and how to go multi-agent
Існуе можлівасць стварэння скоордынаванай групы агентаў, якія можуць весты саавесныя пераказванні ў межах экасістэмы Claude Code, і готовая версія такой групы можа працаваць добра. Аднак ўскладніць у тым, што працоўнае функціонаванне такой групы ёсць складнейшым, чым здаецца на першы погляд, і багато людзей прыўлекаюцца да стварэння такіх груп агентаў без належнага аналізу можлівых наследкіў. Групы агентаў здаюцца явным наступным крокам, калі падагенты вядуць ся чыста. Але ўсё не так проста — група агентаў являе сабою шар коордынаціі, які мае рэальныя вітраты на токены, вядомыя способы неудач і вузкі спектар проблем, якія ён можа эфектывна рашыць.
Найменш прыгучы, але ў той жа час найкорыстнейшы урок, які можна вывучыць за месяцы рэальнага вікорыстання калькулятораў з колькама агентамі, — гэта неабходнасць пачынаку з адного добра настроюванага агента, хорашых інструментаў і строгага карыстоўвання кантэкстам. Дадавайце новыя агенты толькі тады, калі ёсць конкрэтная прычына. Кансультатывныя матэрыялы Anthropic пра стварэнне эфектываў калькулятораў таксама радзяць шукаць самая простая працэсная рашынку і дадаваць складнасць толькі тады, калі гэта неабходна.
Далей паказана методыка размышлення над рашэннем і дзеянні пасля яго прыняцьбы. Яна выкладвае, што вы вядомі з сабагентамі, адміністрацыяю іх ад навыкаў і прычынамі, чаму ізоляцыя кантэкста ёсць галоўной прычынай яго вікорыстання. Адкрытым пытаннем застаецца тое, калі адзін сабагент, які дапамагае звяртацца за інформацыяй, становіцца недастатковым, і што трэба стварыць у яго месца.
У матэрыяле рассматрываюцца следуючыя аспекты:
- Чаму большасць командаў пакіян не патрабуе калькі з агентаў, і стандартная памылка – выбір команд, якія здаюцца моцнейшымі.
- Чатыры конкрэтныя прычыны, якія паказваюць, што у агента ўжо немае можлівасцей для дальнейшай працы.
- Чатыры мадэлі супакоўвання агентаў у таксанаміі, нейтральной да прадаўцоў: оркестрацыя, канвеі, паралельныя спецыялісты і рою.
- Антропічны стак для команд агентаў, які раздзеляе тое, што ёсць стабільным, ад таго, што ёсць експерыментальным чы суцэльна тэставым.
- Што такое команды агентаў Claude Code і якія ў іх разлікі з сабагентамі.
- Як агенты вяршаюць кантакты: тры формы, чатыры патэрны часавага распісу і што можна перадаваць межы ўмаў.
- Восьсім спосабаў абвалення з супакоўваць і практычныя способы ўсунуць іх.
- Рамка для прыняцтва рашэнняў ў паводзе натыўнае, самастоятэльнае чы гібрыднае супакоўванне.
Большасць командаў пакіян не патрабуе больш ад одного агента
Багато людзей, які шукаюць команды агентаў, рашаюць неправільную проблему. Звычная логіка такая: сабагенты працавалі, сістэма стае складнейшай, і таму команды ўважаюцца наступным крокам. Гэтая логіка плутае можлівасці з складнасцю. Команда не робіць сістэму болей можлівайююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююююю
Пост компаніі Anthropic працэўнае па стварэнню эфектываўых агентаў дакладна расказывае пра эканаміку гэтага падходу. Рабочыя працэсы, якія не ўключаюць агентаў, ёсць болей прыемлівыя для прагназавання, дэшэўыя і лёгкія для дыбагавання, а советы сводзяцца да гэтага: калі звычная функцыя можа выконаць задачу, трэба напісаць самую функцыю, а не ствараць камітэт з распадоў верыятнасцяў. Гэты момант лёгка працізнуць для тых, хто не усвядоміў, што LLM-ы ёсць верыятнасныя мадэлі. Нават чыстае заведамленне можа быць або не будзе правільна выконана. Кожны даданы агент — гэта ўсё новы элемент, які можа зламацца, стварыць халюцынаціі або выдаты выхід, які наступны агент неправяма спрацавае, таму дадаванне агентаў паўтарае шансы на пакрыцця памілкамі у масштабе.
Ліміт для адзэнта-адзінца вышы ў дзеяннях, чым думаюць людзі. Адзэнт-адзінец, якому даюць паслужыцьяльныя інструменты, чыткія інструкцыі, адказна распадзелка важкай працы між пададзэнтамі і адказна кантроль кантэксту, можа выконваць нейколькі дзівныя заведаменні. Ліміт досягаецца, калі спраўжніяе характэрныя для сітуацыі адна з чатырох прамов:
- Праца занадта вялікая для аднаго вікна кантэксту, нават з распадзелкай на пададзэнтамі.
- Разныя часткі працы выкалікаюць патрэбу ў абсалютна разных спецыялізаціях, тое ў іншым доступе да інструментаў, разных межах паведання, а не проста ў іншых інструкцыях.
- Частка працы можа выконваліцца паралельна, і тады мае значэнне паспеллівае час.
- Якосьць рэзультата выкалікае патрэбу ў незалежной ацэнцы, напрыклад, ад другога адзэнта, які не бачыў праблематыку першага.
Ні адно з гэтых не ўскладненне, якое стосуецца можлівасцяў. Усе гэтыя пункты стосуюцца архітэктуры. Калі ўжываецца дадатковы агент, яго наявнасць ўзрабатываецца. Калі ж ніякога дадатковага агента не ўжываецца, яны толькі ствараюць перакосы, а калі нельга паказаць конкрэтны прыклад, то варыянт з аднім агентам застаецца можлівым.
Чатыры прабуджухоўчы фактора, з прыкладамі
Ізоляцыя кантэксту. Падазроўваючы, што задача вымагае чытання дзесятаў файлоў, адбывання масштабных пошукоў і зберагчыць вялікія проміжныя рэзультаты, якія няцерпяць неабходнасці застаўляцца ў галоўнай сесыі, для гэтага падходзіць падагент. Але калі масштабы задачы настолькі вялікі, што заполняецца нават кантэкст падагента, або задача дзеліцца на незалежныя паралельныя розследаванні, тады патрэбны калькольвыя агенты. Гэта самы распашчасты легітымны прабуджухоўчы фактор.
Спецыялізацыя. Для выканання такой працы трэба не проста ўзельні інструкцыі; патрэбны разныя правы на адпраўку інструментаў і разныя обмежэння ў повадзенні. Аднаўальнік коду, які не можа пісаць файлы чы выканаваць каманды шэлу, мае абсалютна іншы профіль рызыка, чым генератор коду. Аднак гэтыя разлікі часта можна зафіксаваць у вачынку окрэмых падагентоў, кожны з якіх мае свой сістэмны запрос і обмежаны спіс інструментаў, таму сама спецыялізацыя не павінна быць прычыной пераходу да команд. Сама дакументацыя па агентах-командах гаворыць, што падагенты тут выказваюць сябе: ізольаваныя кантэксты, падсумкі, якія возврашчаюцца вызывачу, і інструкцыі, прызначаныя конкрэтна для задачы.
Паралельная праця. Заданне дзеліцца на незалежныя падзядные задачы, якія не маюць спольнага змennyга стану: трое агентаў адразу пераглядаюць разныя аспекты бага ў кодавой базе, або чатырэ агентаў кожны пераглядае іншы роздзіл дакумента. Гэта тая сітуацыя, калі мнагаагентныя сістэмы даўаюць рэальную еконамію часу, адколі агенты працуюць адночасова. Цена — гэта большая колькасць токенав, таму такі варыянт ёсць правільным толькі тады, калі працяючы час мае большое значэнне, чым вітраты.
Незалежная крытыка. Рэзультат трэбуе другой думкі, якая не была заплямавана логікай першай. Уявіце адначыну, якая чытае толькі фінальны рэзультат, а не логіку, якая стоўіць за ёю, або агента з «чырвонай команды», які шукае недосконачнасці замест таго, каб параболізаваць тверджэння. Гэта і ёсць ідэя сістэмы мнагаагентных даследжэнняў Anthropic, дзе паралельныя падагенты аналізуюць разныя аспекты, а галоўны агент самастойна сінтэзуе інфармацыю.
Калі адна з гэтых версый явна правая, і вы можаце сказаць, калі самэй, тады дадатак агентоў мае сенс з точкі зору сваёй вартасці.
Чатыры спосабу саюзвання агентоў
Падзеймім, што рашынка ўжо прынята. Адразу ж выявляецца плутанне, адтуды што лабораторыі на межы дакладная навукі розвілі мадэлі з удзелам калькулятораў по-разнаму, хоць існуюць кальканыя элементы. Чыгае сабраная таксанамія, створаная на аднойчыні з дакументацыяй працэсу працы Anthropic і адпаведным дазвічайнем каштоўнікам іх інжынерскай команды. Гэта не афіцыйная класыфікацыя Anthropic; гэта аналітычны падсумак, які вярнуецца да таго, што опісваюць гэтыя крыніцы.
Парадный пайплайн
Калькуляторы або этапы выкананыя ў фіксаванай параду, пры чым пазнейшыя этапы вікорыстоўваюць рэзультаты паканальных. З чатырох гэты ўзель выглядае простэйшым для пояснення інжынерам, адтуды што ён нагадвае звычную программу: адначасова дакладная навукі, потым сабранне інфармацыі, палявання праекту, потым яго адгукі, палявання даных і ўжо ўпэўненне ў якосці.
Ягою сялабошчынай ёсць чысткія контракты межа стадзіямі. Ягою слабасцю ёсць каскадныя памылкі, адказе памылка пад час выяўлення даных на першай стадзіі можа прычыніць памылкі на пазнейшых стадзіях з вельмі большымі збыткамі. Бар'еры апраўлення межа стадзіямі ёсць неабходныя, таму што яны не дазволяюць працэсу розвівацца ў неправым напрамку. Схемы контрактаў JSON і іншые элементы, якія зберагаюць лініярнасць падчас выканання, являюцца найэфектывнейшымі бар'ерамі.
Цэнтральны організатор, або планаваць-выконаваць
Адміністратары выкананняя задачы дзеляе яе на часткі, прадаёць ўздоўжнікам і сумаваяе рэзультаты. Уздоўжнікі не коордынуюцца межа сабой; яны дапраўляюць адчыткі адміністратару. эта самая распашчастая і практычная стандартная мадэль. Яе трэба выкарыстоўваць, калі структура падзадач не вядома загадзя, але важна чыстае праблематычнае кераванне. Функцыя Research у Anthropic адпаведае самэй гэтай модэлі: адміністратар аналізуе запыт, паралельна запускае спецыялізаваныя пададміністратары і пазней сумаваяе тое, што яны знайшлі.
Не выкарыстоўвайце яе, калі працэс выкананняя ужо настаўна стабілізаваны так, што можна яго запісаць у вачорк; тады пайплайн будзе простэйшы і больш прагнозаваны.
Ягою характэрным недастаткам ёсць неспраўнае функцыонаванне керуючага прыстрою: калі главны агент дае нечысткія інструкцыі, працавальнікі пачынаюць павтараць адныя тое ж самае пошукі, прыглядаюць межы або даюць рэзультаты, якія не пасуюць адны да другых. Рашэнням яўнае наданне кожнам працавальніку чыткай меты, апэксыўванага фармата выходных дадзеных, інструкцый па джэрэлах і чысткіх меж задання.
Паралельныя спецыялісты, дэбаты і «команда працоўнікаў-супернікав»
У гэтым случае калькі агенты адразу выпалняюць адно і тое ж заданне або суседзяючыя падзаданні, а ўсе іх рэзультаты пасля таго голасуюць, крытыкуюць або агрэгуюць. Гэта падходзіць для сітуацыяў, дэ прыстойнасць мае меншое значэнне, чым стойкасць: супернацыянальныя адказы на проблему, крытычны аналіз рашэння па правілах, абезпековы аналіз з разных кантактов.
Цена ўсё зрозумела. Большая колькасць агентаў значыць значна большую колькасць токенав, большую кантрольную работу і рызык неправеднай паверы, якая выныходзіць з кансэнсусу. Як паведамляецца, сістэма даследжэнняў Anthropic была змушаная стварыць бюджэты на працу і строгейшую дэлегавання, каб запобiec таму, што працавальнікі будуць дзеяць без дысцыпліны. Іспользуйце гэты патэрн толькі тады, калі сама сфера даследжэнняяў практычна вымагае гэтага.
Swarm, або дэцентралізаваныя спільныя кантэксты
Коордынацыя выныходзіць з спільнага стану, спільных лямоў паведамленняў або зменаў у сяродовышчы, а не ад строгага лідэра. Хутчэй такія багатаягентныя сістэмы стаюць распадзеленымі сістэмамі, з усіма прынесенымі імі складнасцямі: неяснымі правамі на власнасць, супернічанням за доступ да спільнага стану і складным адлучэнням бягаў. Гэты падход падходзіць для справ, якія ў працоўнай практыцы застаюцца адкрытымі, дзе агенты павінны взаімаўрабачаць за межамі сесый або часу ўработкі. Ўтрымваюцеся ад яго, калі патрабуецца простая атрыбутабельнасць або строгае салідарнае дзеянне.
Для большынства працівнікаў першыя два патэрны пакрываюць практычна все.
Што пропонуе Anthropic сёння
Перш чым стварыць власную сістэму, варта пераканацца, што ужо існуе у Anthropic і што вучыць іхнія ідэі. Існуе калькі способаў для агентнай працы, і яны не ўзаемназаменны. Уявіце ся драбіну, якая ведае ад первіснага керавання да керавання праз хоста. Зображэнне ніжчэй паказвае стан на канець квітня 2026 года, а гэтыя продукты шыбкая змінююцца.
- Messages API. Вы абоўсумова керуеце цыклам. Існуе можлівасць вікорыстання інструментаў, але вы пішаеце логіку выканання, і няма вбудованай падтрымкі калькі агентаў. Гэта найболей гнучкі рывень, але і найбольша кількасць працы.
У практычнам сэнсе тверджэнне "Claude падтрымлівае команды агентаў" ёсць правдзівым, тады калі тверджэнне "Claude аддае можлівасць карыстацца рэштавочным, універсальным мульты-агентным кераваннем на будзь-якай плошчыне" — ні.
Komанды агентаў Claude Code у практыцы
Короткае нагадванне пра разлік:
- Падагенты працуюць унутрь адной галоўнай сесіі. Галоўны экземпляр Claude Code стварае іх; кожны з яных працуе самастойна ў сваёй сабеінстанцыі кантэксту і адправляе рэзультаты назад. Вы займаецеся кераваннем, а галоўная сесія ніколі не прыемлець працу, якая была выканана для атрымання рэзультата.
Настройка
- Канфігурацыя каманды знаходзіцца ў
~/.claude/teams/{name}/config.json. - Спяльны спіс задач знаходзіцца ў
~/.claude/tasks/{name}/. - Члэны каманды візначаюцца ў файлах агентаў, якія можна перадваіць, тое ў сэнсе — у візначэннях падагентаў, якім прызначаюцца ролі членам каманды.
- Hooks можаць выступаць як контрольныя пункты якасці между пераходамі задач.
Для дызайну важны два архітэктурныя аспекты. Першым ўсё ёсць тое, што падагенты можаць зберагаць свою саёмую памяць. Гэта дапамагае спецыялізацыі, але калі праца дзеліцца між кількома агентамі з аднародной памяцю, трэба прыміць архітэктурнае рашэнне пра тое, якія знанні застаюцца локальнымі, якія дзеляцца, а якія падсумовуюцца. Гэта ўпынак пытанняя дызайну сістэмы.
Другім аспектам ёсць тое, што дакументацыя чытра адзначае сітуацыі, калі каманды працуюць гэрш за падагенты: последовыя заданні, праверкі таго ж файлу і праца з большым колікствам залежнасцей між крокамі. Калі агенты вынужданы пасылаць той самы рэзультат па спадчынству, а не працаваць паралельна, падагенты ў последовамай лініі ўраджэння ёсць простымі і болей прыемлемымі.
Паколькі каманды ў тым моменты былі яшчэ эксперыментальнымі і за замовчаннем выключанымі, ўвядзіце іх толькі з ясной прычыны з вышэйшага спісу, і будзіце гатовыя да недосконаласцей.
Як агенты разважаюць між сабою
Комунікація між агентамі часта розглядаецца як проблема стымулювання. У масштабному вікорыстанні гэта стае проблемою сістэмі. Існуюць тры основні формі.
- Повідомлення простою мовою. Найбільш очэвідна форма, але найменш надыйна у масштабному вікорыстанні. Колегі з Claude Code обмінююцца повідомленнямі непасрэдна праз поштову скрыньку. Гэта гнучко, але прыродна мова менш точна параўнано з структурованімі віклікамі, што створуе більшэ можлівостэй для неправільного розуміння між агентамі.
- Структурованій віклік. Вікорыстання візначэнь інструментаў у фарматы JSON Schema і суворэ дотрымання правіл іх вікорыстання. Візначэння інструментаў у Anthropic гарантуюць, што аргументы відповідаюць схемі. Гэты механізм робіць комунікацію між агентамі і інструментамі надыйною, а таксама забезпечуе більш точні взаемодыі між самімі агентамі у вігляды структурованіх вікліків замест вільніх повідомлень.
Час такі ж важны, як і фармат. Выдвігаецца чатыры патэрны:
- Сінхронныя вызовы. Керавальнік вызывае спецыяліста, чакае, а потым продаўжае. Лёгкае для разумення, але можа стаць вузкам местам. Команда даследнікаў Anthropic, як паведамляецца, з’явіла, што сінхронная екзекуцыя галоўным агентам блакуецца праз повольных працоўнікаў, і выключыла можлівасць керавання падчас выканання.
Тое, як агенты перадаюць адзін другаму інфармацыю, вялічына якой залежыць ад таго, якія фарматы вонi выкарыстоўваюць, паставляе надзею на надзейнасць цэлага сістэмы. Перадача всей історыі размовы максымізуе працэйную цэласнасць, але лінейна зростае вартасцю і часам адклікання. Часта лепшым выходам ёст тэрмінаваная асунуць, і самэ гэта робяць падагенты Claude Code за сваім прызначэнням. Перадача спецыяльных для задання артыфактав, такіх як структураваныя файлы выходных дадзеных, патчы коду, спісы функцый у фармаце JSON і зберажаныя атласы, як правіло, ёст практычна оптымальная альтэрнатыва. Агент, які прымае інфармацыю, можа безпасебна пераглядаць сам артыфакт узамен на паверненне асунуці, што робіць сістэму болей працэйна для аўдытавання, чым можа гэта зрабіць перадача інфармацыі праз размову.
Тое, што перадаецца, таксама вялічына як і калі гэта водзіцца да чынення, падкрэпляе галоўную ідэю: стварэнне команд агентаў — гэта задача праектавання сістэмы, і яе рашэнне ёст складнейшым, чым стварэння лінейнага, організаванага прайсупутку.
Вось восем спосабоў, якімі команды агентаў паспяшаюць
Большасць навчальных матэрыалаў для кантролюеў прыменяецца не гэтую частку. Інжынерныя нотаткі Anthropic ёсць хорашым джэрэлам. У іх менш схожа на науковую студыю, а больш — на дзеннік команды, якая шаг за шагам вывучыла, як додатковые агенты паўтараюць проблемы керування. З іх можна выяўіць восем урокаў.
- Коордынацыйны дрэйф. Нечыстая дэлегавання змушвае працоўнікаў павтараць адзіныя і тыя ж пошукі, прапускаць межы або вяртаць выходны даныя, якіе не складаюця целысна. У доследжэннях Anthropic было показана, што рашэннем являецца навчанне організатора адзначаць цель, фармат выходу, вады і межы для кожнага агента. Калі власнасць не ўзначэна, агенты імпровізуюць, як і людзі.
Натыўны, самастоятэльны чы гібрыдны
Такім чынам, глыбокая запытанне: стварыць сістэму каляранавання самі, чыра выкорыстоўваць готовае рашэнне? Цэх архітэктурны выбар между трыма варыянтамі, і, без сумнева, іх ўсё больш, таму спрыймайце гэта як адну з точак зору.
- Натыўны кераваны значыць, што Anthropic володзіць срэдой выканання і механізмамі коордынацыі: Claude Managed Agents, а таксама Managed Agents multiagent чыра Claude Code agent teams. Прычынныя перавагі — меньшы інжынерны наклад, хоставаная платформа і інфраструктура, якія не трэба падтрымваць. Недзеянкі — обмежаная перэноснасць (Managed Agents доступны толькі праз прымытую Claude API), механізмы коордынацыі для калькі агентаў, якія ў тэставанні чыра знаходзяцца ў прыватным прэвью, і залежнасць ад трэцьей стороны. Выберыце гэты варыянт, калі проблема — інфраструктура, а спецыфічныя для Anthropic абмежэння ўзьемлівыя.
Корача: натыўны кераванні, калі проблема — інфраструктура; самастоятэльны падход, калі проблема — топологія і правілы; гібрыдны падход, калі хочаце вядомасцяў Anthropic, але патрэбны прастор для савых архітэктурных рашэнняў.
Пытанне архітэктуры
Сярод найбольш частаю прынесеных людзьмі ідэяў для команд агентаў — гэта спакойнасць у паводзе ўмоўнасцяў, на адной з гіпатэзаў якой больш агентаў значыць большую спакойнасць. Аднак корыстным падходам являецца архітэктура: якую проблему рашае дадатковы агент і скількі гэта коштуе?
Падагенты вырашаюць, хто будзе выканаць работу, у якім кантэксце і з якімі інструментамі. Команды агентаў дадаюць да гэтага слой коордынаціі, які включае спяльны статус заданняў, можлівасць працаваць у тым жа часе і адразу перадаваць сябе паведамленні, а таксама механізмы паралельнага выканання заданняў. Такі слой ёсць корыстным толькі для проблем, якія даслівна выкарыстоўваюць такую падтрымку.
Адаптаваныя к рэальным умовам команды з агентамі — гэта розумны тыдзень работы. Складнасць можа вырастаць пазней, але не обавязкова почынацца з гэтаго. Пераказ каскада абяроненняў і шаблоны кантактаў служаюць матэрыялам для аднаго кансультавання, а не планам для стварэння всьго заўсёды разам. Пачніце з выявлення таго, калькі з чатырых фактараў насправды справядлівы, а якшо ніхто — тады варыянт з адным агентам таксама ёсць правільным.