Google 検索によるグラウンディングが利用できるようになりました。詳細

このページは Cloud Translation API によって翻訳されました。

Gemini で AI スライドレビュアーを作成する

このコードプロジェクトを使用して、Google Workspace スライド用のスライドレビューアドオンを作成、実行、カスタマイズします。プレゼンテーションを週に 1 回行う場合でも、年に 1 回行う場合でも、ほとんどの人はプレゼンテーションを成功させるために少しのサポートを必要としています。スライドに情報を詰め込みすぎている傾向がありますか？プレゼンテーションをビジュアルで区切るのを忘れたかもしれません。効果的なプレゼンテーションに関する組織のガイドラインがあるかもしれません。最近、それらを読みましたか？

Slides Advisor プロジェクトは、人工知能（AI）技術を使用して、必要に応じてプレゼンテーションを確認してフィードバックを提供できる、オープンソースの Google Workspace アドオンです。このプロジェクトでは、Google の Gemini API 画像処理機能とテキスト処理機能を使用して、一連のガイドラインに基づいて Google スライドを分析し、ガイドラインに対する進捗状況を確認できます。さらに、組織の推奨事項に沿ってガイドラインをカスタマイズしたり、自分で定義したルールに基づいてプレゼンテーションを改善するようリマインダーを設定したりすることもできます。

プロジェクトの概要と拡張方法の動画（作成者からの分析情報を含む）については、AI スライドレビューア - Google AI で構築するをご覧ください。それ以外の場合は、次の手順でプロジェクトの拡張を開始できます。

Google スライドのサイドバーとして実行されているスライドアドバイザーアドオン 図 1. サイドバーパ��ルとして実行されている Google スライド用 Slides Advisor アドオン。

プロジェクトの設定

以下の手順では、開発とテスト用にスライドアドバイザープロジェクトを設定する方法について説明します。一般的な手順は、Google Apps Script プロジェクトを作成し、API アクセス用の Google Cloud プロジェクトを設定し、プロジェクトの一部のシナリオプロパティを設定することです。

Apps Script プロジェクトを作成する

この Slides Advisor プロジェクトは、Google スライドのアドオンとして実行されます。Google スライドのウェブインターフェースを使用してプロジェクトを設定し、コードの Apps Script プロジェクトを作成します。

新しい Apps Script プロジェクトを作成するには:

Google Workspace のスライドウェブアプリに移動します。
既存のプレゼンテーションを開くか、新しいプレゼンテーションを作成します。
スライドプレゼンテーションで、[拡張機能] > [Apps Script] を選択します。

この手順を完了すると、Apps Script ウェブユーザーインターフェースに新しいタイトルなしのプロジェクトが作成され、開始したプレゼンテーションに関連付けられます。プロジェクトに名前を付けて、見つけやすくします。

Apps Script プロジェクトに名前を付けるには:

Apps Script ウェブインターフェースで、[Untitled project] テキストを選択します。
[プロジェクトの名前を変更] ダイアログで「My Slides Advisor」と入力し、[名前を変更] を選択します。

プロジェクトファイルを準備する

Slides Advisor プロジェクトには 5 つのコードファイルがあります。コードを新しい Apps Script プロジェクトにコピーする前に、これらのファイルを設定する必要があります。このセクションでは、プロジェクトを準備してコードを取得する方法について説明します。

プロジェクトファイルを準備するには:

My Slides Advisor プロジェクトを含む Apps Script ウェブインターフェースを開きます。
左側のメニューで [< > エディタ] ビューを選択します。
Code.gs コードファイル名にカーソルを合わせ、コンテキストメニューから [名前を変更] を選択し、main と入力して、Code.gs ファイルの名前を main.gs に変更します。インターフェースによって .gs 拡張子が自動的に追加されます。
左側のメニューで歯車アイコン（プロジェクトの設定）を選択し、[「appscript.json」マニフェストファイルをエディタで表示する] オプションを有効にして、プロジェクトの appscript.json マニフェストファイルを表示します。
Apps Script ウェブインターフェースの左側のメニューで、[< > エディタ] ビューを選択します。
[Files] ヘッダーの右側にある +（プラス）アイコンを選択し、[Script] を選択して ui と入力して、ui.gs コードファイルを作成します。
前の手順を繰り返して、slides.gs コードファイルと ai.gs コードファイルを作成します。

これで、Apps Script プロジェクトに次の 5 つのコードファイルが作成されます。ほとんどのファイルは空です。

appscript.json
main.gs
ui.gs
slides.gs
ai.gs

次のステップでは、リポジトリからプロジェクトコードを取得し、Apps Script プロジェクトにコピーします。

プロジェクトコードを取得する

Slides Advisor プロジェクトのコードは、コードリポジトリにホストされています。このコードを使用するには、そのコードを Apps Script プロジェクトにコピーする必要があります。このセクションでは、プロジェクトコードを取得する方法について説明します。

プロジェクトコードを取得するには:

プロジェクトマニフェストファイル appsscript.json のプロジェクトコードリポジトリに移動します。
このコードファイルの内容をクリップボードにコピーします。
Apps Script ウェブインターフェースに戻り、appsscript.json ファイル名を選択し、コードエディタパネルにコードを貼り付け、以前のコードに置き換えます。
他の 4 つのコードファイルに対しても、この手順を繰り返します。
- main.js コードを main.gs ファイルにコピーします。
- ui.js コードを ui.gs ファイルにコピーします。
- slides.js コードを slides.gs ファイルにコピーします。
- ai.js コードを ai.gs ファイルにコピーします。

Google Cloud プロジェクトを接続する

このプロジェクトでは、Google Cloud プロジェクトを使用して Gemini AI モデルにアクセスします。Google Cloud には、特定のデータプライバシーポリシーと、スライドアドバイザーなどのアプリケーションを構築するための便利なソフトウェアサービスが用意されています。アドオンコードを Gemini API に接続するには、AI API アクセス権を持つ Cloud プロジェクトを作成し、プロジェクトのサービスアカウントを作成し、サービスアカウントのキーを作成し、そのキーをアドオンプロジェクトにインストールします。

Cloud プロジェクトを構成する

Gemini API への接続に使用する Cloud プロジェクトで Vertex AI API サービスが有効になっていること、およびスライドアドバイザーアドオンからこのプロジェクトへの認証済み接続を作成する必要があります。Vertex AI API を使用するプロジェクトで課金が有効になっていることも必要です。

Vertex AI API アクセス権を持つ Cloud プロジェクトを構成するには:

Google Cloud コンソールに移動し、必要に応じてログインします。
Google Cloud コンソールで、既存の Cloud プロジェクトを選択するか、新規に作成します。
プロジェクトのコンソールの [ダッシュボード] ページの [API] パネルで、[API の概要に移動] を選択するか、https://console.cloud.google.com/apis/ に移動します。
[API とサービス] ページの上部にある [+ API とサービスの有効化] を選択します。
[API ��イ��リ] ページで vertex ai api を検索し、[Vertex AI API] オプションを選択して、[有効にする] ボタンを選択します。
まだ有効になっていない場合は、Google Cloud プロジェクトの課金を有効にしてから、Vertex AI API コンソールページで [有効にする] ボタンを選択して AI API を有効にする必要があります。
プロジェクトの API とサービスページに移動して、Vertex AI API が有効になっていることを確認します。このページに Vertex AI API が表示されます。

サービスアカウントを作成する

Slides Advisor アドオンは、Vertex AI API と Gemini モデルにアクセスするために、Cloud プロジェクトへの認証済み接続を必要とします。この接続を作成するには、まず、Vertex AI API にアクセスできるサービスアカウントを Cloud プロジェクトで生成します。Slides Advisor プロジェクトはこのサービスアカウントを使用して接続します。

Slides Advisor アドオンのサービスアカウントを作成するには:

Google Cloud コンソールで、Cloud プロジェクトの [API とサービス] ページに移動します。
ページの左側で [認証情報] を選択します。
ページの上部で、[+ 認証情報を作成] > [サービスアカウント] を選択します。
[サービスアカウントの作成] ページの [サービスアカウントの詳細] セクションで、サービスアカウント名、ID、説明を入力します。
[作成して続行] を選択して、サービスアカウントを作成します。
[このサービスアカウントにプロジェクトへのアクセスを許可する] セクションで、[ロール] コントロールを選択します。
[フィルタ] フィールドで検索し、[Vertex AI ユーザー] 権限セットを選択して、[続行] を選択します。
[完了] を選択して、このサービスアカウントの作成を完了します。

サービスアカウントの作成の詳細については、Google Cloud のサービスアカウントを作成するをご覧ください。

サービスアカウントキーを作成してインストールする

Slides Advisor プロジェクトは、前の手順で作成したサービスアカウントの認証を行う必要があります。この認証を有効にするには、サービスアカウントのキーを作成し、そのキーを Slides Advisor Apps スクリプトプロジェクトでスクリプトプロパティとして構成します。次の手順では、鍵を作成してプロジェクトで構成する方法について説明します。

サービスアカウントキーを作成して構成するには:

Google Cloud コンソールで、Cloud プロジェクトの [API とサービス] ページに移動します。
ページの左側で [認証情報] を選択します。
[サービスアカウント] セクションで、作成したサービスアカウントを見つけ、アカウントのメールアドレスまたは鉛筆アイコンを選択して編集します。
サービスアカウントの編集ウィンドウで、ページ上部にある [キー] タブタイトルを選択します。
[鍵] セクションで、[鍵を追加] > [新しい鍵を作成] を選択します。
[Create private key for...] ダイ��ログで [JSON]、[Create] の順に選択します。この手順では、projectid-hashcode.json という名前の鍵ファイルが作成され、コンピュータに自動的にダウンロードされます。
ダウンロードした projectid-hashcode.json ファイルを開き、内容をコピーします。
My Slides Advisor プロジェクトを含む Apps Script ウェブインターフェースを開き、左側のメニューで [設定] ビューを選択します。
[スクリプトプロパティ] セクションで、[スクリプトプロパティを編集] ボタン、[スクリプトプロパティを追加] ボタンの順に選択します。
新しい [プロパティ] フィールドに「SERVICE_ACCOUNT_KEY」と入力し、[値] フィールドに、ダウンロードした projectid-hashcode.json ファイルの内容をコピーします。
[スクリプトプロパティを保存] ボタンを選択して、新しいプロパティを保存します。

サービスアカウントキーの作成の詳細については、Google Cloud のサービスアカウントキーの作成と削除に関するドキュメントをご覧ください。

アドオンプロジェクトをテストする

スライドアドバイザーアイコンが付いた Google Workspace のスライドパネル Slides Advisor プロジェクトをテストするには、アドオンコードのテストデプロイを作成し、そのテストデプロイをインストールする必要があります。このテスト構成では、プロジェクトは Apps Script アドオンプロジェクトを開始した Google スライドプレゼンテーションでのみ使用でき、他のスライドプレゼンテーションでは使用できません。アドオンを広範囲にデプロイする方法について詳しくは、Google Workspace Apps Script のドキュメントのデプロイの作成と管理をご覧ください。

Apps Script プロジェクトコードをデプロイしてテストするには:

Apps Script ウェブインターフェースの上部で、[デプロイ] > [デプロイをテスト] を選択します。
[Test deployments] ダイアログで、[Select type] の横にある歯車アイコンと [Google Workspace Add-on] を選択します。
[アプリケーション: スライド] のタイトルの横にある [インストール] ボタンを選択します。
[最新のコードをテスト] のデフォルト設定のままにして、[完了] を選択します。
Apps Script プロジェクトに接続されている Google スライドプレゼンテーションに移動し、ウェブページを再読み込みします。
スライドウェブアプリの右下にある（<）アイコンを選択してサイドパネルを開き、白黒のアイコンを選択して [スライドアドバイザー] パネルを開きます。

この手順を完了してアドオンを正常に実行したら、別のガイドラインを使用するように、または別のワークフローに沿ってアドオンを変更できます。Slides Advisor アドオンに基本的な変更を加える手順については、次のセクションをご覧ください。

レビューの動作を変更する

プロジェクトコードを変更することで、Gemini API から取得する出力とアドオンが提供するユーザーインターフェースの両方について、スライドアドバイザーのレビュー動作を変更できます。このチュートリアルでは、プロンプトインストラクションを変更して、プレゼンテーションのスライド確認動作を変更することに焦点を当てます。Apps Script を使用して Google スライドのユーザーインターフェースを拡張する方法については、Google スライドを拡張するをご覧ください。

レビューガイドラインを変更する

スライドアドバイザーには、シンプルさ、色とタイポグラフィ、構造と空白、グラフィックとアイコンのカテゴリを含む、スライド審査ガイドラインの基本セットがプログラムされています。レビューガイドラインは、選択したスライドとスピーカーのメモのスナップショット画像とともに、Gemini API のプロンプトに含まれるテキストインストラクションにすぎません。

テキストインストラクションを変更することで、アドオンの審査動作を変更できます。たとえば、カテゴリヘッダーと同じ行にカテゴリ評価を含むレビューを出力するように Gemini モデルに指示したり、カテゴリの名前を変更したりできます。

カテゴリの評価場所とカテゴリ名を変更するには:

My Slides Advisor プロジェクトを含む Apps Script ウェブインターフェースを開きます。必要に応じて、プロジェクトウィンドウに移動します。そのためには、Apps Script プロジェクトを含む Google スライドプレゼンテーションを開き、[Extensions] > [Apps Script] を選択します。
左側のメニューで [< > エディタ] ビューを選択し、ai.gs ファイル名を選択します。

ai.gs コードファイルで、SYSTEM_PROMPT 文字列定数を見つけて、太字のテキストで次のように命令を変更します。

const SYSTEM_PROMPT = `
...
For each of the following categories evaluate the given slide. Score each
category on a scale of 0 to 100, show the score next to the category heading,
and concisely explain the reasoning. Do not suggest improvements if the score
is 80 or above.

同じ SYSTEM_PROMPT 文字列定数で、Simplicity カテゴリテキストを Message に変更します。
```
const SYSTEM_PROMPT = `
...
* Message -- Slides should focus on one main idea per slide and ...
```
変更を ai.gs コードファイルに保存します。
Apps Script プロジェクトに接続されている Google スライ�� プレゼンテーションに移動し、ウェブページを再読み込みして、アドオンを再実行して変更をテストします。

Slides Advisor アドオンのテスト用デプロイメントをまだ設定していない場合は、アドオンプロジェクトをテストするの手順に沿って設定します。

審査要件に合わせて、SYSTEM_PROMPT 文字列定数内の審査カテゴリの手順を削除、置換、書き換えることができます。別のレビュープロンプトアプローチを試したり、レビュープロンプト全体を書き換えたりしたい場合は、Google AI Studio ウェブアプリケーションをご覧ください。このアプリでは、便利なインターフェースで Gemini のプロトタイプ作成、テスト、保存を行うことができます。このアプリは、スライドアドバイザープロジェクトと同じ Gemini API を使用します。AI Studio の使用方法については、AI Studio のクイックスタートガイドをご覧ください。

モデルの動作の構成を変更する

Gemini API には、リクエストプロンプト��の応答としてモデルの一般的な動作を変更するための設定がいくつか用意されています。特に��デルの temperature 設定を使用すると、レスポンスでモデルに許可される変動の量を設定できます。0 が最も低く、1 が最も高くなります。この値を 0.1 に設定すると、非常に一貫したレスポンスが生成されますが、その動作は繰り返しのように見え、レビューフィードバックを受け取るユーザーにとってあまり役に立たない可能性があります。温度値を高く設定することを検討してください。温度が高いほど、結果の不整合が大きくなる可能性があります。たとえば、命令の異なる実装や、一部の命令の完全な無視などです。

レビューレスポンスの温度を上げるには:

My Slides Advisor プロジェクトを含む Apps Script ウェブインターフェースを開きます。
左側のメニューで [< > エディタ] ビューを選択し、ai.gs ファイル名を選択します。

ai.gs コードファイルで analyzeSlides() 関数を見つけ、temperature 値を 0.3 に設定して generationConfig 定数を変更します。

function analyzeSlides(slide) {

    const generationConfig = {
        temperature: 0.3,
        maxOutputTokens: 1024 * 2,
    };

変更を ai.gs コードファイルに保存します。
Apps Script プロジェクトに接続されている Google スライドプレゼンテーションに移動し、ウェブページを再読み込みして、アドオンを再実行して変更をテストします。

モデルの動作の構成設定の詳細については、GenerationConfig の Gemini API ドキュメントをご覧ください。

参考情報

Slides Advisor プロジェクトの詳細については、コードリポジトリをご覧ください。アプリケーションの構築についてサポートが必要な場合や、他のデベロッパーと連携したい場合は、Google Developers Community Discord サーバーをご確認ください。Google AI を活用して構築するプロジェクトについては、動画の再生リストをご覧ください。

Gemini で AI スライド レビュアーを作成する