Наблюдаемость агента в процессе возобновления: образец выдачи расписки

Наблюдаемость агента обычно отвечает на то, что произошло в течение одного пробега. Это полезно, но этого недостаточно, когда агент делегирует работу, выходит, запускает или ждет другого агента. Практическое решение заключается в получении долгосрочной передачи : небольшой запись, написанная за пределами каждого из процессов, в которой указывается, кто принял работу, какой результат ожидается и какие доказательства ее завершат. Сохраняйте следы для дебгагирования. Добавьте квитанции для непрерывности. Отслеживание может показать, что орудие передачи успешно возвращено; квитанция сообщает оператору, принял ли получатель задачу и был ли обещанный артефакт позже проверен. Краткий ответ: следите за границей, не только за ходом. Передача является здоровой только тогда, когда можно различить четыре различных события: 1. отправитель делегировал ограниченную задачу; 2. получатель признал такую же задачу; 3. был зафиксирован полезный прогресс или законное ожидание; 4. ожидаемый результат был подтвержден. Эти события могут происходить в различных процессах и различных следах. Они могут быть разделены отсрочкой очереди, перезагрузкой хозяина или человеческим одобрением. Отношение к ним как к одному промежутку времени в памяти создает хрупкую зависимость: контекст, объясняющий работу, может исчезнуть с процессом. OpenTelemetry описывает распространение контекста как механизм, который позволяет собирать вследствие различных процессов. Он также обеспечивает ссылки на протяженность для причинно следственных связанных асинхронных операций, где позднейшая работа не может быть простой детской протяженностью. Это решает корреляцию. Он не определяет правила обещания, принятия или проверки результатов вашего заявления. Квитанция заполняет этот пробел. Он преднамеренно меньше, чем транскрипт и более ясен, чем логическая линия. Где обычный след перестает помогать Подумайте о исследовательском агенте, который поручает другую работу по проверке источника. Отправитель записывает успешный пробег и выход handoff . Через десять минут работник начинает новый процесс, находит один недоступный источник и ждет одобрения для использования альтернативы. Три штата теперь могут выглядеть обманчиво похожими: задача по прежнему находится в очереди и никогда не была принята; работник принял его и законно ждет; рабочий выполнял команду, но никогда не представил запрошенный документ. Продолжительность, которая завершила передачу, не может решить между ними. Его успешный конец означает, что операция передачи вернулась без ошибок. OpenTelemetry ясно указывает, что статус интервала описывает операцию, отслеживаемую этим интервалом. Это не является доказательством того, что последующий бизнес вывод существует. SDK OpenAI Agents иллюстрирует ту же границу с другого направления. Это Встроенные записи отслеживания пробегов, звонков инструментов, передач, ограждений и пользовательских событий. group id может ассоциировать несколько следов, а handoff span может показывать делегирование. В SDK также отмечается, что экспорт следов осуществляется в партии и может потребоваться прямой отказ в экспорте, если это касается немедленной доставки. Богатое отслеживание улучшает наличие доказательств для дебгагирования; оно все еще нуждается в внешнем правиле для выполненной проверки. Вот почему наблюдаемость агента не должна разрушать выполнение команды в результате выполнения. Минимальный контракт на выдачу квитанции Сохраняйте только один запись за переходный период. Сохранение может быть таблицей базы данных, длительным журналом очереди или файлом NDJSON на одном хосте. Важным свойством является то, что ни один из участников процесса не владеет единственной копией. Вот компактная форма события: Шесть полей несут большую часть значения: operation id является долгосрочной идентичностью работы, видимой пользователем. Он переживает повторные попытки и перезагрузки. handoff id определяет одну попытку делегирования. Повторный попытка получает новый идентификационный номер вместо переписки истории. event является одним из delegated , accepted , progress , waiting , completed или outcome verified . expected artifact определяет цель детерминистической проверки. Он также может назвать тест, условие API или решение о пересмотре. trace id указывает на подробную телеметрию, не делая расписку зависеть от этой телеметрии. reason объясняет неисправность ожидания, отказа или проверки в ограниченных оперативных терминах. Не указывайте в данный запись запросы, удостоверения личности, выпуск модели или полезные нагрузки на сырые инструменты. Квитанция это индекс и государственная машина, а не второй отслеживающий бэкэнд. Разумным дефолтом являются переходы только приложения плюс производное текущее состояние. Обновление одного изменяющегося строка соблазняет, но уничтожает доказательства, необходимые для того, чтобы отличить задержанное признание от отсутствующего. Перед выбором оповещений воспроизведите случаи сбоев Сопутствующее устройство для данной статьи содержит четыре операции: проверенное передача, незарегистрированная делегация, законное ожидание одобрения и ложное завершение без проверенного артефакта. Классификатор преднамеренно детерминист. Попробуйте: Ожидаемый результат: Из этого небольшого теста выпадают две наблюдения. Во первых, задержка подтверждения и проверка результатов являются независимыми. op 101 может быть принят быстро и все равно не удается позже; op 102 уже нездоровый до начала любого моделирования или выполнения инструмента. На панели, ориентированной на отслеживание, которая начинается с исполнения получателем, сироты не будут видены. Во вторых, ожидание требует объявленной зависимости. op 103 не имеет никаких последних успехов, но считать его застрявшим было бы неправильно, потому что квитанция называет одобрение, которое ему нужно. Отсутствие активности становится действенным только в сочетании с состоянием и ожиданием. Лимит признания 120 секунд в фиксации является примером, а не универсальным порогом. Установите его из наблюдаемой задержки доставки в очереди и срочности выполнения задачи. Работа в партии может терпеть минуты; интерактивная передача может терпеть секунды. Инвариант это переход, а не число. Сохранить причинность без превращения метаданных в утечку Используйте идентификатор следа в качестве указателя и распространяйте только идентификаторы, которые на самом деле нужны рабочим. OpenTelemetrys Руководство багажом предупреждает, что багаж обычно отправляется в заголовках HTTP, может достигать непреднамеренных третьих лиц и не имеет встроенных проверок целостности. Это делает сырые цели, клиентский текст, пути файловой системы и учетные данные особенно плохими значениями распространения. Более безопасная граница выглядит вот так: размножают непрозрачную operation id и handoff id ; создать ссылку с протяженностью от отслеживания, получающего, к отслеживанию, делегирующему, когда время выполнения его поддерживает; сохранять ожидаемый артефакт и состояние одобрения в надежном долговечном хранилище; разрешать идентификаторы в чувствительном контексте только внутри разрешенной границы хоста; Подтвердить автентичность авторов расписки, потому что корреляционные метаданные не являются доказательством идентичности. Есть компромисс. Минимальный квитанция не может объяснить почему модель выбрала инструмент или воссоздать весь разговор. Это преднамеренно. Используйте следы и журналы для детального расследования, при соблюдении ваших правил сохранения и конфиденциальности. Используйте квитанции, чтобы надежно ответить на небольшой оперативный вопрос: переместилась ли ответственность и был ли выполнен обещанный результат? Преобразовать квитанции в состояние оператора Избегайте одного красного или зеленого статуса. История получения поддерживает пять штатов с различными ответами: Working : принято с недавним полезным прогрессом. Не прерывай. Waiting : неизвестна внешняя зависимость или решение человека. Направьте запрос вместо повторной попытки. Stuck : принято, не ожидается, и никаких полезных прогрессов в окне доказательств задачи. Приготовьте один ограниченный выздоровление. Uncertain : записи не согласны, автору не доверяют или требуемые доказательства недоступны. Спросите, прежде чем выступить. Неудачный результат : выполнение завершено, но проверка артефакта не удалась или никогда не произошла. Возобнови результаты, а не весь след. Граница восстановления имеет значение. Передача в качестве сирот может обосновать повторную доставку, если действие не имеет возможности и ограничение повторной попытки известно. Не следует перепробовать ожидающее передача только потому, что истек срок. Состояние ложного успеха должно запускать отсутствующий верификатор или запрашивать отсутствующий артефакт; воспроизведение всего агента может повторить побочные эффекты. За каждый автоматизированный ответ записывайте полномочия, максимальные попытки, затраты или сроки, а также доказательства того, что восстановление будет успешным. Командование отступления вышло из нуля недостаточно, когда первоначальным обещанием было опубликованное сообщение, объединенное изменение или доставленное сообщение. Что это означает для Sidewisp Эта схема получения соответствует оперативным вопросам, которые Sidewisp разрабатывает для уточнения: работает ли агент, ждет, застрял, не уверен или не достигнет обещанного результата. Она также уважает необходимые границы продукта: диагностика предшествует любому выздоровлению, а последовательные действия требуют явного разрешения. Sidewisp сейчас находится на этапе закрытого предварительного доступа. Его общественный сайт и система статей живы, в то время как коллекция продуктовых агентов здравоохранителей, адаптеры запуска и автоматическое восстановление обычно не доставляются. Таким образом, вышеуказанная схема представляет собой нейтральный проект по времени выполнения, который вы можете реализовать и проверить сегодня, а не утверждение о том, что Sidewisp уже собирает эти квитанции. Если ваши агенты становятся непрозрачными в случае перепродажи, присоединяйтесь к частному просмотру и опишите время, хранение квитанции и границу одобрения, которые вам нужны. Эти доказательства более полезны, чем общий запрос на больше следов.