“依托 Google 搜索进行接地”功能现已推出！了解详情

此页面由 Cloud Translation API 翻译。

使用 Gemini 构建 AI 幻灯片审核工具

为 Google Workspace 组建、运行和自定义幻灯片审核工具插件包含此代码项目的幻灯片。您是否每周进行一次演示或一年或一年，我们大多数人都需要一点帮助才能解决问题。您是否倾向于在幻灯片中放入过多内容？您可能忘了拆分演示文稿视觉元素？您甚至可能为自己的组织制定了制作出有效的演示文稿。你最近读过这些书吗？

幻灯片顾问是一个开源 Google Workspace 插件，智能 (AI) 技术审核演示文稿并提供反馈，。项目使用 Google 的 Gemini API 图片和文本处理功能来根据一系列准则分析您的 Google 幻灯片并让您了解自己在遵守这些指南方面表现如何。更棒的是，可以自定义这些准则，以遵循贵组织的建议；或者它会根据您定义的规则，提醒您改进演示文稿。。

通过视频简要了解项目以及如何扩展项目（包括数据洞见）请观看 AI 幻灯片审核员 - 使用 Google 构建 AI 技术。否则，您可以开始延长项目及其依赖项。

作为 Google 幻灯片的边栏运行的幻灯片顾问插件 图 1. 作为侧边栏面板运行的 Google 幻灯片幻灯片顾问插件。

项目设置

以下说明会引导您完成 Google 幻灯片顾问项目设置进行开发和测试常规步骤是创建 Google Apps 脚本项目、设置 Google Cloud 项目以进行 API 访问，以及设置项目的一些脚本属性

创建 Apps 脚本项目

此幻灯片顾问项目作为插件适用于 Google 幻灯片。使用 Google 幻灯片网页界面设置项目；为代码创建 Apps 脚本项目。

如需创建新的 Apps 脚本项目，请执行以下操作：

前往适用于 Google 的幻灯片 Web 应用 Workspace。
打开现有演示文稿，或新建一个演示文稿。
在幻灯片演示文稿中，选择扩展程序 >Apps 脚本。

完成这些步骤后，您应该可以在 Google Cloud 控制台中创建一个新的 Untitled project Apps 脚本网页界面（已附加到演示文稿中）就是从这里开始的为项目命名以便于查找。

要为 Apps 脚本项目命名，请执行以下操作：

在 Apps 脚本网页界面中，选择 Untitled project 文本。
在“重命名项目”对话框中，输入 My Slides Advisor，然后选择重命名。

准备项目文件

该幻灯片顾问项目有 5 个代码文件，您需要设置这些文件，然后才能将代码复制到新的 Apps 脚本项目中。此部分介绍了如何准备项目并获取代码。

如需准备项目文件，请执行以下操作：

打开包含 My 幻灯片顾问的 Apps 脚本网页界面项目。
在左侧菜单中，选择 <>Editor 视图中的结果。
将 Code.gs 文件重命名为 main.gs，方法是将鼠标悬停在 Code.gs 代码文件名，然后从上下文菜单中选择 重命名；输入 main。界面会自动添加 .gs 扩展名。
选择appscript.json 左侧菜单上的齿轮图标（项目设置），然后启用 Show "appscript.json"清单文件选项。
在 Apps 脚本网页界面的左侧菜单中，选择 < >Editor 视图中的结果。
选择右侧的 +（加号）图标，创建 ui.gs 代码文件（位于文件标题中），选择脚本并输入 ui。
重复上一步，创建 slides.gs 和 ai.gs 代码文件。

现在，您的 Apps 脚本项目应包含以下 5 个代码文件，大部分内容为空：

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

在下一步中，从代码库中获取项目代码并将其复制到 Apps 脚本项目。

获取项目代码

幻灯片 Advisor 项目的代码托管在代码库中。您需要将该代码复制到您的 Apps 脚本项目中才能使用它。这个部分介绍了如何获取项目代码。

如需获取项目代码，请执行以下操作：

前往项目清单文件的项目代码库。 appsscript.json
将此代码文件的内容复制到剪贴板。
返回 Apps 脚本网页界面，选择 appsscript.json 文件名，并将代码粘贴到代码编辑器中替换之前的所有代码
对其他 4 个代码文件重复此过程： <ph type="x-smartling-placeholder">
- 复制 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 控制台页面。
前往 API 和服务页面自己的项目您现在应该会看到该页面上列出了 Vertex AI API。

创建服务账号

Google 幻灯片 Advisor 插件需要通过身份验证连接到您的 Cloud 项目访问 Vertex AI API 和 Gemini 模型。由您自己创建首先生成一个服务账号在有权访问 Vertex AI API 的 Cloud 项目中。Google 幻灯片顾问项目使用此服务账号进行连接。

要为幻灯片顾问插件创建服务账号，请执行以下操作：

在 Google Cloud 控制台中，前往 API 和服务 页面
选择页面左侧的凭据。
在页面顶部，选择 + 创建凭据 >服务账号。
在创建服务账号页面中，查看服务账号详情 部分中，输入服务账号名称、ID 和说明。
选择创建并继续以创建服务账号。
在向此服务账号授予对项目的访问权限部分中，选择 Role 控件。
在过滤条件字段中搜索，然后选择 Vertex AI User 权限集，然后选择继续。
选择完成，完成此服务账号的创建过程。

如需详细了解如何创建服务账号，请参阅 Google Cloud 创建服务账号文档。

创建并安装服务账号密钥

Google 幻灯片 Advisor 项目必须能够向服务账号进行身份验证您在上一过程中创建的配置文件。您可以通过以下方法启用该身份验证：为服务账号创建密钥并在幻灯片中配置该密钥作为脚本属性的 Advisor Apps 脚本项目。流程如下介绍如何在项目中创建和配置密钥。

如需创建和配置服务账号密钥，请执行以下操作：

在 Google Cloud 控制台中，前往 API 和服务页面 Cloud 项目。
选择页面左侧的凭据。
在服务账号部分，找到您所需的服务账号选择账号电子邮件地址或铅笔图标进行修改。
在服务账号修改窗口中，选择页面顶部附近的 KEYS标签页标题。
在键部分中，选择添加键 >创建新密钥。
在为...创建私钥对话框中，选择 JSON，然后选择创建。此步骤会创建一个名为 projectid-hashcode.json 的密钥文件并将其自动下载到您的计算机中。
打开下载的 projectid-hashcode.json 文件并复制内容。
打开包含 My 幻灯片顾问的 Apps 脚本网页界面项目，然后在左侧菜单中选择 Settings 视图。
在脚本属性部分，选择编辑脚本属性按钮，然后点击添加脚本属性按钮。
在新属性字段中，输入 SERVICE_ACCOUNT_KEY，并在值字段，复制下载的内容 projectid-hashcode.json 文件。
选择保存脚本属性按钮以保存新属性。

如需详细了解如何创建服务账号密钥，请参阅 Google Cloud 创建和删除服务账号密钥文档。

测试插件项目

带有“幻灯片顾问”图标的 Google Workspace 幻灯片面板要测试幻灯片审查程序项目，您需要创建测试部署插件代码，然后安装该测试部署。在此测试中配置，则项目仅可用于 Google 幻灯片演示文稿中您启动 Apps 脚本插件项目的位置，并且没有演示文稿。如需详细了解如何部署插件以供更广泛使用，请访问 Google Workspace Apps 脚本文档，创建和管理部署主题。

如需部署和测试 Apps 脚本项目代码，请执行以下操作：

在 Apps 脚本网页界面的顶部，选择部署 >测试部署。
在测试部署对话框中的选择类型旁边，齿轮图标和 Google Workspace 插件。
在“应用：幻灯片”标题旁边，选择安装按钮。
保留测试最新代码的默认设置，然后选择完成。
在与 Apps 脚本关联的 Google 幻灯片演示文稿中导航项目并重新加载网页。
选择 Google 幻灯片 Web 应用右下角的 ( <) 选择黑白眼睛图标即可打开侧边栏打开幻灯片顾问面板。

完成此步骤并成功运行该插件后，您可以开始以便采用不同的准则或遵循不同的工作流程。请参阅下面几部分，介绍了如何对 Google 幻灯片 Advisor 插件。

修改评价行为

您可以更改幻灯片审查程序的查看行为，包括 Gemini API 生成的输出，以及插件，通过修改其项目代码。本教程重点介绍如何更改提示修改演示文稿幻灯片查看行为的说明。对于详细了解如何使用 Apps 脚本扩展 Google 幻灯片界面，请参阅扩展 Google 幻灯片。

更改审核指南

幻灯片审查程序包含一套基本的幻灯片审阅指南按简单性、颜色和排版、结构和空白以及图形和图标评价指南只是文字说明以及一张包含完整图片说明的快照图片，所选幻灯片和任何演讲者备注

您可以通过更改操作说明。例如，你可以指示 Gemini 模型输出与类别评分位于同一行上的评论，或者更改类别名称。

要更改类别评分位置和类别名称，请执行以下操作：

打开包含我的幻灯片审查程序的 Apps 脚本网页界面项目。如有必要，请打开 Google Cloud 项目窗口，包含 Apps 脚本项目并选择 扩展程序 >Apps 脚本。
在左侧菜单中，选择 <>编辑器视图，然后选择 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 脚本关联的 Google 幻灯片演示文稿中导航重新加载网页，然后测试对该插件所做的更改，方法是重新运行该文件

如果您尚未为幻灯片顾问插件设置测试部署，请按照测试插件项目。

若要移除、替换或改写评价类别说明，您可在 SYSTEM_PROMPT 字符串常量，以符合您的评价要求。如果您想尝试不同的审核提示方法或重写整个评价请查看 Google AI Studio 网页版应用。借助这款应用，你可以对 Gemini 的提示进行原型设计、测试和保存，便捷界面，并且它使用的 Gemini API 与 Google 幻灯片顾问相同项目。如需详细了解如何使用 AI Studio，请参阅 AI Studio 快速入门指南。

更改模型行为配置

Gemini API 提供了一些设置，用于更改以响应请求提示。尤其是温度模型设置可让您设置模型在给定条件下 0 表示最低值，1 表示最高值。设置此值值 0.1 会产生非常一致的响应，但这种行为似乎是重复性的对用户获得评价反馈的帮助不大。您可以考虑将请注意，温度越高，结果可能会更不一致，这可能包括甚至以不同的方式忽略某些说明。

如要调高评价回复的温度，请执行以下操作：

打开包含 My 幻灯片顾问的 Apps 脚本网页界面项目。
在左侧菜单中，选择 <>编辑器视图，然后选择 ai.gs 文件名。

在 ai.gs 代码文件中，找到 analyzeSlides() 函数并通过设置 temperature 值来修改 generationConfig 常量发送至 0.3：

function analyzeSlides(slide) {

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

保存对 ai.gs 代码文件的更改。
在与 Apps 脚本关联的 Google 幻灯片演示文稿中导航重新加载网页，然后测试对该插件所做的更改，方法是重新运行该文件

如需详细了解模型行为配置设置，请参阅 Gemini API 文档 GenerationConfig。

其他资源

如需详细了解幻灯片顾问项目，请参阅代码库。如果您在构建应用时需要帮助，或想要与请访问 Google Developers 社区 Discord 服务器。如需了解更多“使用 Google AI 构建”项目，请参阅视频播放列表。