エージェント初出 8/23 08:18
OTelの移行フラグ1つでAgent Framework 1.15.0の会話本文が消えた
https://zenn.dev/topics/ai/feed2026/8/23
AI要約
Microsoft Agent Framework 1.15.0へのアップデートで、OpenTelemetryのGenAIセマンティック規約関連の変更により会話本文が消失した問題について報告。規約のバージョン選択が意図しない挙動を引き起こした事例を紹介する。
AI要点
- Agent Framework 1.15.0へのアップデートで、OpenTelemetryのGenAIセマンティック規約変更により会話本文がSPANから削除される。
- OTEL_SEMCONV_STABILITY_OPT_IN環境変数の設定値によっては、 gen_ai.input.messages / gen_ai.output.messages がSPANから出力されなくなる。
- ENABLE_SENSITIVE_DATA=true の場合、会話本文はSPAN属性とログイベントの両方に二重記録される可能性があり、1.14.0ではログイベントは発生しなかった。
- OTEL_SEMCONV_STABILITY_OPT_INは規約破壊的変更時の逃げ道であり、GenAI以外でもHTTP、DB等で共通利用される。
- GenAIの規約はv1.37.0で警告があり、v1.42.0で別リポジトリへ移転されたが、Agent Framework 1.15.0 はこの変更を取り込んだ。
なぜ重要か
OpenTelemetryの規約変更は、AIアプリケーションにおける会話履歴の記録方法に影響を与え、デバッグや分析に必要な情報の取得可否を左右する。環境変数設定による挙動変化の理解は、テレメトリデータの正確な収集と、機密データの適切な管理のために不可欠となる。