Координируем и управляем агентами Claude Code (гайд по работе с агентами Claude Code)
Claude code оркестраторский воркфлоу
Канал с гайдами и контентом по ИИшкам и что с ними можно реализовывать, мы выписываем абсолютно всю базу по ИИ в наш канал и там другие полезные материалы: https://t.me/claudedevolper
Для общего понимания рекомендую прочитать гайд по установке плагинов и про сам клод код, что это такое и как работает.
/plugin marketplace add mbruhler/claude-orchestration
/plugin install orchestration@mbruhler
После установки не нужно ничего перезапускать, можете проверить командой /orchestration это покажет несколько опций, скоро к этому придем.
Как работает этот плагин? Он позволяет добавить ваших агентов, после создать воркфлоу и подвязать их туда. То есть воркфлоу — решает вашу задачу, агенты исполнители этой задачи. И их нужно сейчас будет прописать отдельно.
Да, есть и другие аналогичные плагины. Можете поизучать, я взял один из самых популярных и очевидных. Мне он показался сверх доступным и простым.
Для примера я сделаю свой ресерч-воркфлоу, как раз используя плагин Tavily для ресерча, такая опция есть. Агенты могут использовать и ваши установленные плагины.
Начнем с общей идеи и структуры
- Нужно решить какую задачу мы закрываем, у меня ресерч
- Необходимо определить как вообще правильно ресерчить, какую проблему я решаю?
- Нужно решить какая конечная цель ресерча, для меня это готовые и понятные гайды зачастую
- Могу ли я что-то докинуть к этому, выстроить процесс под разные виды ресерча?
Это достаточно сложный процесс, у меня случился даже ступор. Один агент ищет, другой проверяет, третий пишет? За помощью себе я пошел посмотреть примеры.
В итоге вот как я для себя сформулировал задачу, которую передал claude code, чтобы он прописал каждого агента. Пользуемся главной фишкой приложения — сам создаст файлы, заполнил и настроит любые параметры, что потребуются.
Твоя задача прописать несколько AI агентов, которые будут позже добавлены в воркфлоу для ресерча. Сейчас я тебе опишу общую задачу, запусти режим планирования и задай мне уточняющие вопросы, чтобы лучше спланировать всю архитектуру и промпты этих агентов, включая добавления к ним плагинов.
Вот мой концепт:
0. Агент собеседник, публичное лицо. Этот агент отвечает за все реплики, коммуникацию с юзером на протяжении всей работы в воркфлоу. Он отвечает доступным русским языком, старается быть человечным и вежливым. При этом сохраняет холодность и честность. При любых сомнениях говорит честно, что не знает или не уверен.
Старается быть кратким и не давать никакой лишней информации, но если ему кажется важным что-то раскрыть дополнительно, он спросит разрешения, требуется ли это юзеру.
Именно этот стиль общения должен сохраняться на протяжении всей работы. Остальные агенты работают не зримо и передают информацию через агента собеседника.
1. Агент старший ресерчер, получает тему поиска/исследования. Сначала он анализирует запрос, который будет в одной из областей:
- AI тематика. Какие сервисы/приложения есть, какие плагины можно добавить к Claude code и так далее. Главная задача здесь найти готовые решения, гайды, советы по настройке и активные репозитории гитхаб + сайты при этом подробно мне рассказать что это, как работает, зачем и как можно иначе- Решение бытового вопроса. Настройка приложения на ПК, работа с гаджетом, разрешение какое-то ошибки, может быть рецепт курицы. Такой поиск предполагает фокус на решении конкретной проблемы, фокусируясь именно на ней.- Криптовалюты, рынок, WEB3. Здесь требуется заняться аналитическим исследованием, найти всю информацию об монете, акциях, компании, инвестициях. Главное охватить все данные, что так или иначе касаются темы
Затем запускает режим планирования и задает мне 5 уточняющих вопросов по теме. Что расширить или сузить поиски, расставить приоритет тем в ответе.
Для поисков он использует Tavily плагин, а также базу знаний самой нейросети, может запускать два или три дополнительных поиска, чтобы перепроверить самого себя.
Ключая задача для всех поисков не только охватить всю релевантную информацию, но и не допускать выдумок. Если агент не знает точно, сомневается в информации, он оставляет прямые указания на это в своем исследовании.
Сохранять его нужно в отдельной папке в Obsidian, папка "Ресерчи и исследования", давая наименовие по теме поиска.
2. Агент редактор, он обращается к сохраненному файлу исследования и перечитывает его. Например он замечает, что гайд по установке не релеватный или цифры кажутся противоречивыми, запускает свой небольшой ресерч и проверяет.
Также он запускает ресерч если видит пропущенную информацию, например есть гайд по установке приложения из docker, но не прописан гайд по установке docker.
Если не удается разрешить расхождения в информации или сомневается - прямо об этом пишет. Чтобы юзер мог сравнить лично.
После того как информация актуализирована, редактор дает краткую выжимку по теме и успешности выполнения задач, что сейчас из себя представляет ресерч. Для шаблона он показывает чек-бокс:
- Исследование охватывает тему, рассказывая о ней- Был составлен массивный гайд по конкретному запросу- Есть примерный план решения проблемы- Информация сомнительна или ее слишком мало- Информации очень много и она покрывает тему слишком широко- Рекомендуется повторить исследование по причине/теме (пишет какой)
Если юзер согласен с общим состоянием ресерча и считает, что работа проделана хорошо, то агент редактор приступает к написанию итогового гайда/ресерча/статьи, сохраняя его в папку "Гайды, разборы" в том же самом Obsidian.
Затем агент для общения уведомляет о проделанной работе, и будет отвечать на уточняющие вопросы, цитируя информацию из итогового документа до момента пока юзер не даст прямо новое указания "Найти, изучить какую-то тему". В таком случае он снова запускает процесс, чтобы создать уже новое исследование.
Там иишка уточнит формат написания, куда чего сохранять/удалять. Дать ли имя агенту номер 0 и так далее. Так что сами разберетесь и сможете настроить под себя. Тем более, что готовых агентов всегда можно переписать это будет 3 отдельных файла.
Я там прописал уточнение на счет имен, чтобы потом не перепутать их, все агенты с припиской ресерчеры. Ну и все, дальше клод автоматически все сделает. В том числе уточнит разные детали, вроде стиля ответов с примерами нейронке.
Одной рукой набираю текст в терминале, другой слезы счастья вытираю..
К слову, вы можете заготовить универсальных агентов, которые будут способны работать в разных воркфлоу. Поэтому все зависит от ваших задач и фантазии.
Если вдруг автоматически агенты не были добавлены — /orchestration:init
А чтобы начать запускаем команду — /orchestration:menu
В меню можем создать новый воркфлоу.
Что забавно, когда я тестировал.. он мне меню расписывал на русском. Попросил напрямую, как же это удобно. Но я решил не делать новый я загрузить существующий.
Правда он создан не был, однако клод заботливо предложил его прямо там и создать, опираясь на пайплайн добавленных мной трех агентов. Так он делает шаблон в котором мы и будем работать в дальнейшем.
Ну и все, далее мы получаем функциональный рабочий инструмент, который методами оркестрации решает наши поставленные задачи. Время переходить дальше.
Убедитесь, что воркфлоу сохранен как .flow, а не .md, нейросеть может не верно записать. В таком случае все будет лежать как надо и работать как задумано.