構成可能なプロジェクトテンプレート

cargo adk newは、以下の3つの選択肢から動作するRustプロジェクトを作成します。

テンプレートは、Agentまたはワークフローの形状を定義します。
アドオンは、セッション、MCP、テレメトリなどの機能を追加します。
エンタープライズパターンは、一般的な製品形状のために、テンプレートとレビュー済みのAdd-onグループを選択します。

インストールされているCLIが権威となります。カスタムテンプレートディレクトリは、組み込みレジストリを拡張または置き換えることができるためです。

cargo adk templates
cargo adk addons
cargo adk new --help

プロジェクトの作成

# One LLM agent
cargo adk new support-agent --template llm

# A tool-using agent with operating capabilities
cargo adk new support-agent \
  --template tools \
  --addon sessions \
  --addon telemetry \
  --addon guardrails

# Preview generated files without writing them
cargo adk new support-agent --template graph --dry-run

basicはllmのエイリアスとして残ります。新しいドキュメントや自動化では、明示的なllm名を使用してください。

組み込みテンプレート

組み込みレジストリには現在12個のテンプレートが含まれています。

テンプレート	作成するもの	選択するタイミング
`llm`	1つの会話型 `LlmAgent`	1つのAgentがリクエストを所有し、必要に応じてToolを呼び出すことができる
`tools`	LLM Agentと型付き `#[tool]` の例	最初の有用なマイルストーンは、目に見えるRust Toolの呼び出しです
`rag`	ベクトル検索の知識パスを持つエージェント	回答はプライベートなドキュメントまたは知識コレクションを使用する必要があります
`api`	HTTP API を介して公開されるエージェント	別のアプリケーションがネットワーク経由でエージェントを呼び出します
`openai`	LLM エージェントが OpenAI に設定されている	OpenAI が意図された開始プロバイダーです
`sequential`	固定された順序で実行される複数のエージェント	各ステージは前のステージの作業に依存します
`parallel`	集約された結果を持つ並行スペシャリスト	独立した作業を同時に実行できる
`loop`	条件が満たされるまで繰り返し実行	レビュー担当者、修正、または洗練サイクルには、境界のあるループが必要
`conditional`	エージェント間の意思決定に基づくルーティング	異なるリクエストには異なるスペシャリストまたはパスが必要
`graph`	チェックポイントを持つ分岐ワークフロー	作業は再開、分岐、結合、またはプロセス障害を乗り越える必要がある
`realtime`	双方向の音声およびビデオ処理	製品がライブ音声またはマルチモーダルな会話を必要とする
`custom`	`Agent` trait の手動実装	実行契約が組み込みエージェントでは表現できない

最初に実行形状を選択します。セッション、MCP、テレメトリー、またはその他の製品機能は、それらを使用してワークフローを決定するのではなく、後で追加します。

機能アドオン

機能を構成するために--addonを繰り返します。ジェネレーターは、それらの機能フラグ、インポート、初期化フラグメント、環境例、および生成されたファイルを安定した優先順位で解決します。

アドオン	追加される機能	一般的な使用理由
`telemetry`	OpenTelemetry トレース設定	モデル、エージェント、ツールの境界を越えてリクエストを追跡する
`auth`	API-key および JWT 認証スキャフォールディング	デプロイされたエージェントエンドポイントを保護する
`sessions`	Session状態サービスの設定	保存された状態を使用して会話またはワークフローを続行する
`memory`	セマンティックメモリとRAG統合	現在の会話を超えて関連する知識を取得する
`mcp`	MCP機能の配線とクライアントの開始点	別のプロセスまたはサービスが所有する機能を接続する
`guardrails`	入力と出力の検証フック	Agentの実行前後に製品ルールを適用する
`eval`	評価ハーネスの足場	リリース前に再現可能なケースに対して動作を測定する
`browser`	ブラウザ自動化の統合	承認されたエージェントがウェブインターフェースを操作できるようにする
`server`	Axum HTTP and A2A サーバー設定	リモート呼び出し元向けにエージェントを公開する

例:

cargo adk new order-agent \
  --template tools \
  --addon mcp \
  --addon sessions \
  --addon server \
  --addon auth \
  --addon telemetry

生成された機能コードは出発点です。リリース前に、プレースホルダーのエンドポイント、資格情報、ポリシー、インメモリサービスを、デプロイメントが所有する選択肢に置き換えてください。

構成されたエンタープライズパターン

パターンは、通常のテンプレートと同じ --template 名前空間に表示されます。個別の --pattern フラグはありません。

パターン	構成	製品の出発点
`multi-agent`	`sequential` + telemetry	可視化された多段階ワークフロー
`production`	`llm` + server + auth + sessions + telemetry	認証され、監視可能なエージェントサービス
`pipeline`	`sequential` + sessions + telemetry	ステートフルな処理パイプライン
`chatbot`	`llm` + sessions + memory + server	記憶力のある会話型 HTTP product
`a2a-server`	`llm` + server + sessions	独立してデプロイされた A2A agent

a2a は a2a-server のエイリアスのままです。

cargo adk new operations-agent --template production
cargo adk new research-team --template multi-agent --addon eval
cargo adk new public-specialist --template a2a-server --addon auth

プロバイダーとモデルの選択

テンプレートにはデフォルトのプロバイダーがありますが、CLI は実行形状を変更することなくそれをオーバーライドできます。

cargo adk new support-agent \
  --template tools \
  --provider openai \
  --model company-approved-model

CI で --non-interactive を使用すると、選択肢が不足している場合にプロンプトを開く代わりに失敗します。別のプログラムが生成結果を必要とする場合は --json-output を使用します。

カスタムテンプレート

組織が組み込みレジストリを超えた再利用可能な開始点を必要とする場合は、TOML マニフェストのディレクトリを渡します。

cargo adk new finance-agent \
  --template company-finance \
  --template-dir ./agent-templates

組み込みテンプレートと同じ名前のカスタムテンプレートは、その CLI 呼び出しでそれを置き換えます。マニフェストはバージョン管理下に置き、生成されたプロジェクトは CI でテストしてください。

name = "company-finance"
description = "Company finance agent with approved defaults"
provider = "openai"
features = ["minimal", "tools"]
imports = ["use std::sync::Arc;"]

生成されたプロジェクトの検証

cd support-agent
cargo adk build
cargo run

cargo adk build は、生成されたプロジェクトをデプロイせずにコンパイルし、検証します。生成されたソースをコミットし、有効な機能と環境要件を確認し、同じコマンドをCIゲートとして維持してください。

自動化を最新の状態に保つ

レジストリの内容はリリース間で変更される可能性があります。自動化されたプロジェクト生成をアップグレードする前に：

cargo adk templates
cargo adk addons
cargo adk new smoke-agent --template tools --addon mcp --dry-run

これにより、ビルド環境にインストールされている正確な cargo-adk バイナリに対して、名前と互換性が検証されます。