ADK

Agent Development Kit (ADK) は、Google が開発したモジュール式でモデルに依存しない AI エージェント構築用フレームワークです。ワークフロー、ツールの利用、マルチモーダル入出力、評価機能をサポートしており、柔軟でインタラクティブなエージェントの構築に最適です。

マルチモーダル入力

単一のエージェントワークフロー内で、テキストと合わせて画像を理解・処理できます。

ツールの利用

エージェントの reasoning ループの任意のステップで、外部ツールや API を呼び出せます。

ビジュアルからコードへ

ビジュアルモックアップから動作する Web ページを自動生成します。

モデル非依存

エージェントロジックを書き換えることなく、LLM プロバイダーを切り替えられます。

前提条件

SambaCloud アカウントと API キー
Python 3.9 以上 (python --version で確認できます)

セットアップ

仮想環境の作成と有効化

python -m venv .venv
source .venv/bin/activate

python -m venv .venv
.venv\Scripts\Activate.ps1

必要なライブラリのインストール

pip install google-adk   # Core SDK for building agents
pip install litellm      # Adapter to connect ADK with SambaCloud

litellm は、ADK と SambaCloud の OpenAI 互換 API を仲介するプロキシとして機能します。独自のプロバイダーコードを書く必要はありません。

SambaCloud API キーの設定

export SAMBANOVA_API_KEY=your-sambanova-api-key

API キーは決してソース管理にコミットしないでください。.env ファイルを使用する場合は、.gitignore に追加してください。

モデルの設定

ADK の LiteLlm ラッパーを使用して、エージェントの接続先を SambaCloud に設定します。LiteLLM は環境変数から SAMBANOVA_API_KEY を自動的に読み込みます。

from google.adk.agents import Agent
from google.adk.models.lite_llm import LiteLlm

agent = Agent(
    name="my_agent",
    model=LiteLlm(model="sambanova/Meta-Llama-3.3-70B-Instruct"),
    description="A helpful assistant powered by SambaCloud.",
    instruction="You are a helpful assistant.",
)

Meta-Llama-3.3-70B-Instruct は、SambaCloud モデルページに記載されている任意のモデル ID に置き換えられます。

使用例

ADK と SambaCloud の連携例として、マルチモーダルエージェントのサンプルをご覧ください。この例では以下の方法を確認できます。

画像の処理

ADK ワークフロー内で視覚入力を理解・分析できます。

外部ツールの利用

エージェントの reasoning ループの任意のステップで、API やサービスを呼び出せます。

モックアップから Web ページへ

ビジュアルデザインからシンプルで機能する Web ページを自動生成します。

トラブルシューティング

SAMBANOVA_API_KEY が見つからない、または認証エラーが発生する

現在のシェルで変数がエクスポートされていることを確認します。

echo $SAMBANOVA_API_KEY

空の場合は export SAMBANOVA_API_KEY="your-api-key" で再エクスポートしてください。SambaCloud ポータルで API キーが有効であることを確認してください。

litellm が SambaCloud に接続できない

有効化中の仮想環境に litellm がインストールされていることを確認します。

pip show litellm

インストールされていない場合は pip install litellm を実行してください。エージェントを実行する前に、仮想環境が有効化されていることを確認してください。

ADK のツール呼び出しが失敗する、または想定外の形式が返される

ADK は、ツールがシリアライズ可能な値を返すことを想定しています。ツール関数が、カスタムオブジェクトではなく文字列・辞書 (dict)・リストを返すことを確認してください。対応している戻り値の型については、ADK のツールドキュメントをご参照ください。

参考情報

ADK マルチモーダルサンプル

マルチモーダルエージェントの実行可能なソースコード。

ADK ドキュメント

エージェント、ツール、高度な機能に関する公式リファレンス。

次のステップ: マルチモーダルサンプルのデフォルトモデルを任意の SambaCloud 対応モデルに切り替え、独自のツールでエージェントを拡張してみましょう。

概要

開発者ツール

フレームワーク

インターフェースとローコード

データとインフラ

マルチモーダル

評価とモニタリング

マルチモーダル入力

ツールの利用

ビジュアルからコードへ

モデル非依存

前提条件

セットアップ

モデルの設定

使用例

画像の処理

外部ツールの利用

モックアップから Web ページへ

トラブルシューティング

参考情報

ADK マルチモーダルサンプル

ADK ドキュメント

マルチモーダル入力

ツールの利用

ビジュアルからコードへ

モデル非依存

​前提条件

​セットアップ

​モデルの設定

​使用例

画像の処理

外部ツールの利用

モックアップから Web ページへ

​トラブルシューティング

​参考情報

ADK マルチモーダルサンプル

ADK ドキュメント

前提条件

セットアップ

モデルの設定

使用例

トラブルシューティング

参考情報