新しい Gemini API クックブックとコミュニティフォーラムをご覧ください。

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

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

このコードプロジェクトを使用して、Google Workspace スライドのスライド審査担当者アドオンを組み立て、実行、カスタマイズします。プレゼンテーションが週に 1 回でも年に 1 回でも、ほとんどの人はちょっとしたサポートでうまくやることができます。スライドに詰め込みすぎないかプレゼンテーションをビジュアルで分割し忘れたことはありませんか？効果的なプレゼンテーションを行うための一連のガイドラインが組織に用意されている場合もあります。最近読んだ？

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

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

Google スライドのサイドバーとしてスライドアドバイザーアドオンを実行 図 1.サイドバーパネルとして動作している Google スライド向けスライドアドバイザーアドオン。

プロジェクトの設定

ここでは、スライドアドバイザープロジェクトを開発およびテスト用に設定する手順について説明します。一般的な手順は、Google Apps Script プロジェクトの作成、API アクセス用の Google Cloud プロジェクトの設定、プロジェクトに対するいくつかの Script プロパティの設定です。

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

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

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

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

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

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

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

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

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

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

MySlide Advisor プロジェクトを含む Apps Script ウェブインターフェースを開きます。
左側のメニューで [< > エディタ] ビューを選択します。
Code.gs ファイルの名前を Code.gs に変更します。Code.gs のコードファイル名にカーソルを合わせ、コンテキストメニューから [Code.gs] を選択して「Code.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 プロジェクトにコピーします。

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

スライドアドバイザープロジェクトのコードは、コードリポジトリでホストされています。そのコードを 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 には、特定のデータプライバシーポリシーのほか、スライドアドバイザーなどのアプリケーションの構築に役立つ多数の便利なソフトウェアサービスが用意されています。AI API にアクセスできる Cloud プロジェクトを作成してプロジェクトのサービスアカウントを作成し、サービスアカウントのキーを作成して、そのキーをアドオンプロジェクトにインストールして、アドオンコードを Gemini API に接続します。

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 が表示されます。

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

スライドアドバイザーアドオンで Vertex AI API と Gemini モデルにアクセスするには、Cloud プロジェクトへの認証された接続が必要です。この接続を作成するには、まず、Vertex AI API へのアクセス権を持つ Cloud プロジェクトにサービスアカウントを生成します。スライドアドバイザープロジェクトは、このサービスアカウントを使用して接続します。

スライドアドバイザーアドオンのサービスアカウントを作成するには:

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

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

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

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

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

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

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

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

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

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

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

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

レビュー動作を変更する

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

変更審査のガイドライン

スライドアドバイザーには、スライドのレビューに関する基本的なガイドラインがプログラムされており、シンプルさ、色とタイポグラフィ、構造と空白、グラフィックとアイコンのカテゴリが含まれています。レビューガイドラインは、Gemini API によるプロンプトに含まれるテキスト形式の指示と、選択したスライドのスナップショット画像、スピーカーノートのみです。

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

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

MySlide Advisor プロジェクトを含む Apps Script ウェブインターフェースを開きます。必要に応じて、Apps Script プロジェクトを含む Google スライドのプレゼンテーションを開き、[拡張機能] > [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 スライドのプレゼンテーションを操作してウェブページを再読み込みし、アドオンを再実行して変更をテストします。

スライドアドバイザーアドオンのテストデプロイをまだ設定していない場合は、アドオンプロジェクトをテストするの手順に沿って操作します。

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

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

Gemini API には、リクエストプロンプトに応じてモデルの一般的なオペレーションを変更するための設定がいくつか用意されています。特に、モデルの temperature 設定により、モデルが許容するレスポンスの変動量を設定できます。0 は最小、1 は最大です。この値を 0.1 に設定するとレスポンスが非常に一貫していますが、その動作は反復的で、レビューのフィードバックを得るユーザーにとってあまり役に立たないように思えるかもしれません。温度の値を大きくすることを検討してください。温度を高くするほど、結果に一貫性がなくなる可能性があります。たとえば、命令の実装方法を変えたり、一部の命令を完全に無視したりすることさえあります。

クチコミへの返信の温度を上げるには:

MySlide 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 ドキュメントをご覧ください。

参考情報

スライドアドバイザープロジェクトの詳細については、コードリポジトリをご覧ください。アプリケーションの構築でサポートが必要な場合や、他のデベロッパーとコラボレーションしたい場合は、Google Developers コミュニティの Discord サーバーをご利用ください。Build with Google AI プロジェクトの詳細については、動画再生リストをご覧ください。