Наблюдаемость для Email-агентов
Вы не можете наблюдать за работой email-агента в режиме реального времени.
Но вы можете увидеть всё, что он сделал вчера, всего одним вызовом API.
Создание агентов на базе электронной почты обеспечивает встроенную наблюдаемость. Большинству автономных систем требуются дополнительные инструменты для трассировки и ведения логов. Email-агент получает это бесплатно, так как почтовый ящик и есть журнал записей.
Вот как использовать электронную почту для мониторинга ваших агентов:
Мониторинг входящих данных Каждое входящее сообщение вызывает событие
message.created. Это предоставляетthread ID, необходимый для восстановления контекста беседы. Если сообщение слишком большое, ищите триггерmessage.created.truncated. Он указывает на то, что полный текст тела письма нужно получить по ID.Мониторинг исходящих данных Платформа сообщает о каждой отправке. Отслеживайте эти три триггера, чтобы контролировать состояние доставки: •
message.send_success: Сервер получателя принял письмо. •message.send_failed: Правило или политика заблокировала исходящее письмо. •message.bounce_detected: Удаленный сервер отклонил письмо.
Рост количества send_failed — это первый признак проблемы. Это означает, что какое-то правило или квота ограничивает (throttling) вашего агента.
Мониторинг состояния Папки почтового ящика работают как конечный автомат. • Папка «Спам» (Junk): показывает, что отлавливают ваши спам-фильтры. • Папка «Черновики» (Drafts): служит очередью одобрения для систем с участием человека (human-in-the-loop). Если черновик висит там слишком долго, ваш процесс одобрения застопорился. • Папка «Отправленные» (Sent): идеальный журнал аудита. Журнал не может противоречить реальности, потому что электронное письмо и есть сама реальность.
Мониторинг управления (Governance) Если агент пропускает сообщение, проверьте оценку правил. Вы можете запросить, почему правило отклонило сообщение на уровне SMTP. Это заменяет догадки точными данными.
Одно ограничение, о котором стоит помнить: вы можете отслеживать доставку, но через этот API нельзя отследить, открыл ли человек письмо или перешел ли по ссылке. Вам также необходимо логировать собственные рассуждения (логику). Почтовый ящик показывает, что сделал агент, но вы должны записывать, почему он решил это сделать.
Начните с отслеживания этих трех событий:
message.send_successmessage.send_failedmessage.bounce_detected
Сбои на входе — громкие и очевидные. Сбои на выходе — тихие. Отслеживание этих сигналов помогает находить ошибки за минуты, а не за недели.
Source: https://dev.to/qasim157/observability-for-email-agents-4egn
Optional learning community: https://t.me/GyaanSetuAi