ADK-Rust

ADK-Rust 公式ドキュメント

ADK-Rust（Rust 向け Agent Development Kit）の公式ドキュメントへようこそ。このドキュメントでは、ADK フレームワークの Rust 実装を使って AI エージェントを構築するための包括的なガイドとリファレンスを提供します。

はじめに

コア

  • コア型 - 基本型: Content、Part、Agent trait、Tool trait、contexts
  • Runner - エージェント実行ランタイムと設定
  • プラグイン - ツール/モデル介入とミドルウェアのライフサイクルフック

モデル

エージェント

コーディングエージェント

サンドボックス化されたワークスペースでコードを読み、編集し、実行するネイティブなコーディングエージェント。自律的な目標モードと、並列の ultra-review ワークフローを備えています。

  • 概要 - まずはここから: 構成要素、インストール、60 秒のクイックスタート
  • 開発ツール - adk-devtools: read/write/edit/glob/grep/bash + サンドボックス化された Workspace
  • Harness - CodingAgent（coding 機能）、plan ループ、write_todos
  • CLI - adk-rust code / goal（永続的、再開可能）/ ultracode
  • ワークフロー - adk-graph 上の ultra-review: 並列レビュアー + fan-in
  • 例 - 実行可能な 3 つのサンプル crate

リアルタイム & マルチモーダル

音声 + マルチモーダルエージェントを構築するための、新規利用者向けの専用ガイド — アーキテクチャ、概念、実行可能な例を含みます。

  • 概要 - まずはここから: メンタルモデル、インストール、60 秒のクイックスタート
  • アーキテクチャ - 4 層、イベントループ、オーディオパイプライン、turn のライフサイクル
  • プロバイダー - OpenAI Realtime と Gemini Live のモデル、音声、選び方
  • ツール - サーバーサイドのアクション: ネイティブハンドラ、ブリッジされた adk_core::Tool、並列呼び出し
  • マルチモーダル - send_video_frame とブラウザカメラキャプチャによる動画入力
  • 感情対話 - Gemini のネイティブ音声での感情認識応答
  • メモリ - コンテキスト注入、turn 保存、知識グラフによる自己キュレーション
  • Web アプリの構築 - サーバーサイドブリッジ、WS プロトコル、Web Audio
  • 例 - 実行可能な 4 つの例と推奨学習パス

ツール

Agent Client Protocol

ADK-Rust から外部のコーディングエージェントを使用するか、安定した ACP v1 を通じて ADK-Rust エージェントをエディタに公開します。

セッション & 状態

  • セッション - セッション管理とライフサイクル
  • 状態管理 - プレフィックスを使った会話状態の管理

メモリ

セッションを超えて存続する長期メモリ — セッション状態の永続版。セマンティックストアと、二時相の知識グラフの両方を扱う、初心者向けの専用ガイド。

  • 概要 - ここから始める: 2種類のメモリ、メンタルモデル、インストール、クイックスタート
  • 概念 - MemoryEntry、MemoryService trait、検索、プロジェクトのスコープ、GDPR消去
  • バックエンド - 6つのストア（InMemory、SQLite、Postgres+pgvector、Redis、MongoDB、Neo4j）と選び方
  • ナレッジグラフ - GraphMemoryService: エンティティ、観測、関係、そして bi-temporal が重要な理由
  • ツールとエージェント - メモリをエージェントに組み込む；remember/relate とメモリツール

コールバックとイベント

  • コールバック - エージェントの動作をインターセプトしてカスタマイズする
  • イベント - イベントシステムと会話履歴を理解する

アーティファクト

可観測性

デプロイ

評価

管理対象エージェント

セキュリティ

  • アクセス制御 - ロールベースの権限と監査ログ
  • ガードレール - PII のマスキング、コンテンツフィルタリング、スキーマ検証
  • メモリ - エージェント向けの長期セマンティックメモリ
  • 支払いとコマース - エージェントコマースのジャーニー、プロトコル対応、検証パス

スタジオ

  • ADK Studio - エージェント構築のためのビジュアル開発環境
  • アクションノード - 自動化ワークフロー向けの非-LLM プログラムノード
  • トリガー - ワークフロー向けの Webhook、スケジュール、イベントトリガー

開発

検証ステータス

README と公式ドキュメント内の Cargo コマンドと依存関係のスニペットは、scripts/check-doc-examples.sh によって検証されています。CI は scripts/check-cargo-adk-templates.sh を使った cargo-adk スキャフォールドもチェックし、scripts/check-example-name-collisions.sh を使って重複する example ターゲット名を拒否し、cargo check --workspace --examples を使ってワークスペースの example をコンパイルします。