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

# Linkup

[Linkup](https://www.linkup.so/) は、AI アプリケーション向けに設計された Web 検索エンジンです。グラウンディングデータを提供する API を通じて AI システムをインターネットに接続し、出力の内容を充実させ、精度・正確性・事実に基づく信頼性を向上させます。

## 前提条件

* [SambaCloud アカウント](https://cloud.sambanova.ai/?utm_source=linkup\&utm_medium=external\&utm_campaign=cloud_signup)
* [SambaNova API キー](https://cloud.sambanova.ai/apis?utm_source=linkup\&utm_medium=external\&utm_campaign=cloud_signup)
* [Linkup](https://www.linkup.so/) のアカウントと API キー
* Python 3.9 以上

## インストールとセットアップ

<Steps>
  <Step title="リポジトリのクローン">
    ```bash theme={}
    git clone https://github.com/sambanova/integrations.git
    cd integrations/linkup
    ```
  </Step>

  <Step title="仮想環境の作成">
    ```bash theme={}
    python -m venv .venv
    source .venv/bin/activate
    ```
  </Step>

  <Step title="依存パッケージのインストール">
    requirements ファイルからインストールします。

    ```bash theme={}
    pip install -r requirements.txt
    ```

    または、パッケージを直接インストールします。

    ```bash theme={}
    pip install linkup-sdk==0.9.0
    pip install sambanova==1.2.0
    ```

    <Note>
      これらのバージョンは固定してください。サンプルノートブックはこれらのバージョンでテスト済みで、
      最初のコードセルで同じバージョンに再固定するため、バージョンを固定せずにインストールしても、
      ノートブックの実行時に上書きされます。
    </Note>
  </Step>
</Steps>

## 環境変数の設定

プロジェクトディレクトリに `.env` ファイルを作成し、API キーを記述します。

```bash theme={}
LINKUP_API_KEY="your-linkup-api-key"
SAMBANOVA_API_KEY="your-sambanova-api-key"
```

または、直接エクスポートします。

```bash theme={}
export LINKUP_API_KEY="your-linkup-api-key"
export SAMBANOVA_API_KEY="your-sambanova-api-key"
```

<Note>
  サンプルノートブックは、API キーのセルで両方のキーをインラインで代入しており、ここで設定した値を
  上書きします。ノートブックを実行するには、そのセルのプレースホルダ値をご自身のキーに置き換えて
  ください。上記の `.env` と `export` の方法は、ノートブックの外でコードを応用する場合に適用されます。
</Note>

## サンプルの実行

GitHub の [Linkup 連携サンプル](https://github.com/sambanova/integrations/tree/main/linkup) にあるサンプルノートブックを開いて実行してください。

## 参考情報

Linkup の詳細については、[Linkup の公式ドキュメント](https://docs.linkup.so/pages/documentation/get-started/introduction) をご参照ください。

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

<AccordionGroup>
  <Accordion title="ModuleNotFoundError: No module named 'linkup'">
    ディストリビューション名は `linkup-sdk` ですが、インポートするモジュール名は `linkup` です。
    `pip install linkup-sdk==0.9.0` で SDK をインストールし、仮想環境が有効になっていることを確認してください。
  </Accordion>

  <Accordion title="認証エラーまたは 401 Unauthorized">
    `LINKUP_API_KEY` と `SAMBANOVA_API_KEY` の両方が正しく設定されているか確認してください。必要に応じて再エクスポートします。
  </Accordion>

  <Accordion title="接続エラーまたはタイムアウト">
    `api.linkup.so` と `api.sambanova.ai` へのネットワークアクセスを確認してください。ファイアウォールルールも確認します。
  </Accordion>
</AccordionGroup>