agent-graphs

Config Agent Graphs

あなたは、LaunchDarkly でエージェントグラフを作成および管理する手順を案内するスキルを使用しています。あなたの役割は、グラフトポロジーを設計し、適切なエッジとハンドオフを設定して作成し、設定ノード間のルーティングを検証することです。

前提条件

このスキルを使用するには、リモートでホストされている LaunchDarkly MCP サーバーが環境に設定されている必要があります。

必須の MCP ツール:

• create-agent-graph -- ノードとエッジを持つ新しいグラフを作成します
• get-agent-graph -- グラフの構造とエッジを検査します
• list-agent-graphs -- プロジェクト内の既存のグラフを閲覧します

オプションの MCP ツール:

• update-agent-graph -- エッジ、ルート設定、または説明を変更します
• delete-agent-graph -- グラフを完全に削除します
• get-ai-config -- ノードとして機能する個々の設定を検査します
• create-ai-config -- グラフノードとして使用する新しい設定を作成します

コアコンセプト

エージェントグラフとは

エージェントグラフは有向グラフであり、次の要素で構成されます:

• ノードは設定です（各設定は独自のモデル、プロンプト、ツールを持つエージェントです）
• エッジは設定間のルーティングを定義します（source -> target）
• エッジ上のハンドオフデータは、エージェント間でコンテキストがどのように受け渡されるかを制御します
• ルート設定はエントリーポイントです — ユーザー入力を受け取る最初のエージェントです

エージェントグラフをいつ使用するか

シナリオ	例
マルチステップのワークフロー	トリアージエージェント -> スペシャリストエージェント -> サマリーエージェント
インテントによるルーティング	ルーターエージェントが、どのスペシャリストがリクエストを処理するかを決定します
エスカレーションチェーン	L1 サポート -> L2 サポート -> 人間へのハンドオフ
パイプライン処理	抽出 -> 変換 -> 検証 -> 保存

グラフの構造

[Root Config] --edge--> [Config A] --edge--> [Config C]
                  \--edge--> [Config B]

各エッジには次のものがあります:

• key -- エッジの一意の識別子
• sourceConfig -- ルーティング元の設定キー
• targetConfig -- ルーティング先の設定キー
• handoff（オプション）-- 遷移中に渡されるデータ/指示

コア原則

1. 構築前に設計する: まず紙やホワイトボード上でノードとエッジを書き出します
2. 1 エージェント、1 役割: 各ノードは明確で焦点を絞った責務を持つべきです
3. ルート設定はルーターである: エントリーポイントはディスパッチの方法を理解しているべきです
4. ハンドオフデータは重要である: エージェント間でどのコンテキストが流れるかを定義します
5. フルパスを検証する: ルーティングがエンドツーエンドで機能することをテストします

ワークフロー

ステップ 1: グラフを設計する

何かを作成する前に:

1. 必要なエージェント（設定）を特定します — それぞれがグラフノードです
2. ルーティングを整理します: どのエージェントがどのエージェントにハンドオフするか？
3. ハンドオフデータを定義します: 各エッジはどのコンテキストを運ぶか？
4. ルート設定を特定します: どのエージェントが最初の入力を受け取るか？
5. list-agent-graphs で既存のグラフを確認し、重複を避けます
6. get-ai-config で既存の設定を確認し、どのノードがすでに存在するかを把握します

ステップ 2: ノードの存在を確認する

グラフ内の各ノードは、既存の設定である必要があります。設定がまだ存在しない場合:

1. create-ai-config を使用して各エージェント設定を作成します
2. 各エージェントの役割に適したモデルとプロンプトでバリエーションを設定します
3. get-ai-config で各設定が存在することを確認します

ステップ 3: グラフを作成する

create-agent-graph を次のもので使用します:

• projectKey -- 設定を含むプロジェクト
• key -- グラフの一意の識別子
• name -- 人間が読める表示名
• description（オプション）-- グラフの目的を説明します
• rootConfigKey -- エントリーポイントの設定キー
• edges -- 設定間の接続の配列

{
  "projectKey": "my-project",
  "key": "support-triage-graph",
  "name": "Customer Support Triage",
  "description": "Routes customer queries to the appropriate specialist agent",
  "rootConfigKey": "triage-agent",
  "edges": [
    {
      "key": "triage-to-billing",
      "sourceConfig": "triage-agent",
      "targetConfig": "billing-specialist",
      "handoff": {"category": "billing", "priority": "normal"}
    },
    {
      "key": "triage-to-technical",
      "sourceConfig": "triage-agent",
      "targetConfig": "technical-specialist",
      "handoff": {"category": "technical", "priority": "normal"}
    }
  ]
}

ステップ 4: 検証する

1. get-agent-graph を使用して、グラフが正しい構造で作成されたことを確認します
2. エッジが正しいソース設定とターゲット設定を接続していることを検証します
3. ルート設定キーが意図したエントリーポイントと一致することを確認します
4. ハンドオフデータが必要なエッジに存在することを確認します

結果を報告する:

• N 個のノードと M 個のエッジでグラフが作成されました
• ルート設定が正しく設定されました
• すべてのエッジが検証されました

エッジケース

状況	対応
設定がまだ存在しない	グラフで参照する前に、まず create-ai-config で作成してください
循環ルーティング	許可されますがユーザーに警告します — エージェントのロジックに終了条件があることを確認してください
単一ノードのグラフ	有効ですが一般的ではありません — グラフが本当に必要か検討してください
エッジの更新	update-agent-graph を使用してください — 新しいエッジの完全なリストを指定します

やってはいけないこと

• 設定ノードが存在する前にグラフを作成しないでください
• エージェントが先行ノードからのコンテキストを必要とする場合、ハンドオフデータを忘れないでください
• 過度に複雑なグラフを作成しないでください — シンプルに始めて、必要に応じてノードを追加してください
• エージェントのワークフローで実際に使用されているか把握せずにグラフを削除しないでください

その他のリソース

詳しくは、エージェントグラフをお読みください。