有興趣看看全新的 Gemini API 教戰手冊和我們的社群論壇。

本頁面由 Cloud Translation API 翻譯而成。

使用 Gemini 建構 AI 簡報審查人員

運用這個程式碼專案組合、執行及自訂 Google Workspace 簡報的投影片審查外掛程式外掛程式。無論要每週或一年分享一份簡報大部分人都只需要一點幫助難道不想在投影片中放太多內容嗎？也許是忘了整理簡報畫面，加入其他視覺效果呢？您甚至可能必須制定出貴機構的一套準則，才能有效製作簡報。您最近讀過這些內容嗎？

Slides Advisor 專案是開放原始碼的 Google Workspace 外掛程式，其採用人工智慧 (AI) 技術，可在您需要時審查簡報並提供意見回饋。這個專案會使用 Google Gemini API 的圖片和文字處理功能，根據一組準則分析您的 Google 簡報，並讓您瞭解自己的回應方式。更棒的是，您可以依據貴機構的建議自訂這些規範，或者提醒您，也可以根據自行定義的規則改善簡報。

如需專案簡介影片並瞭解如何延伸，包括建構開發人員的深入分析，請查看 AI 簡報審查者 - 使用 Google AI 建構。否則，您可以按照下列操作說明開始擴充專案。

Google 簡報顧問外掛程式做為 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 網頁使用者介面中應該會有一個新的「Untitled project」，這個專案會附加在一開始的簡報中。為專案命名，方便日後尋找。

為 Apps Script 專案命名：

在 Apps Script 網頁介面中，選取「Untitled project」文字。
在「Rename Project」對話方塊中輸入 My Slides Advisor，然後選取「Rename」。

準備專案檔案

簡報顧問專案有 5 個程式碼檔案，您需要先設定這些檔案，才能將程式碼複製到新的 Apps Script 專案。本節說明如何準備專案並取得程式碼。

如要準備專案檔案：

開啟含有「MySlide Advisor」專案的 Apps Script 網頁介面。
在左側選單中選取「< > 編輯器」檢視畫面。
將遊標懸停在「Code.gs」程式碼檔案名稱上，然後從內容選單中選取「Rename」，然後輸入 main，將 Code.gs 檔案重新命名為 main.gs。介面會自動加入 .gs 擴充功能。
如要顯示專案的 appscript.json 資訊清單檔案，請選取左側選單中的齒輪圖示 (「Project Settings」)，然後啟用「Show "appscript.json"資訊清單檔案」選項。
在 Apps Script 網頁介面的左側選單中，選取「<>> 編輯器」檢視畫面。
選取「Files」+標頭右側的「+」+ (加號) 圖示，接著選取「Script」+，然後輸入 +，即可建立 ui.gs 程式碼檔案。
重複上述步驟，建立 slides.gs 和 ai.gs 程式碼檔案。

您的 Apps Script 專案現在應含有下列 5 個大致空白的程式碼檔案：

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

下一個步驟中，請從存放區取得專案程式碼，並複製到 Apps Script 專案。

取得專案程式碼

簡報 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 提供特定的資料隱私權政策，並提供多種實用軟體服務，可用來建構簡報 Advisor 這類應用程式。您可以將外掛程式程式碼連結至 Gemini API，方法是建立具有 AI API 存取權的 Cloud 專案、為專案建立服務帳戶、為服務帳戶建立金鑰，然後在外掛程式專案中安裝該金鑰。

設定 Cloud 專案

您用來連結 Gemini API 的 Cloud 專案必須啟用 Vertex AI API 服務，您必須透過簡報顧問外掛程式與該專案建立經過驗證的連線。您必須在使用 Vertex AI API 的專案中啟用計費功能

如要設定具備 Vertex AI API 存取權的 Cloud 專案，請按照下列步驟操作：

前往 Google Cloud 控制台並視情況登入。
在 Google Cloud 控制台中，選取現有的 Cloud 專案，或建立新的專案。
在專案的「Dashboard」(資訊主頁) 頁面中，選取「APIs」(API 總覽) 面板中的「Go to APIs Overview」，或是前往 https://console.cloud.google.com/apis/。
在「APIs and Services」(API 和服務) 頁面，選取頁面頂端的「+ 啟用 API 和服務」。
在「API Library」(API 程式庫) 頁面中，搜尋 vertex ai api，選取「Vertex AI API」選項，然後點選「Enable」按鈕。
您必須為 Google Cloud 專案「啟用計費功能」，然後在「Vertex AI API」主控台頁面中選取「啟用」按鈕，才能啟用 AI API。
前往專案的「APIs & Services」(API 和服務) 頁面，確認 Vertex AI API 已啟用。現在這個頁面應該會顯示 Vertex AI API。

建立服務帳戶

簡報顧問外掛程式需要經過驗證的 Cloud 專案連線，才能存取 Vertex AI API 和 Gemini 模型。如要建立連線，請先在可存取 Vertex AI API 的 Cloud 專案中產生服務帳戶。Google 簡報顧問專案會透過這個服務帳戶進行連結。

如何為簡報顧問外掛程式建立服務帳戶：

在 Google Cloud 控制台中，前往 Cloud 專案的「API 和服務」頁面。
選取頁面左側的「憑證」。
依序選取頁面頂端的「+ 建立憑證」>「服務帳戶」。
在「Create service account」(建立服務帳戶) 頁面的「Service account details」(服務帳戶詳細資料) 區段，輸入服務帳戶名稱、ID 和說明。
選取「建立並繼續」來建立服務帳戶。
在「將專案存取權授予這個服務帳戶」區段中，選取「角色」控制項。
在「Filter」欄位搜尋中，選取「Vertex AI User」權限集，然後選取「Continue」。
選取「完成」即可建立這個服務帳戶。

如要進一步瞭解如何建立服務帳戶，請參閱 Google Cloud 的「建立服務帳戶」說明文件。

建立及安裝服務帳戶金鑰

Google 簡報顧問專案必須能夠驗證您在先前程序中建立的服務帳戶。如要啟用驗證，您可以為服務帳戶建立金鑰，然後在簡報顧問 Apps Script 專案中將金鑰設定為指令碼屬性。下列程序說明如何在專案中建立金鑰並設定金鑰。

如要建立並設定服務帳戶金鑰，請按照下列步驟操作：

在 Google Cloud 控制台中，前往 Cloud 專案的「API 和服務」頁面。
選取頁面左側的「憑證」。
在「Service Accounts」(服務帳戶) 區段中找到您建立的服務帳戶，然後選取帳戶電子郵件地址或鉛筆圖示來編輯帳戶。
在頁面頂端附近的服務帳戶編輯視窗中，選取「KEYS」分頁標籤標題。
在「金鑰」專區中，依序選取「新增金鑰」>「建立新的金鑰」。
在「Create private key for...」對話方塊中，依序選取「JSON」和「Create」。這個步驟會建立名稱為 projectid-hashcode.json 的金鑰檔案，並自動將該檔案下載至您的電腦。
開啟下載的 projectid-hashcode.json 檔案，然後複製內容。
開啟含有「MySlide Advisor」專案的 Apps Script 網頁介面，然後在左側選單中選取「Settings」檢視畫面。
在「指令碼屬性」部分中，依序選取「編輯指令碼屬性」按鈕和「新增指令碼屬性」按鈕。
在新的「Property」(屬性) 欄位中輸入 SERVICE_ACCOUNT_KEY，然後在「Value」(值) 欄位中，複製下載的 projectid-hashcode.json 檔案內容。
選取「儲存指令碼屬性」按鈕，即可儲存新屬性。

如要進一步瞭解如何建立服務帳戶金鑰，請參閱 Google Cloud 的「建立及刪除服務帳戶金鑰」說明文件。

測試外掛程式專案

Google Workspace 投影片面板和簡報顧問圖示如要測試簡報顧問專案，您必須建立外掛程式程式碼的測試部署作業，並安裝該測試部署作業。在這項測試設定中，專案僅適用在 Google 簡報中，也就是開始在專案中啟動 Apps Script Add 的簡報，且無其他簡報。如要進一步瞭解如何部署外掛程式，以便更廣泛使用，請參閱 Google Workspace Apps Script 說明文件的「建立及管理部署作業」主題。

如何部署及測試 Apps Script 專案程式碼：

在 Apps Script 網頁介面頂端，依序選取「Deploy」(部署) >「Test deployments」(測試部署作業)。
在「TestDeployment」對話方塊中，選取「Select type」旁的齒輪圖示和「Google Workspace 外掛程式」。
在「應用程式：簡報」標題旁邊，選取「安裝」按鈕。
保留「Test 最新程式碼」的預設設定，然後選取「完成」。
前往連結至 Apps Script 專案的 Google 簡報頁面，然後重新載入網頁。
選取 Google 簡報網頁應用程式右下角的 ( < ) 圖示開啟側邊面板，然後選取黑白眼睛圖示，即可開啟「Google 簡報顧問」面板。

完成這個步驟並成功執行外掛程式後，您可以開始修改外掛程式，使其使用其他規範或按照其他工作流程操作。請參閱下一節的操作說明，瞭解如何對簡報顧問外掛程式進行一些基本修改。

修改審查行為

您可以修改簡報顧問的專案程式碼，變更簡報顧問的審查行為，無論是從 Gemini API 取得的輸出結果，以及外掛程式提供的使用者介面，都沒問題。本教學課程著重於變更提示來修改簡報投影片回顧行為。如要進一步瞭解如何使用 Apps Script 擴充 Google 簡報使用者介面，請參閱「擴充 Google 簡報」。

變更評論規範

簡報顧問服務針對投影片審查指南編寫了一套基本的投影片審查指南，包括簡單、顏色與字體排版、結構和空白字元，以及圖像和圖示等類別。審查指南只是透過 Gemini API 的提示附上的文字說明，以及所選投影片的快照圖片和任何演講者備忘稿。

如要變更外掛程式的審查行為，請變更文字操作說明。舉例來說，您可以指示 Gemini 模型在類別標題的同一行輸出評論 (包括類別評分)，也可以變更類別名稱。

如何變更類別評分地點和類別名稱：

開啟含有「MySlide Advisor」專案的 Apps Script 網頁介面。如有需要，請開啟包含 Apps Script 專案的 Google 簡報檔案，然後依序選取「Extensions」>「Apps Script」，前往專案視窗。
在左側選單中，依序選取「< > Editor」檢視畫面，然後選取「ai.gs」檔案名稱。

在「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 的原型設計、測試及儲存提示，而且這項產品採用與 Google 簡報顧問專案相同的 Gemini API。如要進一步瞭解如何使用 AI Studio，請參閱 AI Studio 快速入門指南。

變更模型行為設定

Gemini API 提供多項設定，方便您變更模型一般作業，以回應要求提示。特別是，模型的「溫度」設定可讓您設定模型可在回應中接受的變化版本數量，其中 0 為最低值，1 代表最高。將這個值設為 0.1 能產生非常一致的回應，但這個行為似乎重複，也不太實用，有助於使用者取得評論意見回饋。請考慮調高溫度值。請注意，溫度越高，結果就越不一致，可能包括以不同的方式實作操作說明，甚至完全忽略部分指令。

如要提高評論回覆的溫度，請按照下列步驟操作：

開啟含有「MySlide Advisor」專案的 Apps Script 網頁介面。
在左側選單中，依序選取「< > Editor」檢視畫面，然後選取「ai.gs」檔案名稱。
在「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 Community Discord 伺服器。如要進一步瞭解 Build with Google AI 專案，請查看影片播放清單。