> ## 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.

# BlackBox AI

[BlackBox AI](https://www.blackbox.ai/) は、開発者やクリエイターがフルスタックアプリケーションや UI コンポーネントを構築するための AI エージェントです。迅速なプロトタイピングから本番環境レベルのソフトウェア開発まで支援します。

## 前提条件

* [SambaCloud](https://cloud.sambanova.ai/?utm_source=blackboxai\&utm_medium=external\&utm_campaign=cloud_signup) アカウントと [API キー](https://cloud.sambanova.ai/apis?utm_source=blackboxai\&utm_medium=external\&utm_campaign=cloud_signup)
* Visual Studio Code (VS Code) のインストール
* [BlackBox の VS Code 拡張機能](https://docs.blackbox.ai/features/vscode-agent/introduction) のインストール (パブリッシャー: `Blackboxapp.blackbox`)

## セットアップ

<Steps>
  <Step title="VS Code を起動して BlackBox AI を開く">
    VS Code を起動し、サイドバーから BlackBox AI 拡張機能を開きます。

    <Frame>
      <img alt="VS Code サイドバーの BlackBox パネル" src="https://mintcdn.com/sambanova-systems/-mr-ALl5jQULp02V/images/docs/integrations/blackboxai/blackboxai1.png?fit=max&auto=format&n=-mr-ALl5jQULp02V&q=85&s=2f5ba68b525f777bba06c2a2cdd32994" width="3503" height="1920" data-path="images/docs/integrations/blackboxai/blackboxai1.png" />
    </Frame>
  </Step>

  <Step title="ソースを API に切り替え">
    BlackBox パネルで、ソースを **API** に切り替えます。

    <Frame>
      <img alt="API ソース切り替えトグルのある BlackBox パネル" src="https://mintcdn.com/sambanova-systems/-mr-ALl5jQULp02V/images/docs/integrations/blackboxai/blackboxai2.png?fit=max&auto=format&n=-mr-ALl5jQULp02V&q=85&s=de587880e38f8cb1cdcced6265713724" width="782" height="318" data-path="images/docs/integrations/blackboxai/blackboxai2.png" />
    </Frame>
  </Step>

  <Step title="SambaCloud API の設定">
    BlackBox パネル上部の **⚙️ 歯車アイコン** をクリックして **Settings** を開き、以下を設定します。

    * **API Provider**: **OpenAI Compatible** を選択します
    * **API Key**: SambaCloud の API キーを入力します
    * **Base URL**: `https://api.sambanova.ai/v1`
    * **Model ID**: [SambaCloud モデルページ](/docs/ja/models/sambacloud-models) からモデルを選択します (例: `MiniMax-M2.7`)

    **Save** をクリックして確定します。

    <Frame>
      <img src="https://mintcdn.com/sambanova-systems/_J7Y9KNwc3jgkOZC/images/docs/integrations/blackboxai/blackboxai3-1.png?fit=max&auto=format&n=_J7Y9KNwc3jgkOZC&q=85&s=e006374176bd85b026e157b35d3c4d2e" alt="OpenAI Compatible API プロバイダーを設定した BlackBox の設定画面" width="774" height="1320" data-path="images/docs/integrations/blackboxai/blackboxai3-1.png" />
    </Frame>
  </Step>
</Steps>

モデル設定パネルでは、コンテキストウィンドウサイズ、最大トークン数、コストトラッキングなどの高度なパラメータも調整できます。

これで、SambaCloud のモデルによる BlackBox AI エージェントの利用準備が完了しました。一般的な GPU プロバイダーと比較して、最大 5 倍の高速推論を体験できます。ご不明点や問題がある場合は、[SambaNova のサポート窓口](https://sambanova.ai/support) までお問い合わせください。

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

<AccordionGroup>
  <Accordion title="API ソースの切り替えが表示されない">
    * BlackBox の VS Code 拡張機能が最新バージョンであることを確認してください
    * VS Code のリロードをお試しください: **Cmd/Ctrl + Shift + P → Reload Window**
  </Accordion>

  <Accordion title="認証エラー">
    * [SambaCloud ポータル](https://cloud.sambanova.ai/apis?utm_source=blackboxai\&utm_medium=external\&utm_campaign=cloud_signup) で API キーが正しく、有効であることを確認してください
    * **Base URL** が `https://api.sambanova.ai/v1` に設定されていることを確認してください
    * 認証情報を再入力し、もう一度 **Save** をクリックしてください
  </Accordion>

  <Accordion title="モデルが応答しない">
    * Model ID が [SambaCloud モデルページ](/docs/ja/models/sambacloud-models) の有効なモデルと一致していることを確認してください
    * SambaCloud アカウントが有効であることを確認してください
  </Accordion>
</AccordionGroup>