adk-agent-builder

ADK エージェントビルダー

タスクに合ったリファレンスだけを読んでください。ツリー全体を読み込むとコンテキストを消費し、重要な部分が埋もれてしまいます。

以下の各 API は google-adk 2.6.2 で確認済みです。実行時にシンボルが見つからない場合は、近い名前を推測するのではなく、src/google/adk/ のソースを読んでください。

まずはこちら

タスク	リファレンス
最初のエージェント、環境、adk CLI	getting-started.md
正式なインポートパスの確認	import-paths.md
実行時エラーの主な原因となるルール	best-practices.md

構成要素

• tool-catalog.md — 関数ツール、MCP、OpenAPI、Google API ツールセット、組み込みツール、カスタムの BaseTool と BaseToolset。
• function-nodes.md — ノードとしての通常の関数：パラメーターの解決、ジェネレーター、node_input の型指定ルール。
• llm-agent-nodes.md — ワークフローノードとして使う LlmAgent：出力型、指示テンプレート、output_schema、自動ラップ動作。
• task-mode.md — スキーマで検証された入力と出力を使う mode='task' と mode='single_turn' の委譲。

グラフオーケストレーション

• routing-and-conditions.md — ルーティングされたエッジ、辞書によるルーティングマップ、デフォルトルート、自己ループ、リビジョンループ。
• parallel-and-fanout.md — ファンアウトエッジ、JoinNode によるファンイン、parallel_worker=True によるリスト処理。
• dynamic-nodes.md — ctx.run_node() を使った実行時のノードスケジューリングと命令型ワークフローの構築。
• human-in-the-loop.md — RequestInput、再開時の動作、再開可能なセッションと再生されるセッション。
• advanced-patterns.md — 入れ子のワークフロー、再試行、カスタム BaseNode サブクラス、グラフの検証ルール。
• multi-agent.md — チャット転送の階層構造と、Workflow に置き換えられた非推奨の SequentialAgent / LoopAgent / ParallelAgent シェル。

ランタイムと検証

• state-and-events.md — Context オブジェクト、Event フィールド、ノード間での状態の受け渡し。
• session-and-state.md — セッションサービス、アーティファクト、メモリ、状態キーのスコープ。
• callbacks-and-plugins.md — 6 つのエージェントコールバックとアプリレベルのプラグイン。
• testing.md — InMemoryRunner を使った pytest、モデルの偽装、ノード出力の検証。