> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sambanova.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ADK

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

<CardGroup cols={2}>
  <Card title="マルチモーダル入力" icon="image" iconType="duotone">
    単一のエージェントワークフロー内で、テキストと合わせて画像を理解・処理できます。
  </Card>

  <Card title="ツールの利用" icon="wrench" iconType="duotone">
    エージェントの reasoning ループの任意のステップで、外部ツールや API を呼び出せます。
  </Card>

  <Card title="ビジュアルからコードへ" icon="code" iconType="duotone">
    ビジュアルモックアップから動作する Web ページを自動生成します。
  </Card>

  <Card title="モデル非依存" icon="plug" iconType="duotone">
    エージェントロジックを書き換えることなく、LLM プロバイダーを切り替えられます。
  </Card>
</CardGroup>

## 前提条件

* [SambaCloud](https://cloud.sambanova.ai/?utm_source=adk\&utm_medium=external\&utm_campaign=cloud_signup) アカウントと [API キー](https://cloud.sambanova.ai/apis?utm_source=adk\&utm_medium=external\&utm_campaign=cloud_signup)
* Python 3.9 以上 (`python --version` で確認できます)

## セットアップ

<Steps>
  <Step title="仮想環境の作成と有効化" icon="folder-plus">
    <CodeGroup>
      ```bash macOS / Linux theme={}
      python -m venv .venv
      source .venv/bin/activate
      ```

      ```powershell Windows theme={}
      python -m venv .venv
      .venv\Scripts\Activate.ps1
      ```
    </CodeGroup>
  </Step>

  <Step title="必要なライブラリのインストール" icon="cube">
    ```bash theme={}
    pip install google-adk   # Core SDK for building agents
    pip install litellm      # Adapter to connect ADK with SambaCloud
    ```

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

  <Step title="SambaCloud API キーの設定" icon="key">
    ```bash theme={}
    export SAMBANOVA_API_KEY=your-sambanova-api-key
    ```

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

## モデルの設定

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

```python theme={}
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 モデルページ](/docs/ja/models/sambacloud-models) に記載されている任意のモデル ID に置き換えられます。

## 使用例

ADK と SambaCloud の連携例として、[マルチモーダルエージェントのサンプル](https://github.com/sambanova/integrations/tree/main/adk) をご覧ください。

この例では以下の方法を確認できます。

<CardGroup cols={3}>
  <Card title="画像の処理" color="#ee5a3d" icon="image" iconType="duotone">
    ADK ワークフロー内で視覚入力を理解・分析できます。
  </Card>

  <Card title="外部ツールの利用" color="#ee5a3d" icon="wrench" iconType="duotone">
    エージェントの reasoning ループの任意のステップで、API やサービスを呼び出せます。
  </Card>

  <Card title="モックアップから Web ページへ" color="#ee5a3d" icon="window" iconType="duotone">
    ビジュアルデザインからシンプルで機能する Web ページを自動生成します。
  </Card>
</CardGroup>

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

<AccordionGroup>
  <Accordion title="SAMBANOVA_API_KEY が見つからない、または認証エラーが発生する">
    現在のシェルで変数がエクスポートされていることを確認します。

    ```bash theme={}
    echo $SAMBANOVA_API_KEY
    ```

    空の場合は `export SAMBANOVA_API_KEY="your-api-key"` で再エクスポートしてください。[SambaCloud ポータル](https://cloud.sambanova.ai/apis?utm_source=adk\&utm_medium=external\&utm_campaign=cloud_signup) で API キーが有効であることを確認してください。
  </Accordion>

  <Accordion title="litellm が SambaCloud に接続できない">
    有効化中の仮想環境に `litellm` がインストールされていることを確認します。

    ```bash theme={}
    pip show litellm
    ```

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

  <Accordion title="ADK のツール呼び出しが失敗する、または想定外の形式が返される">
    ADK は、ツールがシリアライズ可能な値を返すことを想定しています。ツール関数が、カスタムオブジェクトではなく文字列・辞書 (dict)・リストを返すことを確認してください。対応している戻り値の型については、[ADK のツールドキュメント](https://google.github.io/adk-docs/agents/) をご参照ください。
  </Accordion>
</AccordionGroup>

## 参考情報

<CardGroup cols={2}>
  <Card title="ADK マルチモーダルサンプル" icon="github" href="https://github.com/sambanova/integrations/tree/main/adk">
    マルチモーダルエージェントの実行可能なソースコード。
  </Card>

  <Card title="ADK ドキュメント" icon="book-open" href="https://google.github.io/adk-docs/agents/">
    エージェント、ツール、高度な機能に関する公式リファレンス。
  </Card>
</CardGroup>

<Tip>
  **次のステップ:** マルチモーダルサンプルのデフォルトモデルを任意の [SambaCloud 対応モデル](/docs/ja/models/sambacloud-models) に切り替え、独自のツールでエージェントを拡張してみましょう。
</Tip>