ADK-Rust

ADK-Rust 公式ドキュメント

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

はじめに

コア

  • コア型 - 基本型：Content、Part、Agent トレイト、Tool トレイト、コンテキスト
  • Runner - エージェント実行ランタイムと設定
  • プラグイン - ツールやモデルのインターセプトおよびミドルウェア用のライフサイクルフック

モデル

エージェント

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

ネイティブなコーディングエージェント：サンドボックス化されたワークスペースでコードを読み取り・編集・実行し、自律的な目標達成モードと並列ウルトラレビュー・ワークフローを実現します。

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

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

音声・マルチモーダルエージェントの構築を解説する、初心者向けの専用ガイドです。アーキテクチャ、概念、実行可能な例を扱います。

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

ツール

エージェントクライアントプロトコル

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

セッションと状態

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

メモリ

セッションより長く存続する長期メモリ — セッション状態に対応する永続的な仕組みです。セマンティックストアとバイテンポラル知識グラフの両方を扱う、専用の初心者向けガイドです。

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

コールバックとイベント

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

アーティファクト

可観測性

デプロイメント

評価

管理対象エージェント

セキュリティ

  • アクセス制御 - ロールベースの権限と監査ログ
  • ガードレール - PII の編集、コンテンツフィルタリング、スキーマ検証
  • メモリ - エージェント向けの長期的な意味メモリ
  • 支払いとコマース - エージェント型コマースの利用過程、プロトコルのサポート、検証経路

コンプライアンス

  • Vertex のみのデプロイ - HIPAA およびデータレジデンシーのワークロードで Gemini Studio（generativelanguage.googleapis.com）のトラフィックが発生しないことを保証

Studio

  • 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 によって重複した例のターゲット名を拒否し、cargo check --workspace --examples によってワークスペースの例をコンパイルします。