最新Salesforceの「Agentforce」、IDC調査のAIエージェント基盤でリーダーに
速報AI・テクノロジー

AIエージェントの実行履歴を自動収集 AI Shiftが評価・改善向け基盤

CyberAgent Developers 公式発表掲載 2026/11/09読了 2分
AIエージェントの実行履歴を自動収集 AI Shiftが評価・改善向け基盤画像はイメージ(AI生成)

AI生成画像はイメージです。記事で紹介している製品・人物・場所を写したものではありません。

本ページはプロモーションを含みます

AI ShiftのFDEが、多様なAIエージェントの評価と改善に向けた実行履歴を自動収集するトレーシング基盤を構築しました。

  • LLM Gatewayでインフラレベルの計装を自動化し、SDKとSkillの併用で業務上の意味を持つデータを付与します。
  • 収集したデータはOpenTelemetry Collectorを経由し、Langfuseに集約して可視化や分析に活用します。

すぐにできること

  1. 自分のチームのLLM呼び出しがLLM Gateway経由かを確かめる
  2. Langfuseの画面で、LLM呼び出しが構造化されて見えるかを確かめる
手順と公式の窓口を見る

なるほど

LLM Gatewayだけでは取れないデータがある

公式ページで確かめた、知っておくと役立つこと

  • LLM Gatewayだけでは、検索・ツールなどのLLMの使用用途や、ユーザー・セッションのメタデータは収集できないと書かれています。
    出典・developers.cyberagent.co.jp
  • アプリ側がコンテキスト伝播をしないと、LLM Gatewayは毎回新しいトレースを作り、1回のLLM呼び出しごとに深さ1の独立したトレースが生成されると書かれています。
    出典・developers.cyberagent.co.jp
  • Agent Router(旧Envoy AI Gateway)は環境変数を指定するだけでOpenTelemetryのトレーシングを使えると書かれ、docker-compose.yamlの設定例があります。
    出典・developers.cyberagent.co.jp

要約版:専門用語を控えて説明しています

開発の背景と課題

AIエージェントを導入した後に「どのように動いたか」を評価して改善につなげようとしても、実行履歴を集める基盤が整っていないという課題がありました。 顧客の課題解決に集中すべきエンジニア(FDE)にとって、履歴を残すためのコード(計装)を毎回手動で入れるのは負担が大きく、優先度が下がりがちでした。

仕組みと工夫

今回構築した仕組みでは、LLM(大規模言語モデル)を呼び出すときに「LLM Gateway」を必ず使ってもらう形にしました。 これにより、インフラ側で入出力やモデル名、トークン数などのテレメトリーデータ(動作状況を示すデータ)を自動的に収集できます。

さらに、LLM Gatewayだけでは分からない業務上の意味付けを行うため、専用の「Tracing SDK」とAIエージェント用の「Skill」を開発しました。 コーディングAIに計装を任せることで、エンジニアの手間を減らしつつ、Langfuse(LLMエンジニアリングプラットフォーム)で分析しやすい高品質なデータを集められるようにしています。

AI ShiftのFDE(Forward Deployed Engineer)は、顧客の業務に深く入り込み、AIエージェントやアプリケーションを開発・導入しています。今回、AI Workerを導入する顧客向けの開発で、評価と改善に必要な実行履歴を集めるトレーシング基盤を構築しました。

LLMの呼び出し履歴を自動で集める

AIエージェントの導入後に品質を評価・改善するには、どのように動いたかを示す実行履歴が必要です。ただ、履歴を残すコードを組み込む「計装」は、その方法を都度判断する必要があり、エンジニアの負担になっていました。

CyberAgent Developersの発表の図(AIエージェントの実行履歴を自動収集 AI Shiftが評価・改善向け基盤)
画像:CyberAgent Developers(公式発表)

今回の基盤では、LLMを呼び出す際にLLM Gateway(Agent Router)を経由します。LLMの入出力、モデル名、トークン数などを記録し、システムの動作から送出されるテレメトリーデータを自動収集する仕組みです。計装するかどうかをFDEが判断しなくても、LLMの呼び出し履歴を収集できます。

一方、LLM Gatewayだけでは、アプリケーション内の処理のつながりを示す情報や、検索・ツールなどのLLMの使用用途、ユーザーやセッションのメタデータを収集できません。そのため、専用の「Tracing SDK」とAIエージェント用の「Skill」を開発し、業務上の意味を付ける手動計装も併用します。

収集したデータをLangfuseで確認

収集したテレメトリーデータは、OpenTelemetry Collectorに集約されます。その後、LLMの呼び出しに関連するデータのみが、LLMエンジニアリングプラットフォームのLangfuseに送信されます。

SDKを通じてメタデータやセッション識別子を付けることで、Langfuse上では、構造化されたLLMの呼び出し履歴とともに、ユーザーやセッション、呼び出しの目的を確認できます。SDKによる計装を入れ忘れた場合でも、LLM Gatewayには呼び出し履歴が記録されます。最低限のデータ分析や評価の要件定義に役立てられます。

コーディングAIに計装を任せて開発負荷を軽減

Tracing SDKによる計装のために用意されたSkillを使うと、コーディングAIに計装を任せることができます。これにより、実装の負担を減らせるとしています。

AI ShiftのFDEは、生成AIを活用して開発プロセスのほぼすべての作業を自動化しています。今回の基盤は、実行履歴の収集方法を標準化し、FDEが顧客の課題解決に集中できるようにすることも狙いです。

判断ガイド

SDKまで入れるか迷ったときの考え方

状況ごとのおすすめと理由です。どれを選ぶかは、ご自身の状況で決めてください。

LLM Gatewayだけで実行履歴を残すか?

状況
LLM呼び出しの最低限の記録だけで足りる
おすすめ
LLM Gatewayの経由で最低限の記録が残るので、まずはこれで足りるか確かめる
理由
LLM呼び出しはインフラレベルで自動記録され、計装の入れ忘れを防げると書かれています。ただし、ユーザーやセッション、検索・ツールなどの使用用途は記録されません。
出どころ
出典・developers.cyberagent.co.jp

Tracing SDKまで入れるか?

状況
ユーザーごとや業務の用途別に評価や分析をしたい
おすすめ
Tracing SDKで計装する価値を検討する
理由
SDKでメタデータやセッション識別子、LLMの使用用途を付与できると書かれています。計装はAIエージェント用のSkillを使ってコーディングAIに任せられるとされています。
出どころ
出典・developers.cyberagent.co.jp

不安Q&A

計装を忘れたら何が残る?

計装を入れ忘れたら、何も記録されない?

LLM呼び出しだけはLLM Gatewayで記録されるので、最低限の呼び出し履歴は残ると書かれています。ただし、業務上の意味付けやユーザー・セッションの情報は残りません。

出典・developers.cyberagent.co.jp

今できることLLM呼び出しがLLM Gateway経由になっているかを確かめ、経由していなければ経路を見直す。

SDKを組み込むのは開発者の負担が大きい?

計装のための AIエージェント用のSkillが用意されており、コーディングAIに計装を任せられると書かれています。実装負担を大きく下げられるとされています。

出典・developers.cyberagent.co.jp

今できることAIエージェント用のSkillを使い、コーディングAIに計装を任せられるか試してみる。

集めたデータはどこに送られる?

テレメトリーはOpenTelemetry Collectorに集約され、LLM呼び出しに関連するデータだけがLangfuseに送信されると書かれています。

出典・developers.cyberagent.co.jp

今できることLangfuseの画面で、LLM呼び出しが構造化されて見えるかを確かめる。

入力や出力の中身も記録されるのか?

LLM Gatewayで入出力・モデル名・トークン数などを記録すると書かれています。個人情報の扱いや保存期間については、ページでは発表されていません。

出典・developers.cyberagent.co.jp

今できること記録される入出力に個人情報が含まれないか、社内ルールに沿って確かめる。

CyberAgent Developersの発表を読む

背景

実行履歴の基盤が後回しになる理由

導入後に評価しようとしても、実行履歴を集める基盤が整っていないことが課題でした。FDEは顧客課題に集中すべきで、計装は緊急度が低く、入れ方の判断も都度必要なため優先順位が下がりがちだったと説明されています。

出典・developers.cyberagent.co.jp

すぐにできること

今日まず確かめたい二つのこと

  1. 1

    自分のチームのLLM呼び出しがLLM Gateway経由かを確かめる

    1. 1-1docker-compose.yamlのaigwサービスを開く
    2. 1-2environmentにOTEL_TRACES_EXPORTERがあるか見る
    3. 1-3OTEL_EXPORTER_OTLP_ENDPOINTの送り先を確認する
    4. 1-4AI_GATEWAY_TRACING_SEMCONVの値を確かめる
    公式ページを開く agent-router.org
  2. 2

    Langfuseの画面で、LLM呼び出しが構造化されて見えるかを確かめる

    1. 2-1Langfuseの画面を開く
    2. 2-2LLMの呼び出しが構造化されているか見る
    3. 2-3ユーザー・セッションの情報が付いているか見る
    公式ページを開く langfuse.com

公式窓口

設定例と公式サイトの場所

SMSやメールに書かれた連絡先ではなく、ここにある公式の窓口を使ってください。

Agent Router

ブログには docker-compose.yaml の設定例(OTEL_TRACES_EXPORTER、OTEL_EXPORTER_OTLP_ENDPOINT、AI_GATEWAY_TRACING_SEMCONV など)が載っています。

公式ページを開く(agent-router.org)

働く人への示唆

影響:大きい
  • コーディングAI用のSkillを組み合わせることで、計装にかかる開発負荷を大幅に下げることができます。

発表内容をもとにした一般的な情報です。導入や契約の判断は、公式情報を確かめたうえでご自身で行ってください。

よくある質問

Q. LLM Gatewayで自動収集できないデータにはどのようなものがありますか?
アプリケーション内の処理の繋がりを示すヘッダーや、検索・ツールなどのLLMの使用用途を表すデータ、ユーザーやセッションを表すメタデータやタグが該当します。

この記事をシェアする

出典と更新履歴

出典(公式)
CyberAgent Developers Blog「【LLMOps】FDEの開発を支えるトレーシング基盤の開発」
日時
公式発表 サイソク掲載
確認方法
公開前に、本文を出典と自動で照合しています(事実確認 90点/100点、70点未満は非公開)。制作と確認の方法
誤りの報告
お問い合わせから受け付けています。直した記事は訂正履歴に残します。

次に読む記事

AI生成同じ話題の記事一部提供Databricks、Claude向けOpenTelemetry連携をベータ公開Claude PlatformのOpenTelemetry連携がDatabricks MLflowで公開ベータ版として提供開始(11/4)続きを読む

NEWSLETTER

毎朝7時、昨日のAIニュースの要点を5本

前日に出た記事から大きな発表を選び、1本2行でまとめてメールで届けます。無料・いつでも解除できます。

確認メールのリンクを開いた時点で登録完了です。アドレスは配信にだけ使います(プライバシーポリシー)。 配信の内容

大きな速報を、通知ですぐに

主要企業の大きな発表だけ、1日4回まで。夜22時〜朝7時は鳴らしません。いつでも解除できます。

本記事は公式発表の文章をもとにAIが要約・解説して自動生成したものです。誤りが含まれる可能性があるため、正確な仕様・料金は公式発表をご確認ください。元記事を読む制作方法と事実確認の手順は編集方針をご覧ください。誤りのご指摘はお問い合わせから受け付けています。