マルチエージェントシステムに計測機能を実装する
マルチエージェントシステムでは、親エージェントは作業を子エージェントに委任します。 AI SDKを使用して親から子エージェントを作成すると、エージェント分析が委任を記録します。子エージェントは[Agent] Parent Agent IDを引き継ぎ、セッションにはルートエージェントとチェーンの深さが記録され、プロバイダーのラッパーは委任された呼び出し内で生じる不要なユーザーメッセージイベントを抑制します。自身でソースを設定している場合を除き、AI SDKによって委任されたユーザーメッセージの[Agent] Message Sourceがagentに設定されます。すべてのエージェントのイベントは、1つの[Agent] Session IDの下に保持されます。
すべてのエージェントに、安定した人間が判読できるIDを割り当てます。これらのIDは、システム全体で品質とコストを比較するための主要なディメンションになります。
子エージェントの宣言とディスパッチ
親エージェントを起点に.child()で子を宣言し、runAs()(Node)またはarun_as()(Python)を使用してそれらに処理を振り分けます。
const orchestrator = ai.agent('shopping-agent', { description: 'Orchestrates shopping requests' });
const recipeAgent = orchestrator.child('recipe-agent', { description: 'Finds recipes' });
await orchestrator.session({ userId }).run(async (s) => {
s.trackUserMessage(userInput);
const result = await s.runAs(recipeAgent, async (cs) => {
cs.trackUserMessage(delegatedQuery);
return openai.chat.completions.create({ model: 'gpt-4o', messages: [...] });
});
});
子エージェントは親のexperimentsを継承します。子エージェントはキーを使用してエントリを追加または上書きできます。runAs()およびarun_as()からのイベントにも、セッションの実験が含まれます。エージェント分析に実験バリアントを記録するを参照してください。
委任のセマンティクス(コンテキスト継承、スパンのラッピング、ネストされた子設定、ファンアウト)の詳細については、SDKリファレンスのマルチエージェントアーキテクチャを参照してください。
マルチエージェントセッションを分析する
各[Agent] Session Recordには[Agent] Root Agent Nameと[Agent] Agent Chain Depthが含まれます。Depthは、最も長い委任パス上のエージェントの数です。1は単一のエージェント、2は1ホップ、3以上はディープネストです。 親が複数の子にファンアウトする場合、depthは最も深いブランチに従います。チェーン深さが1より大きいセッションレコードをフィルタリングして、マルチエージェントのセッションを検索します。 Depth 2は、正確に1ホップを意味します。任意のチャートを[Agent] Agent IDでグループ化して、エージェントを比較します。データ階層を参照してください。
スパンの親スパンは、親エージェントではありません。OpenTelemetryで、スパン属性amplitude.parent.agent.idを設定します。プロセスをまたぐ場合は、既存のエージェントIDヘッダーと並べてx-amplitude-parent-agent-idを伝播させてください。LangSmithフォワーダーは、設定済みの1つのエージェントをスタンプします。ネストされたLangSmithの実行はツール呼び出しまたはスパンのままであり、子エージェントにはなりません。
これは役に立ちましたか?
For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.