---
title: Работа агентов – Документация Agent Teams
description: Жизненный цикл задач, канбан-доска, сообщения, task logs, параллельная работа, live processes и cross-team communication.
lang: 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.
