google-agents-cli-adk-code

ADK コードリファレンス

必須の開発フェーズとスキャフォールディング手順を確認するため、最初に /google-agents-cli-workflow を有効にしてください。

1. レシピを確認する（プロジェクト不要）

Python — 「Xをどう構築すればよいか」という質問に答える前に、references/samples.md のトピック索引を確認してください。 次の実装例があります：サンドボックス化されたユーザー別のコード実行、エージェントが読み込める SKILL.md スキル、セッションをまたいだメモリ、リスクのある操作の前の承認ゲート、ツールのガードレール、ユーザー別の 認証情報、スケジュール実行／イベント駆動実行。

Go — 上流の examples/ を確認してください。 リポジトリをクローンし、実装前に必要な機能に合った例を読んでください。

2. コードを書くための前提条件

プロジェクトがスキャフォールディングされるまで、エージェントコードを書かないでください。

1. プロジェクトを確認します：agents-cli info を実行します（設定が存在すれば続行します）。
2. 新規プロジェクト：agents-cli scaffold create <name> --agent adk --deployment-target <target> を実行します — Go では --agent adk_go を使用します。
3. 既存のコード：agents-cli scaffold enhance . を実行します。

クイックリファレンス — よく使われるパターン

Python と Go のコード例については、それぞれ references/adk-python.md と references/adk-go.md を参照してください。

---

リファレンス

よく使われるパターンにはチートシートを使用してください。詳しい情報が必要な場合は、ドキュメントの索引を取得するか、インストール済みのパッケージを調べてください。

リファレンス	言語	読むタイミング
references/samples.md	Python	トピック別に索引化された ADK リファレンスレシピのカタログです。 ワークフローのフェーズ 1 で、スキャフォールディング前、コードを書く前に読んでください。機能に対応する実装レシピを確認できます。
references/adk-python.md	Python	ADK のコア API：Agent、ツール、コールバック、プラグイン、状態、アーティファクト、マルチエージェントシステム、SequentialAgent／ParallelAgent／LoopAgent、カスタム BaseAgent、ManagedAgent（サーバーでホストされるファーストパーティエージェント）、A2A プロトコル、A2UI。ほとんどのエージェントでの標準です。
references/adk-python-workflows.md	Python	グラフベースのワークフロー API（ADK Python 2.0）：ノード、エッジ、ファンアウト／ファンイン、HITL、並列処理。明示的なグラフトポロジーが必要な場合に使用します。
references/adk-python-live.md	Python	ライブエージェントと音声エージェント：Runner.run_live、LiveRequestQueue、モデルとリージョンの利用可否、音声／speech_config、VAD、セッションの制限、/run_live のサービング。リアルタイムの音声または動画エージェントで使用します。
references/adk-go.md	Go	ADK Go のコア API：llmagent、ツール、コールバック、プラグイン、状態、アーティファクト、マルチエージェントシステム、逐次／並列／ループエージェント、カスタムエージェント、ランナー、HTTP 経由のサービング、A2A プロトコル、アンビエントトリガー。ほとんどのエージェントでの標準です。
references/adk-go-workflows.md	Go	グラフベースのワークフロー API：ノード、エッジ、ファンアウト／ファンイン、HITL、並列処理。明示的なグラフトポロジーが必要な場合に使用します。
examples/	Go	実行可能な上流プログラムです。Go 向けのレシピカタログに最も近いものです。
curl https://adk.dev/llms.txt	Python	ドキュメント索引（すべてのページタイトルと URL）。取得後、チートシートを超える情報については、該当するページを WebFetch で取得してください。
インストール済みの ADK パッケージ	Python	正確なシグネチャとシンボル — ソースを調べてください（references/adk-python.md の「ADK ソースコードの調査」を参照）。

関連スキル

• /google-agents-cli-workflow — 開発ワークフロー、コーディングガイドライン、運用ルール
• /google-agents-cli-scaffold — agents-cli scaffold create／scaffold enhance によるプロジェクトの作成と拡張
• /google-agents-cli-eval — 評価方法、データセットスキーマ、評価と修正のループ
• /google-agents-cli-deploy — デプロイ先、CI/CD パイプライン、本番ワークフロー