邮件智能体的可观测性
你无法实时观察邮件智能体的工作过程。
但只需一次 API 调用，你就能看到它昨天所做的一切。
基于邮件构建智能体可以让你获得内置的可观测性。大多数自主系统都需要额外的工具来进行追踪和日志记录。而邮件智能体则免费拥有这些功能，因为邮箱本身就是记录。
以下是如何利用邮件来监控你的智能体：
输入监控 每一条入站消息都会触发
message.created事件。这提供了重建对话所需的线程 ID。如果消息过大，请查找message.created.truncated触发器。这会提示你通过 ID 获取完整的正文。输出监控 平台会报告每一次发送。通过追踪以下三个触发器来查看你的投递健康状况： •
message.send_success: 接收方服务器接受了邮件。 •message.send_failed: 规则或策略拦截了出站邮件。 •message.bounce_detected: 远程服务器拒绝了邮件。
send_failed 计数上升是问题出现的第一个信号。这意味着规则或配额正在限制你的智能体。
状态监控 邮箱文件夹充当了状态机。 • 垃圾邮件文件夹：向你展示垃圾邮件过滤器拦截了哪些内容。 • 草稿文件夹：作为人机回环（human-in-the-loop）设计的审批队列。如果草稿在其中停留时间过长，说明你的审批流程停滞了。 • 已发送文件夹：提供完美的审计日志。日志不会与现实相悖，因为邮件本身就是现实。
治理监控 如果智能体漏掉了某条消息，请检查规则评估。你可以查询在 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