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

# Google Workspace

本記事では、SambaNova のモデルを使って、Google ドキュメントと Google スプレッドシートに AI による文章作成・データ処理ツールを追加する方法を解説します。追加ソフトウェアは不要で、既存の Google Workspace からそのまま利用できます。文法修正、文章の書き換え、数式の生成、インテリジェントな質問応答を、ドキュメントやスプレッドシートを離れることなく追加できます。

## 前提条件

作業を始める前に、以下の環境を準備してください。

* 有効な API キーを取得済みの [SambaCloud](https://cloud.sambanova.ai/apis) アカウント。無料ティアでは、Meta-Llama-3.3-70B-Instruct などのモデルを利用できます。
* Google Workspace (Google ドキュメントおよび/または Google スプレッドシート) へのアクセス
* Google Workspace アカウントでスクリプト実行権限が有効になっていること。管理対象の Workspace プランをご利用の場合は、Apps Script の利用が許可されていることを管理者にご確認ください。

## セットアップ

<Steps>
  <Step title="Google Apps Script へのアクセス">
    Google ドキュメントまたは Google スプレッドシートを開き、**拡張機能 → Apps Script** に移動します。
  </Step>

  <Step title="連携スクリプトの追加">
    使用する Google アプリケーションに応じた JavaScript スクリプトを Apps Script エディタにコピーします。

    * Google ドキュメントの場合: [Google Docs スクリプト](https://github.com/sambanova/integrations/blob/main/google_integration/google_docs.js)を使用します
    * Google スプレッドシートの場合: [Google Sheets スクリプト](https://github.com/sambanova/integrations/blob/main/google_integration/google_sheets.js)を使用します
  </Step>

  <Step title="API キーの設定">
    スクリプト内の以下の行を見つけます。

    ```javascript theme={}
    api_key = 0
    ```

    `0` を SambaNova API キーに置き換えます。

    ```javascript theme={}
    api_key = "your_api_key_here"
    ```
  </Step>

  <Step title="モデルの更新">
    両スクリプトは現在 `Meta-Llama-3.1-405B-Instruct` をリクエストしていますが、このモデルは 2025年6月25日に SambaCloud から提供終了となりました。スクリプトが更新されるまでは、ご自身でこの行を変更しない限り、すべてのリクエストが失敗します。

    スクリプト内の以下の行を見つけます。

    ```javascript theme={}
    "model": "Meta-Llama-3.1-405B-Instruct",
    ```

    現在利用可能なモデルに置き換えます。

    ```javascript theme={}
    "model": "Meta-Llama-3.3-70B-Instruct",
    ```

    その他の選択肢については、[SambaCloud モデル](/docs/ja/models/sambacloud-models) をご参照ください。
  </Step>

  <Step title="保存と再読み込み">
    Apps Script エディタで **Save project** (フロッピーディスクアイコン) をクリックし、**Google ドキュメントまたはスプレッドシートを再読み込みします**。ページの再読み込み後、メニューバーに **SambaAI** メニューが表示されます。
  </Step>
</Steps>

## Google ドキュメントの機能

設定が完了すると、**SambaAI** メニューから AI によるテキスト編集ツールを利用できるようになります。

### 文法の修正

1. ドキュメント内の任意のテキストをハイライトします
2. **SambaAI → Clean Grammar** に移動します
3. 選択したテキストの文法上の問題が、その場で自動的に修正されます

### 文章の書き換え

1. 書き換えたいテキストをハイライトします
2. **SambaAI → Rephrase** に移動します
3. 簡潔かつプロフェッショナルに書き換えられた新しい段落が、選択箇所の下に追加されます

## Google スプレッドシートの機能<sup>1</sup>

本連携では、スプレッドシートで使用できる 2 つのカスタム関数を提供します。

1. `=SAMBA_AI_QUESTION()`

   一般的な AI クエリやテキスト分析にはこの関数を使用します。

   **ユースケースの例:**

   ```excel theme={}
   =SAMBA_AI_QUESTION("What is the RSVP of this person: yes, no, or maybe? she said "&A10)
   ```

   ```excel theme={}
   =SAMBA_AI_QUESTION("Which essay is more compelling? Prompt 1:"&A13&" Prompt 2:"&B13)
   ```

   ```excel theme={}
   =SAMBA_AI_QUESTION("Summarize the following customer feedback: "&B5)
   ```

2. `=SAMBA_AI_FORMULA()`

   Excel / スプレッドシートの具体的な数式をモデルに求める場合は、この関数を使用します。

   **ユースケースの例:**

   ```excel theme={}
   =SAMBA_AI_FORMULA("take B1 if A1 is true, but otherwise take C1, and add that result to D1")
   ```

   ```excel theme={}
   =SAMBA_AI_FORMULA("calculate the percentage change between last month's sales in C2 and this month's sales in C3")
   ```

   ```excel theme={}
   =SAMBA_AI_FORMULA("find the average of all values in column D that correspond to 'approved' status in column E")
   ```

## 主なメリット

SambaNova と Google Workspace を連携させることで、以下が可能になります。

* 即時の文法修正とプロフェッショナルな書き換えにより、文章の品質を向上
* 必要な処理を平易な言葉で記述するだけで、数式の作成を自動化
* スプレッドシート内で直接、自然言語クエリによるインテリジェントなデータ分析を実行
* アプリケーション間のコンテキスト切り替えを減らし、生産性を向上
* ドキュメントを離れることなく、Meta-Llama-3.3-70B-Instruct などの最先端モデルを活用

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

**SambaAI のすべての操作が失敗する、またはモデルエラーが返される。** スクリプトが、2025年6月25日に SambaCloud から提供終了となり SambaStack のみでの提供に移行した `Meta-Llama-3.1-405B-Instruct` をまだリクエストしています。セットアップのステップ 4 の手順に従って、`"model"` の行を現在利用可能な ID に設定してください。現在提供中のモデルは、次のコマンドでいつでも確認できます (API キーは不要です)。

```bash theme={}
curl https://api.sambanova.ai/v1/models
```

**`401` または認証エラーが発生する。** `api_key` の行が `0` のままになっているか、キーの引用符の付け方が正しくありません。`api_key = "your_api_key_here"` のように引用符で囲んだ文字列にする必要があります (引用符なしの値は不可)。

**SambaAI メニューがドキュメントやスプレッドシートに表示されない。** スクリプトを保存した後、ドキュメントを再読み込みしてください。それでも表示されない場合は、お使いの Workspace プランでスクリプトの実行がブロックされている可能性があります。Apps Script の利用が許可されていることを管理者にご確認ください。

**スプレッドシートでカスタム関数がエラーを返す。** `=SAMBA_AI_QUESTION()` と `=SAMBA_AI_FORMULA()` は Sheets 用スクリプトにのみ存在します。Docs 用スクリプトをスプレッドシートにコピーした場合、SambaAI メニューは定義されますが、これらの関数は定義されません。

## 参考情報

* [SambaCloud モデル](/docs/ja/models/sambacloud-models) – スクリプトに設定できるモデル ID の一覧
* [SambaCloud ドキュメント](https://docs.sambanova.ai/)
* [Google Apps Script ドキュメント](https://developers.google.com/apps-script)
* [連携ソースコード](https://github.com/sambanova/integrations/tree/main/google_integration)

***

<sup>1</sup> カスタム関数の実装アプローチは [SheetAI](https://www.sheetai.app/) を参考にしています。