Передача задачи между ИИ-агентами: пакет, приёмка и возврат
Handoff между ИИ-агентами — это контролируемая смена владельца задачи. Отправитель передаёт цель, подтверждённое состояние, ссылки на результаты и открытые вопросы; получатель проверяет полномочия и либо принимает работу по явному критерию, либо отклоняет её с причиной.
Передача задачи между ИИ-агентами нужна, когда текущий исполнитель больше не должен вести работу сам: ему не хватает специализации, полномочий или подходящего набора инструментов. Надёжный handoff — не фраза «продолжи отсюда» и не пересылка всего диалога. Это отдельная операция со структурированным пакетом, проверкой получателя, подтверждением приёмки и правилом возврата результата.
До приёмки владельцем остаётся отправитель или оркестратор. После приёмки получатель отвечает только за явно переданную цель в пределах своих прав. Если пакет неполон, адресат неизвестен или нужное действие запрещено, получатель не должен угадывать: он отклоняет передачу, запрашивает недостающие данные либо переводит задачу человеку.
Общая архитектурная граница разобрана в материале о том, чем ИИ-агент отличается от чат-бота. Здесь рассматривается более узкий результат: как один исполнитель прекращает владеть задачей, другой принимает её, а система сохраняет непрерывность и ответственность.
Handoff и вызов агента как инструмента — не одно и то же
При вызове специалиста как инструмента основной агент сохраняет управление: формулирует подзадачу, получает ответ, объединяет его с другими результатами и выдаёт финальный итог. При handoff активный исполнитель меняется, и получатель ведёт оставшуюся часть работы. Это различие важно для журнала, полномочий и пользовательского интерфейса: должно быть понятно, кто сейчас отвечает за следующий шаг.
Документация OpenAI Agents SDK описывает оба паттерна отдельно. Handoff передаёт управление специалисту, а agent-as-tool оставляет итоговую ответственность у управляющего агента. Документация также позволяет задавать структурированный ввод передачи и фильтровать историю, которую увидит получатель. Ниже приведён учебный пример структуры передачи, не привязанный к конкретной библиотеке.
Не принята ли эта передача раньше; действительно ли задача адресована этому исполнителю
Цель
один ожидаемый результат и границы задачи
Понятно ли, что считать завершением; не смешаны ли разные намерения
Подтверждённое состояние
решения, версии, факты и ссылки на результаты
Можно ли восстановить состояние без догадки; отмечено ли происхождение каждого значения
Открытые вопросы
неизвестные данные, конфликты и незавершённые проверки
Нужно ли запросить уточнение до действий
Полномочия
разрешённые инструменты, область данных, запрещённые действия
Может ли получатель выполнить задачу без расширения прав
Критерий приёмки
условия accept, reject и return
Когда сменяется владелец; как вернуть неполный или спорный результат
Маршрут результата
кому и в каком формате вернуть итог и доказательства
Не потеряется ли результат после завершения специалиста
Учебный контракт передачи. Поля и значения вымышлены и не являются записью реального запуска.
Пакет должен передавать состояние, а не литературный пересказ процесса. Вместо «мы почти закончили» полезнее записать: выбран документ версии B, подтверждены два условия, третье отсутствует, следующий разрешённый шаг — запросить уточнение. Такой формат позволяет получателю отличить уже проверенное от предположения.
Ссылки на артефакты предпочтительнее копирования всего содержимого. Передавайте идентификатор результата, версию и короткое назначение; сам объект получатель читает через разрешённый канал. Это уменьшает риск устаревшей копии и помогает проверить доступ. Если результат нельзя открыть, приёмка не должна считаться успешной.
Правила хранения такого состояния раскрывает материал про память ИИ-агента: временный пакет handoff относится к текущей задаче и не должен автоматически становиться долговременной памятью. Получатель использует переданные записи в их области, а после завершения закрывает или обновляет состояние.
Шаблон handoff-пакета
Шаблон передачи задачи между агентами
handoff_id: handoff-example-17
task_id: task-example-8
from: coordinator-agent
to: document-check-agent
goal: проверить три условия в указанном документе
accepted_evidence:
- result-example-1: выбран документ версии B
- result-example-2: условия 1 и 2 подтверждены
open_questions:
- условие 3 в документе не найдено
allowed_actions:
- read_document
- create_review_draft
forbidden_actions:
- publish
- change_source_document
accept_if:
- документ версии B доступен
- права чтения подтверждены
return_format:
- status
- checked_conditions
- evidence_references
- unresolved_questions
reject_if:
- версия недоступна
- задача требует запрещённого действия
У шаблона нет поля со скрытыми рассуждениями. Получателю нужны наблюдаемые решения, доказательства и ограничения. accepted_evidence означает не «поверь отправителю», а «вот ссылка на результат, который можно открыть и проверить». open_questions запрещает выдавать неизвестное за завершённую часть.
Приёмка должна быть отдельным событием
Передача не завершена в момент, когда модель предложила выбрать другого агента. Сначала доверенный слой проверяет, зарегистрирован ли получатель, разрешён ли маршрут и соответствует ли пакет схеме. Затем получатель проверяет доступ к указанным результатам и свои полномочия. Только после события accepted меняется владелец задачи.
Отклонение — нормальный результат, а не системная авария. Причина может быть конкретной: неверный адресат, отсутствующий артефакт, конфликт версий, слишком широкая цель или запрещённое действие. Отправитель либо дополняет пакет, либо выбирает другой маршрут. Повтор той же передачи должен использовать прежний handoff_id, чтобы система не создала две независимые работы.
Каждое предложение, принятие, отклонение и возврат полезно фиксировать в трассе выполнения агента. По trace_id и handoff_id можно восстановить момент смены владельца, увидеть проверку прав и отличить повтор доставки от новой задачи.
Вымышленный сценарий: проверка документа
Координатор получил задачу подготовить краткую карточку внутреннего документа. Он нашёл нужную редакцию и подтвердил два условия, но третье требует специалиста по проверке документов. Координатор не передаёт весь диалог. Он формирует пакет из цели «проверить три условия», ссылки на редакцию B, двух подтверждённых результатов, одного открытого вопроса и запрета на публикацию.
Специалист открывает ссылку и видит редакцию B, поэтому принимает handoff. Он проверяет третье условие и обнаруживает, что оно в документе не указано. Правильный итог — вернуть статус completed_with_unknown, ссылки на два подтверждения и открытый вопрос по третьему условию. Неправильный итог — вывести условие по аналогии или заменить исходный документ.
Координатор получает возвращённый пакет и остаётся владельцем финальной карточки. Он пишет два подтверждённых пункта, третий помечает как неизвестный и просит владельца документа уточнить его. Здесь handoff не устраняет неопределённость, а сохраняет её и делает видимым место, где потребовалось решение человека.
Как проверить передачу на контрольном наборе
Успешная передача: получатель имеет нужный инструмент, открывает все результаты, принимает пакет и возвращает итог в заданной форме.
Неполный пакет: отсутствует обязательная версия или критерий готовности; получатель отклоняет передачу без выполнения действий.
Неверный адресат: у получателя нет нужной специализации либо доступа; система выбирает допустимый маршрут или эскалирует человеку.
Повтор доставки: одинаковый handoff_id не создаёт вторую работу и возвращает уже известный статус.
Запрещённое действие: пакет просит публикацию, хотя разрешено только создание черновика; проверка полномочий останавливает действие.
Возврат с неизвестным: получатель сохраняет открытый вопрос и не заменяет его правдоподобной догадкой.
Для каждого случая заранее укажите ожидаемого владельца после события, допустимые инструменты, обязательные поля результата и условие остановки. Проверяйте не красоту финального текста, а последовательность: предложено, проверено, принято или отклонено, выполнено, возвращено.
Пакет удобно валидировать как структурированный JSON от ИИ, но соответствие схеме гарантирует только форму. Приложение отдельно проверяет, существует ли task_id, доступен ли результат, разрешён ли адресат и соответствует ли возвращённый статус фактическому действию.
Типичные ошибки handoff
Первая ошибка — переслать всю историю без отбора. Получатель получает лишние данные, старые версии и инструкции из недоверенных источников. Вторая — не определить момент смены владельца: оба агента продолжают работу или каждый считает, что отвечает другой. Третья — передать цель без критерия приёмки, поэтому специалист не знает, когда возвращать результат.
Четвёртая ошибка — расширить права вместе с передачей. Handoff выбирает исполнителя, но не должен автоматически выдавать ему новые инструменты или доступ к чужим данным. Пятая — считать красивое резюме доказательством выполненной работы. Любой заявленный результат должен ссылаться на фактический вызов, артефакт или проверенное состояние.
Критерий готовности
Механизм передачи готов к ограниченному использованию, если система однозначно знает текущего владельца, получатель может принять или отклонить пакет до действий, каждое полномочие проверяется доверенным кодом, повтор не создаёт дубль, а результат возвращается с доказательствами и неизвестными. Контрольный набор должен сохранять эту последовательность после изменения инструкции, агента или схемы пакета.
Если пакет нельзя восстановить по журналу, история передаётся без фильтра, полномочия не проверяются или неизвестное исчезает при пересказе, handoff остаётся непрозрачным маршрутом. Сначала сократите пакет до наблюдаемых данных и явных правил приёмки; добавлять новых агентов до этого рано.