7 KiB
| title | description | lang |
|---|---|---|
| Работа агентов – Документация Agent Teams | Жизненный цикл задач, канбан-доска, сообщения, task logs, параллельная работа, live processes и cross-team communication. | ru-RU |
Работа агентов
Agent Teams делает работу агентов видимой через task state, messages, logs и reviewable code changes.
Режимы
| Режим | Описание |
|---|---|
| Solo | Один teammate с самостоятельным управлением задачами |
| Team | Несколько teammates, работающих параллельно и ревьюящих друг друга |
Оба режима используют одну и ту же канбан-доску, логи задач и поверхность код-ревью.
Жизненный цикл задачи
Agent Teams отслеживает каждую задачу в двух независимых измерениях: work status и review state.
| Измерение | Состояния | Описание |
|---|---|---|
| Work status | pending, in_progress, completed |
Отслеживает, ожидает ли задача, активно выполняется или завершена исполнителем |
| Review state | none, review, needsFix, approved |
Отслеживает положение задачи в процессе ревью после завершения |
На канбан-доске отображается комбинированное представление, но два измерения движутся независимо.
Рабочий статус
| Этап | Что происходит | Ответственный |
|---|---|---|
| Pending | Задача создана, но никто ещё не начал работу | Lead или пользователь |
| In progress | Агенты работают и обновляют статус через board MCP tools | Teammates |
| Completed | Исполнитель публикует result comment и помечает задачу завершённой | Teammate |
Статус ревью
| Этап | Что происходит | Ответственный |
|---|---|---|
| None | Задача ещё не на ревью (может быть pending, in progress или только что completed) | — |
| Review | Запрошено ревью; reviewer проверяет diff и результат | Reviewer |
| Needs fix | В ходе ревью запрошены правки; исполнитель должен обновить задачу | Teammate (owner) |
| Approved | Ревью пройдено; задача финализирована | Reviewer |
Planning → In progress
Когда teammate берёт задачу, work status меняется на in_progress. Агент создаёт task comment с планом работы и продолжает. Все нативные инструменты (read, bash, edit, write) попадают в task log.
Completed → Review
Когда teammate завершает работу, он публикует result comment и помечает work status как completed. Lead или reviewer могут запросить ревью для начала проверки.
Review → Approved
Если изменения в review surface выглядят приемлемо, утвердите ревью. Задача финализируется и связывается со своим diff.
::: warning Ревью с правками Если teammate попросили внести правки во время ревью, он должен добавить follow-up comment с исправлениями, после чего lead может approve. :::
Канбан-доска
Доска — основной рабочий экран. Через неё удобно:
- Смотреть открытые, заблокированные и на ревью задачи
- Открывать task detail и инспектировать runtime logs
- Ревьюить изменения без чтения raw session files
- Назначать или переназначать владельцев
::: tip Используйте quick action buttons на карточках для старта, завершения или запроса ревью, не открывая detail panel. :::
Сообщения и комментарии
| Канал | Когда использовать |
|---|---|
| Direct message | Перенаправить агента, задать быстрый вопрос |
| Task comment | Заметки, относящиеся к конкретной задаче |
Комментарии сохраняют контекст для последующего ревью и появляются в timeline задачи.
::: tip Предпочитайте task comments Если заметка касается конкретной задачи, добавьте её как комментарий к задаче, а не как direct message. Это сохраняет историю, привязанную к работе. :::
Логи задач
Task-specific logs изолируют runtime output, actions и messages по одному assignment. Они помогают понять:
- Что агент запускал?
- Почему он изменил этот файл?
- Просил ли он помощи у teammate?
- Какая задача породила diff?
Параллельные паттерны работы
Teammates могут работать над независимыми задачами одновременно. Вы также можете создавать dependency links (blocked-by), чтобы одна задача ждала завершения другой. Следите за blocked lanes на доске и переназначайте владельцев, если один teammate простаивает, а другой перегружен.
Процессы в реальном времени
Live process section показывает URLs и running processes, когда агенты поднимают локальные servers или tools. Открывайте URL прямо из приложения. Процессы остаются зарегистрированными, пока не будут явно остановлены или runtime не завершится.
Межкомандное взаимодействие
Агенты могут отправлять сообщения другим командам, когда команды связаны. Используйте это для handoffs, shared libraries или проверки статуса между squad.