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

​
前提条件

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

​
セットアップ

1

Google Apps Script へのアクセス

Google ドキュメントまたは Google スプレッドシートを開き、拡張機能 → Apps Script に移動します。
2

連携スクリプトの追加

使用する Google アプリケーションに応じた JavaScript スクリプトを Apps Script エディタにコピーします。
3

API キーの設定

スクリプト内の以下の行を見つけます。
0 を SambaNova API キーに置き換えます。
4

モデルの更新

両スクリプトは現在 Meta-Llama-3.1-405B-Instruct をリクエストしていますが、このモデルは 2025年6月25日に SambaCloud から提供終了となりました。スクリプトが更新されるまでは、ご自身でこの行を変更しない限り、すべてのリクエストが失敗します。スクリプト内の以下の行を見つけます。
現在利用可能なモデルに置き換えます。
その他の選択肢については、SambaCloud モデル をご参照ください。
5

保存と再読み込み

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

​
Google ドキュメントの機能

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

​
文法の修正

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

​
文章の書き換え

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

​
Google スプレッドシートの機能1

本連携では、スプレッドシートで使用できる 2 つのカスタム関数を提供します。
  1. =SAMBA_AI_QUESTION() 一般的な AI クエリやテキスト分析にはこの関数を使用します。 ユースケースの例:
  2. =SAMBA_AI_FORMULA() Excel / スプレッドシートの具体的な数式をモデルに求める場合は、この関数を使用します。 ユースケースの例:

​
主なメリット

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 キーは不要です)。
401 または認証エラーが発生する。 api_key の行が 0 のままになっているか、キーの引用符の付け方が正しくありません。api_key = "your_api_key_here" のように引用符で囲んだ文字列にする必要があります (引用符なしの値は不可)。 SambaAI メニューがドキュメントやスプレッドシートに表示されない。 スクリプトを保存した後、ドキュメントを再読み込みしてください。それでも表示されない場合は、お使いの Workspace プランでスクリプトの実行がブロックされている可能性があります。Apps Script の利用が許可されていることを管理者にご確認ください。 スプレッドシートでカスタム関数がエラーを返す。 =SAMBA_AI_QUESTION() と =SAMBA_AI_FORMULA() は Sheets 用スクリプトにのみ存在します。Docs 用スクリプトをスプレッドシートにコピーした場合、SambaAI メニューは定義されますが、これらの関数は定義されません。

​
参考情報

1 カスタム関数の実装アプローチは SheetAI を参考にしています。