可观测性提供有关执行期间工作流的内部状态和行为的见解。 这包括帮助监视和调试工作流的日志记录、指标和跟踪功能。
除了标准 GenAI 遥测之外，Agent Framework 工作流还发出其他范围、日志和指标，以便更深入地了解工作流执行。 这些可观测性功能可帮助开发人员了解消息流、执行程序的性能以及可能发生的任何错误。
启用可观测性
通过在框架全局设置 ENABLE_OTEL=true 环境变量或在应用程序开头调用 setup_observability() ，可以启用全局可观测性。
# This is not required if you run `setup_observability()` in your code
ENABLE_OTEL=true
# Sensitive data (e.g., message content) will be included in logs and traces if this is set to true
ENABLE_SENSITIVE_DATA=true
from agent_framework.observability import setup_observability
setup_observability(enable_sensitive_data=True)
工作流跨度
| 跨度名称 | Description |
|---|---|
workflow.build |
对于每个工作流生成 |
workflow.run |
对于每个工作流的执行 |
message.send |
对于发送到执行程序的每个消息 |
executor.process |
对于处理消息的每个执行程序 |
edge_group.process |
对于处理消息的每个边缘组 |
跨度之间的链接
当执行程序向另一个执行程序发送消息时，message.send 跨度会作为 executor.process 跨度的子跨度创建。 但是，executor.process 目标执行程序的范围不会是 message.send 范围的子范围，因为执行不是嵌套的。 相反，executor.process 目标执行程序的跨度链接到 message.send 源执行程序的跨度。 这会通过工作流执行创建可跟踪路径。
例如：
后续步骤
- 了解如何在工作流中使用代理 生成智能工作流。
- 了解如何处理工作流中的请求和响应 。
- 了解如何管理 工作流中的状态。
- 了解如何创建检查点并从中恢复。