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

# Weave

[Weights & Biases (W\&B) Weave](https://weave-docs.wandb.ai/) は、LLM ベースのアプリケーションのトラッキング、実験、評価、デプロイ、改善を行うためのフレームワークです。柔軟性とスケーラビリティを重視して設計されており、LLM アプリケーション開発ワークフローのあらゆる段階をサポートします。

<Info>
  SambaNova と Weave の連携手順の詳細は、[Weave 連携リポジトリ](https://github.com/sambanova/integrations/tree/main/weave) に記載されています。
</Info>

## 前提条件

* [SambaCloud アカウント](https://cloud.sambanova.ai/?utm_source=weave\&utm_medium=external\&utm_campaign=cloud_signup)と API キー
* [Weights & Biases アカウント](https://wandb.ai/)と API キー
* Python 3.10 以上
* [Jupyter](https://jupyter.org/install) (サンプルノートブックの実行用)

## セットアップ

<Steps>
  <Step title="必要なパッケージのインストール">
    ```bash theme={}
    pip install weave langchain-sambanova litellm openai python-dotenv
    ```
  </Step>

  <Step title="API キーの設定">
    ```bash theme={}
    export SAMBANOVA_API_KEY="your-sambanova-key"
    export WANDB_API_KEY="your-wandb-key"
    export SAMBANOVA_URL="https://api.sambanova.ai/v1"
    ```

    <Note>
      `SAMBANOVA_URL` は、ノートブックの OpenAI SDK コネクターで必要です。設定しない場合、OpenAI クライアントは自身のデフォルトのエンドポイントにフォールバックし、SambaNova のキーが拒否されます。
    </Note>
  </Step>

  <Step title="サンプルノートブックのダウンロードと実行">
    [Weave@SambaNova ノートブック](https://github.com/sambanova/integrations/blob/main/weave/Weave%40SambaNova.ipynb) をダウンロードし、Jupyter で起動します。

    ```bash theme={}
    curl -L -o 'Weave@SambaNova.ipynb' \
      https://raw.githubusercontent.com/sambanova/integrations/main/weave/Weave%40SambaNova.ipynb
    jupyter notebook Weave@SambaNova.ipynb
    ```

    このノートブックでは、以下の 3 つのコネクターの使い方を紹介しています。

    * SambaNova LangChain チャットオブジェクト
    * LiteLLM
    * OpenAI SDK
  </Step>
</Steps>

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

<AccordionGroup>
  <Accordion title="SAMBANOVA_API_KEY が未設定、または認証エラー">
    * キーがエクスポートされていることを確認します: `echo "${SAMBANOVA_API_KEY:0:10}..."`
    * [SambaCloud ポータル](https://cloud.sambanova.ai/apis?utm_source=weave\&utm_medium=external\&utm_campaign=cloud_signup) でキーを再生成してください
    * 再度エクスポートし、ターミナルまたはノートブックのカーネルを再起動してください
  </Accordion>

  <Accordion title="WANDB_API_KEY が未設定、または W&B の認証エラー">
    * キーがエクスポートされていることを確認します: `echo "${WANDB_API_KEY:0:10}..."`
    * [W\&B の設定ページ](https://wandb.ai/settings) からキーを取得してください
    * 再度エクスポートし、ターミナルまたはノートブックのカーネルを再起動してください
  </Accordion>

  <Accordion title="Jupyter が見つからない">
    * Jupyter をインストールします: `pip install jupyter`
    * または `pip install jupyterlab && jupyter lab` でノートブックを実行してください
  </Accordion>
</AccordionGroup>