利用 Google Chat、Vertex AI 和 Apps Script 应对突发事件

本教程介绍了如何构建可实时响应突发事件的 Google Chat 应用。在响应突发事件时，该应用会创建并填充 Google Chat 聊天室，通过消息、斜杠命令和对话框来协助解决突发事件，并使用 AI 在 Google 文档中总结突发事件响应。

开发者预览版：作为 Google Workspace 开发者预览版计划的一部分提供，可抢先体验某些功能。

本教程使用以 https://www.googleapis.com/auth/chat.app.* 开头的授权范围，这些范围是开发者预览版的一部分，您的 Chat 应用必须获得一次性管理员批准。

警告： 如需按照本教程操作，您需要先在内部发布应用，然后使用管理信息中心为所有用户安装该应用。此操作会使应用对网域中的所有用户可见。我们建议在本教程中使用测试网域。

突发事件是指需要团队立即采取行动来解决的事件。以下是一些事件示例：

• 在客户关系管理 (CRM) 平台中创建了时间敏感型支持请求，需要服务团队协作解决。
• 系统离线，向一组站点可靠性工程师 (SRE) 发出提醒，以便他们协同工作，使系统恢复在线状态。
• 发生高震级地震，应急人员需要协调应对措施。

在本教程中，事件提醒从用户通过网页上的按钮点击报告事件时开始。该网页通过要求用户输入基本突发事件信息（标题、说明和响应者的电子邮件地址）来模拟突发事件。

了解事件管理 Chat 应用的实际应用情况：

• 

  图 1. 用户可以报告事件的网站。

• 
  图 2. 有关事件 Chat 聊天室已创建的通知。
• 
  图 3. 事件响应聊天室。
• 
  图 4. 使用斜杠命令解决突发事件。
• 
  图 5.突发事件解决对话框。
• 
  图 6. 聊天室中共享的突发事件解决情况 Google 文档。
• 
  图 7. 包含 AI 总结的突发事件解决情况 Google 文档。

前提条件

如果您的组织需要启用上述任何前提条件，请让您的 Google Workspace 管理员启用这些条件：

• 拥有 Google Workspace 商务版或企业版账号，且有权访问 Google Chat。
• 为 Google Workspace 启用目录（联系人共享）。突发事件应用使用该目录查找突发事件响应者的联系信息，例如姓名和电子邮件地址。事件响应者必须是贵组织中拥有 Google Chat 账号的 Google Workspace 用户。

目标

• 构建一个可响应突发事件的 Chat 应用。
• 通过以下方式帮助用户响应突发事件：
  • 创建突发事件响应空间。
  • 发布总结突发事件和响应的消息。
  • 支持通过互动式 Chat 应用功能进行协作。
• 使用 Vertex AI 总结对话和解决方案。

架构

下图展示了事件响应 Google Chat 应用使用的 Google Workspace 和 Google Cloud 资源的架构。

此架构展示了突发事件响应 Google Chat 应用如何处理突发事件和解决方案。

1. 用户从托管在 Apps 脚本上的外部网站发起突发事件。

2. 网站向 Google Chat 应用（也托管在 Apps 脚本上）发送异步 HTTP 请求。

3. 突发事件响应 Google Chat 应用会处理请求：

   1. Apps 脚本 Admin SDK 服务会获取团队成员信息，例如用户 ID 和电子邮件地址。

   2. 通过使用 Apps 脚本高级聊天服务向 Chat API 发送一组 HTTP 请求，事件响应 Google Chat 应用会创建一个事件聊天室，并向其中添加团队成员，然后向该聊天室发送消息。

4. 团队成员在 Chat 聊天室中讨论突发事件。

5. 团队成员调用斜杠命令来表明突发事件已解决。

   1. 使用 Apps 脚本高级聊天服务对 Chat API 进行 HTTP 调用，可列出所有 Chat 聊天室的消息。

   2. Vertex AI 接收列出的消息并生成摘要。

   3. Apps 脚本 DocumentApp 服务会创建一个 Google 文档，并将 Vertex AI 的摘要添加到该文档中。

   4. 事件响应 Google Chat 应用会调用 Chat API 来发送消息，分享指向总结文档的链接。

准备环境

本部分介绍如何为 Chat 应用创建和配置 Google Cloud 项目。

创建 Google Cloud 项目

Google Cloud 控制台

1. 在 Google Cloud 控制台中，依次前往菜单 > IAM 和管理 > 创建项目。

   前往“创建项目”

2. 在 Project Name 字段中，输入项目的描述性名称。

   可选：如需修改项目 ID，请点击修改。项目创建后，项目 ID 便无法更改，因此请选择满足项目生命周期需求的 ID。

3. 在位置字段中，点击浏览以显示项目的潜在位置。然后，点击选择。
   注意：找不到您的 Google Workspace 组织？
   这意味着您未登录 Google Workspace 账号。Google Workspace 开发者文档中描述的部分功能仅适用于与组织关联的项目。
4. 点击创建。Google Cloud 控制台会转到“信息中心”页面，您的项目会在几分钟内创建完毕。

gcloud CLI

在以下任一开发环境中，访问 Google Cloud CLI (gcloud)：

• Cloud Shell：如需使用已设置 gcloud CLI 的在线终端，请激活 Cloud Shell。
  激活 Cloud Shell
• 本地 shell：如需使用本地开发环境，请安装并初始化 gcloud CLI。
  如需创建 Cloud 项目，请使用 gcloud projects create 命令：

  gcloud projects create PROJECT_ID

  通过设置要创建的项目的 ID 来替换 PROJECT_ID。

为 Cloud 项目启用结算功能

如果您无法关联结算账号，则表示您没有进行此更改所需的权限。如需了解详情，请参阅启用结算所需的权限。

Google Cloud 控制台

1. 在 Google Cloud 控制台中，前往结算。依次点击 菜单 > 结算 > 我的项目。

   前往“我的项目的结算”页面

2. 在选择组织中，选择与您的 Google Cloud 项目关联的组织。
3. 在项目行中，打开操作菜单 ()，点击更改结算信息，然后选择 Cloud Billing 账号。
4. 点击设置账号。

gcloud CLI

1. 如需列出可用的结算账号，请运行以下命令：

   gcloud billing accounts list

2. 将结算账号与 Google Cloud 项目相关联：

   gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID

   替换以下内容：

   • PROJECT_ID 是您要为其启用结算功能的 Cloud 项目的项目 ID。
   • BILLING_ACCOUNT_ID 是要与 Google Cloud 项目关联的结算账号 ID。

启用 API

Google Cloud 控制台

1. 在 Google Cloud 控制台中，启用 Google Chat API、Google Docs API、Admin SDK API、Google Workspace Marketplace SDK 和 Vertex AI API。

   启用 API

2. 确认您要在正确的 Cloud 项目中启用 API，然后点击下一步。

3. 确认您要启用正确的 API，然后点击启用。

gcloud CLI

1. 如有必要，请使用 gcloud config set project 命令将当前 Cloud 项目设置为您创建的项目：

   gcloud config set project PROJECT_ID

   将 PROJECT_ID 替换为您创建的 Cloud 项目的项目 ID。

2. 使用 gcloud services enable 命令启用 Google Chat API、Google Docs API、Admin SDK API、Google Workspace Marketplace SDK 和 Vertex AI API：

   gcloud services enable chat.googleapis.com docs.googleapis.com admin.googleapis.com aiplatform.googleapis.com appsmarket-component.googleapis.com

设置身份验证和授权

Chat 应用使用 Chat 应用的凭据访问 Google Chat API。应用使用用户凭据访问 Admin SDK API 和 Google 文档 API。

设置用户身份验证和授权

通过身份验证和授权，Chat 应用可以访问 Google Workspace 和 Google Cloud 中的资源，以处理突发事件响应。具体而言，用户身份验证用于调用 Google Docs API 和 Admin SDK API。

在本教程中，您将应用在 Workspace 网域内发布，因此可以使用占位信息。在向外部发布应用之前，请在意见征求界面中将占位信息替换为真实信息。

1. 在 Google Cloud 控制台中，依次前往“菜单”图标 > > 品牌推广。

   前往“品牌推广”

2. 如果您已配置，则可以在品牌推广、受众群体和数据访问权限中配置以下 OAuth 权限请求页面设置。 如果您看到一条消息，提示 尚未配置，请点击开始：

   1. 在应用信息下的应用名称中，输入 Incident Management。
   2. 在用户支持电子邮件地址中，选择您的电子邮件地址或合适的 Google 群组。
   3. 点击下一步。
   4. 在受众群体下，选择内部。如果您无法选择内部，请选择外部。
   5. 点击下一步。
   6. 在联系信息下，输入一个电子邮件地址，以便您接收有关项目变更的通知。
   7. 点击下一步。
   8. 在完成下，查看 Google API 服务用户数据政策，如果您同意该政策，请选择我同意《Google API 服务：用户数据政策》。
   9. 点击继续。
   10. 点击创建。
   11. 如果您为用户类型选择了外部，请添加测试用户：
       1. 点击受众群体。
       2. 在测试用户下，点击添加用户。
       3. 输入您的电子邮件地址和任何其他已获授权的测试用户，然后点击保存。

3. 依次点击数据访问权限 > 添加或移除范围。系统随即会显示一个面板，其中列出了您在 Google Cloud 项目中启用的每个 API 的范围。

   1. 在手动添加范围下，粘贴以下范围：

      • https://www.googleapis.com/auth/documents
      • https://www.googleapis.com/auth/admin.directory.user.readonly
      • https://www.googleapis.com/auth/script.external_request
      • https://www.googleapis.com/auth/userinfo.email
      • https://www.googleapis.com/auth/cloud-platform

   2. 点击添加到表格。

   3. 点击更新。

   4. 选择应用所需的范围后，在数据访问权限页面上，点击保存。

设置应用身份验证和授权

应用身份验证用于调用 Google Chat API。

在 Google Cloud 控制台中创建服务账号

如需创建服务账号，请按照以下步骤操作：

Google Cloud 控制台

1. 在 Google Cloud 控制台中，依次前往菜单 > IAM 和管理 > 服务账号。

   转到“服务账号”

2. 点击创建服务账号。
3. 填写服务账号详细信息，然后点击创建并继续。
   注意：默认情况下，Google 会创建一个唯一的服务账号 ID。如果您想更改 ID，请修改服务账号 ID 字段中的 ID。
4. 可选：为服务账号分配角色，以授予对 Google Cloud 项目资源的访问权限。如需了解详情，请参阅授予、更改和撤消对资源的访问权限。
5. 点击继续。
6. 可选：输入可管理此服务账号并使用此服务账号执行操作的用户或群组。如需了解详情，请参阅管理服务账号模拟。
7. 点击完成。记下服务账号的电子邮件地址。

gcloud CLI

1. 创建服务账号：

   gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
     --display-name="SERVICE_ACCOUNT_NAME"

2. 可选：为服务账号分配角色，以授予对 Google Cloud 项目资源的访问权限。如需了解详情，请参阅授予、更改和撤消对资源的访问权限。

该服务账号会显示在服务账号页面上。接下来，为服务账号创建私钥。

创建一个私钥

警告： 为简单起见，此示例使用了导出的服务账号密钥。不建议在生产环境中导出私钥，因为私钥不应存储在不安全的位置（例如源代码控制中）。

如需详细了解安全的服务账号实现和最佳实践，请参阅选择何时使用服务账号。

如需为服务账号创建并下载私钥，请按以下步骤操作：

1. 在 Google Cloud 控制台中，依次前往菜单 > IAM 和管理 > 服务账号。

   转到“服务账号”

2. 选择您的服务账号。
3. 依次点击密钥 > 添加密钥 > 创建新密钥。
4. 选择 JSON，然后点击创建。

   系统会生成新的公钥/私钥对，并以新文件的形式下载到您的计算机。将下载的 JSON 文件以 credentials.json 的名称保存到工作目录中。此文件是相应密钥的唯一副本。如需了解如何安全地存储密钥，请参阅管理服务账号密钥。

5. 点击关闭。

如需详细了解服务账号，请参阅 Google Cloud IAM 文档中的服务账号。

创建与 Google Workspace Marketplace 兼容的 OAuth 客户端

如需创建与 Google Workspace Marketplace 兼容的 OAuth 客户端，请按以下步骤操作：

1. 在 Google Cloud 控制台中，依次前往菜单 > IAM 和管理 > 服务账号。

   转到“服务账号”

2. 点击您为 Chat 应用创建的服务账号。

3. 点击高级设置。

4. 点击创建与 Google Workspace Marketplace 兼容的 OAuth 客户端。

5. 点击继续。

系统会显示一条确认消息，表明已创建与 Google Workspace Marketplace 兼容的 OAuth 客户端。

创建和部署聊天应用

在下一部分中，您将复制并更新一个完整的 Apps 脚本项目，其中包含 Chat 应用所需的所有应用代码，因此无需复制并粘贴每个文件。

有些函数会在名称末尾添加下划线，例如 ChatApp.gs 中的 processSlashCommand_()。当在浏览器中打开事件初始化网页时，下划线会隐藏该函数。如需了解详情，请参阅私有函数。

Apps 脚本支持两种文件类型：.gs脚本和 .html文件。为了遵守此支持，应用的客户端 JavaScript 包含在 HTML 文件中的 <script /> 标记内，而其 CSS 包含在 <style /> 标记内。

您也可以在 GitHub 上查看整个项目。

在 GitHub 上查看

下面简要介绍一下每个文件：

Consts.gs

定义了其他代码文件引用的常量，包括您的 Cloud 项目 ID、Vertex AI 位置 ID、服务账号的应用凭据以及用于关闭突发事件的斜杠命令 ID。

查看 Consts.gs 代码

apps-script/incident-response-app-auth/Consts.gs

在 GitHub 上查看

const PROJECT_ID = 'replace-with-your-project-id';
const CLOSE_INCIDENT_COMMAND_ID = 1;
const APP_CREDENTIALS = 'replace-with-your-app-credentials';
const APP_CREDENTIALS_SCOPES = 'https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.app.memberships https://www.googleapis.com/auth/chat.app.spaces.create';
const VERTEX_AI_LOCATION_ID = 'us-central1';
const MODEL_ID = 'gemini-1.5-flash-002';

ChatApp.gs

处理 Chat 互动事件，包括消息、卡片点击、斜杠命令和对话框。通过打开一个对话框来响应 /closeIncident 斜杠命令，以收集突发事件解决详情。通过调用 Chat API 中的 spaces.messages.list 方法读取聊天室中的消息。 使用 Apps 脚本中的 Admin SDK Directory 服务获取用户 ID。

查看 ChatApp.gs 代码

apps-script/incident-response-app-auth/ChatApp.gs

在 GitHub 上查看

/**
 * Responds to a MESSAGE event in Google Chat.
 *
 * This app only responds to a slash command with the ID 1 ("/closeIncident").
 * It will respond to any other message with a simple "Hello" text message.
 *
 * @param {Object} event the event object from Google Chat
 */
function onMessage(event) {
  if (event.message.slashCommand) {
    return processSlashCommand_(event);
  }
  return { "text": "Hello from Incident Response app!" };
}

/**
 * Responds to a CARD_CLICKED event in Google Chat.
 *
 * This app only responds to one kind of dialog (Close Incident).
 *
 * @param {Object} event the event object from Google Chat
 */
function onCardClick(event) {
  if (event.isDialogEvent) {
    if (event.dialogEventType == 'SUBMIT_DIALOG') {
      return processSubmitDialog_(event);
    }
    return {
      actionResponse: {
        type: "DIALOG",
        dialogAction: {
          actionStatus: "OK"
        }
      }
    };
  }
}

/**
 * Responds to a MESSAGE event with a Slash command in Google Chat.
 *
 * This app only responds to a slash command with the ID 1 ("/closeIncident")
 * by returning a Dialog.
 *
 * @param {Object} event the event object from Google Chat
 */
function processSlashCommand_(event) {
  if (event.message.slashCommand.commandId != CLOSE_INCIDENT_COMMAND_ID) {
    return {
      "text": "Command not recognized. Use the command `/closeIncident` to close the incident managed by this space."
    };
  }
  const sections = [
    {
      header: "Close Incident",
      widgets: [
        {
          textInput: {
            label: "Please describe the incident resolution",
            type: "MULTIPLE_LINE",
            name: "description"
          }
        },
        {
          buttonList: {
            buttons: [
              {
                text: "Close Incident",
                onClick: {
                  action: {
                    function: "closeIncident"
                  }
                }
              }
            ]
          }
        }
      ]
    }
  ];
  return {
    actionResponse: {
      type: "DIALOG",
      dialogAction: {
        dialog: {
          body: {
            sections,
          }
        }
      }
    }
  };
}

/**
 * Responds to a CARD_CLICKED event with a Dialog submission in Google Chat.
 *
 * This app only responds to one kind of dialog (Close Incident).
 * It creates a Doc with a summary of the incident information and posts a message
 * to the space with a link to the Doc.
 *
 * @param {Object} event the event object from Google Chat
 */
function processSubmitDialog_(event) {
  const resolution = event.common.formInputs.description[""].stringInputs.value[0];
  const chatHistory = concatenateAllSpaceMessages_(event.space.name);
  const chatSummary = summarizeChatHistory_(chatHistory);
  const docUrl = createDoc_(event.space.displayName, resolution, chatHistory, chatSummary);
  return {
    actionResponse: {
      type: "NEW_MESSAGE",
    },
    text: `Incident closed with the following resolution: ${resolution}\n\nHere is the automatically generated post-mortem:\n${docUrl}`
  };
}

/**
 * Lists all the messages in the Chat space, then concatenate all of them into
 * a single text containing the full Chat history.
 *
 * For simplicity for this demo, it only fetches the first 100 messages.
 *
 * Messages with slash commands are filtered out, so the returned history will
 * contain only the conversations between users and not app command invocations.
 *
 * @return {string} a text containing all the messages in the space in the format:
 *          Sender's name: Message
 */
function concatenateAllSpaceMessages_(spaceName) {
  // Call Chat API method spaces.messages.list
  const response = Chat.Spaces.Messages.list(spaceName, { 'pageSize': 100 });
  const messages = response.messages;
  // Fetch the display names of the message senders and returns a text
  // concatenating all the messages.
  let userMap = new Map();
  return messages
    .filter(message => message.slashCommand === undefined)
    .map(message => `${getUserDisplayName_(userMap, message.sender.name)}: ${message.text}`)
    .join('\n');
}

/**
 * Obtains the display name of a user by using the Admin Directory API.
 *
 * The fetched display name is cached in the provided map, so we only call the API
 * once per user.
 *
 * If the user does not have a display name, then the full name is used.
 *
 * @param {Map} userMap a map containing the display names previously fetched
 * @param {string} userName the resource name of the user
 * @return {string} the user's display name
 */
function getUserDisplayName_(userMap, userName) {
  if (userMap.has(userName)) {
    return userMap.get(userName);
  }
  let displayName = 'Unknown User';
  try {
    const user = AdminDirectory.Users.get(
      userName.replace("users/", ""),
      { projection: 'BASIC', viewType: 'domain_public' });
    displayName = user.name.displayName ? user.name.displayName : user.name.fullName;
  } catch (e) {
    // Ignore error if the API call fails (for example, because it's an
    // out-of-domain user or Chat app)) and just use 'Unknown User'.
  }
  userMap.set(userName, displayName);
  return displayName;
}

ChatSpaceCreator.gs

接收用户在突发事件初始化网页上输入的表单数据，并使用这些数据通过创建和填充聊天室来设置聊天室，然后发布有关突发事件的消息。

查看 ChatSpaceCreator.gs 代码

apps-script/incident-response-app-auth/ChatSpaceCreator.gs

在 GitHub 上查看

/**
 * Handles an incident by creating a chat space, adding members, and posting a message.
 * All the actions are done using application credentials.
 *
 * @param {Object} formData - The data submitted by the user. It should contain the fields:
 *                           - title: The display name of the chat space.
 *                           - description: The description of the incident.
 *                           - users: A comma-separated string of user emails to be added to the space.
 * @return {string} The resource name of the new space.
 */
function handleIncident(formData) {
  const users = formData.users.trim().length > 0 ? formData.users.split(',') : [];
  const service = getService_();
  if (!service.hasAccess()) {
    console.error(service.getLastError());
    return;
   }
  const spaceName = createChatSpace_(formData.title, service);
  createHumanMembership_(spaceName, getUserEmail(), service);
  for (const user of users ){
    createHumanMembership_(spaceName, user, service);
  }
  createMessage_(spaceName, formData.description, service);
  return spaceName;
}
/**
 * Creates a chat space with application credentials.
 *
 * @param {string} displayName - The name of the chat space.
 * @param {object} service - The credentials of the service account.
 * @returns {string} The resource name of the new space.
*/
function createChatSpace_(displayName, service) {
  try {
    // For private apps, the alias can be used
    const my_customer_alias = "customers/my_customer";
    // Specify the space to create.
    const space = {
        displayName: displayName,
        spaceType: 'SPACE',                
        customer: my_customer_alias
    };
    // Call Chat API with a service account to create a message.
    const createdSpace = Chat.Spaces.create(
        space,
        {},
        // Authenticate with the service account token.
        {'Authorization': 'Bearer ' + service.getAccessToken()});
    return createdSpace.name;
  } catch (err) {
    // TODO (developer) - Handle exception.
    console.log('Failed to create space with error %s', err.message);
  }
}
/*
 * Creates a chat message with application credentials.
 *
 * @param {string} spaceName - The resource name of the space.
 * @param {string} message - The text to be posted.
 * @param {object} service - The credentials of the service account.
 * @return {string} the resource name of the new space.
 */
function createMessage_(spaceName, message, service) {
  try {
    // Call Chat API with a service account to create a message.
    const result = Chat.Spaces.Messages.create(
        {'text': message},
        spaceName,
        {},
        // Authenticate with the service account token.
        {'Authorization': 'Bearer ' + service.getAccessToken()});

  } catch (err) {
    // TODO (developer) - Handle exception.
    console.log('Failed to create message with error %s', err.message);
  }
}
/**
 * Creates a human membership in a chat space with application credentials.
 *
 * @param {string} spaceName - The resource name of the space.
 * @param {string} email - The email of the user to be added.
 * @param {object} service - The credentials of the service account.
 */
function createHumanMembership_(spaceName, email, service){
  try{
    const membership = {
      member: {
        name: 'users/'+email,
        // User type for the membership
        type: 'HUMAN'
      }
    };
    const result = Chat.Spaces.Members.create(
      membership,
      spaceName,
      {},
      {'Authorization': 'Bearer ' + service.getAccessToken()}
    );
  } catch (err){
    console.log('Failed to create membership with error %s', err.message)
  }

}

 /*
 * Creates a service for the service account.
 * @return {object}  - The credentials of the service account.
 */
function getService_() {
  return OAuth2.createService(APP_CREDENTIALS.client_email)
      .setTokenUrl('https://oauth2.googleapis.com/token')
      .setPrivateKey(APP_CREDENTIALS.private_key)
      .setIssuer(APP_CREDENTIALS.client_email)
      .setSubject(APP_CREDENTIALS.client_email)
      .setScope(APP_CREDENTIALS_SCOPES)
      .setPropertyStore(PropertiesService.getScriptProperties());
}

DocsApi.gs

调用 Google 文档 API 在用户的 Google 云端硬盘中创建 Google 文档，并将 VertexAiApi.gs 中创建的突发事件信息摘要写入该文档。

查看 DocsApi.gs 代码

apps-script/incident-response-app-auth/DocsApi.gs

在 GitHub 上查看

/**
 * Creates a Doc in the user's Google Drive and writes a summary of the incident information to it.
 *
 * @param {string} title The title of the incident
 * @param {string} resolution Incident resolution described by the user
 * @param {string} chatHistory The whole Chat history be included in the document
 * @param {string} chatSummary A summary of the Chat conversation to be included in the document
 * @return {string} the URL of the created Doc
 */
function createDoc_(title, resolution, chatHistory, chatSummary) {
  let doc = DocumentApp.create(title);
  let body = doc.getBody();
  body.appendParagraph(`Post-Mortem: ${title}`).setHeading(DocumentApp.ParagraphHeading.TITLE);
  body.appendParagraph("Resolution").setHeading(DocumentApp.ParagraphHeading.HEADING1);
  body.appendParagraph(resolution);
  body.appendParagraph("Summary of the conversation").setHeading(DocumentApp.ParagraphHeading.HEADING1);
  body.appendParagraph(chatSummary);
  body.appendParagraph("Full Chat history").setHeading(DocumentApp.ParagraphHeading.HEADING1);
  body.appendParagraph(chatHistory);
  return doc.getUrl();
}

VertexAiApi.gs

使用 Vertex AI API 总结 Chat 空间中的对话。此摘要会发布在 DocsAPI.gs 中专门创建的文档中。

查看 VertexAiApi.gs 代码

apps-script/incident-response-app-auth/VertexAiApi.gs

在 GitHub 上查看

/**
 * Summarizes a Chat conversation using the Vertex AI text prediction API.
 *
 * @param {string} chatHistory The Chat history that will be summarized.
 * @return {string} The content from the text prediction response.
 */


function summarizeChatHistory_(chatHistory) {

  const API_ENDPOINT = `https://${VERTEX_AI_LOCATION_ID}-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/${VERTEX_AI_LOCATION_ID}/publishers/google/models/${MODEL_ID}:generateContent`;
  const prompt = "Summarize the following conversation between Engineers resolving an incident"
      + " in a few sentences. Use only the information from the conversation.\n\n" + chatHistory;
  // Get the access token.
  const accessToken = ScriptApp.getOAuthToken();

  const headers = {
    'Authorization': 'Bearer ' + accessToken,
    'Content-Type': 'application/json',
  };
  const payload = {
    'contents': {
      'role': 'user',
      'parts' : [
        {
          'text': prompt
        }
      ]
    }
  }
  const options = {
    'method': 'post',
    'headers': headers,
    'payload': JSON.stringify(payload),
    'muteHttpExceptions': true,
  };
  try {
    const response = UrlFetchApp.fetch(API_ENDPOINT, options);
    const responseCode = response.getResponseCode();
    const responseText = response.getContentText();

    if (responseCode === 200) {
      const jsonResponse = JSON.parse(responseText);
      console.log(jsonResponse)
      if (jsonResponse.candidates && jsonResponse.candidates.length > 0) {
        return jsonResponse.candidates[0].content.parts[0].text; // Access the summarized text
      } else {
        return "No summary found in response.";
      }

    } else {
      console.error("Vertex AI API Error:", responseCode, responseText);
      return `Error: ${responseCode} - ${responseText}`;
    }
  } catch (e) {
    console.error("UrlFetchApp Error:", e);
    return "Error: " + e.toString();
  }
}

WebController.gs

提供突发事件初始化网站。

查看 WebController.gs 代码

apps-script/incident-response-app-auth/WebController.gs

在 GitHub 上查看

/**
 * Serves the web page from Index.html.
 */
function doGet() {
  return HtmlService
    .createTemplateFromFile('Index')
    .evaluate();
}

/**
 * Serves the web content from the specified filename.
 */
function include(filename) {
  return HtmlService
    .createHtmlOutputFromFile(filename)
    .getContent();
}

/**
 * Returns the email address of the user running the script.
 */
function getUserEmail() {
  return Session.getActiveUser().getEmail();
}

Index.html

包含突发事件初始化网站的 HTML。

查看 Index.html 代码

apps-script/incident-response-app-auth/Index.html

在 GitHub 上查看

<!DOCTYPE html>
<html>
  <head>
    <base target="_top">
    <link href='https://fonts.googleapis.com/css?family=Roboto' rel='stylesheet'>
    <?!= include('Stylesheet'); ?>
  </head>
  <body>
    <div class="container">
      <div class="content">
        <h1>Incident Manager</h1>
        <form id="incident-form" onsubmit="handleFormSubmit(this)">
          <div id="form">
            <p>
              <label for="title">Incident title</label><br/>
              <input type="text" name="title" id="title" />
            </p>
            <p>
              <label for="users">Incident responders</label><br/>
              <small>
                Please enter a comma-separated list of email addresses of the users
                that should be added to the space.
                Do not include <?= getUserEmail() ?> as it will be added automatically.
              </small><br/>
              <input type="text" name="users" id="users" />
            </p>
            <p>
              <label for="description">Initial message</label></br>
              <small>This message will be posted after the space is created.</small><br/>
              <textarea name="description" id="description"></textarea>
            </p>
            <p class="text-center">
              <input type="submit" value="CREATE CHAT SPACE" />
            </p>
          </div>
          <div id="output" class="hidden"></div>
          <div id="clear" class="hidden">
            <input type="reset" value="CREATE ANOTHER INCIDENT" onclick="onReset()" />
          </div>
        </form>
      </div>
    </div>
    <?!= include('JavaScript'); ?>
  </body>
</html>

JavaScript.html

处理事件初始化网站的表单行为，包括提交、错误和清除。它通过 WebController.gs 中的自定义 include 函数包含在 Index.html 中。

查看 JavaScript.html 代码

apps-script/incident-response-app-auth/JavaScript.html

在 GitHub 上查看

<script>
  var formDiv = document.getElementById('form');
  var outputDiv = document.getElementById('output');
  var clearDiv = document.getElementById('clear');

  function handleFormSubmit(formObject) {
    event.preventDefault();
    outputDiv.innerHTML = 'Please wait while we create the space...';
    hide(formDiv);
    show(outputDiv);
    google.script.run
      .withSuccessHandler(updateOutput)
      .withFailureHandler(onFailure)
      .handleIncident(formObject);
  }

  function updateOutput(response) {
    var spaceId = response.replace('spaces/', '');
    outputDiv.innerHTML =
      '<p>Space created!</p><p><a href="https://mail.google.com/chat/#chat/space/'
        + spaceId
        + '" target="_blank">Open space</a></p>';
    show(outputDiv);
    show(clearDiv);
  }

  function onFailure(error) {
    outputDiv.innerHTML = 'ERROR: ' + error.message;
    outputDiv.classList.add('error');
    show(outputDiv);
    show(clearDiv);
  }

  function onReset() {
    outputDiv.innerHTML = '';
    outputDiv.classList.remove('error');
    show(formDiv);
    hide(outputDiv);
    hide(clearDiv);
  }

  function hide(element) {
    element.classList.add('hidden');
  }

  function show(element) {
    element.classList.remove('hidden');
  }
</script>

Stylesheet.html

突发事件初始化网站的 CSS。它通过 WebController.gs 中的自定义 include 函数包含在 Index.html 中。

查看 Stylesheet.html 代码

apps-script/incident-response-app-auth/Stylesheet.html

在 GitHub 上查看

<style>
  * {
    box-sizing: border-box;
  }
  body {
    font-family: Roboto, Arial, Helvetica, sans-serif;
  }
  div.container {
    display: flex;
    justify-content: center;
    align-items: center;
    position: absolute;
    top: 0; bottom: 0; left: 0; right: 0;
  }
  div.content {
    width: 80%;
    max-width: 1000px;
    padding: 1rem;
    border: 1px solid #999;
    border-radius: 0.25rem;
    box-shadow: 0 2px 2px 0 rgba(66, 66, 66, 0.08), 0 2px 4px 2px rgba(66, 66, 66, 0.16);
  }
  h1 {
    text-align: center;
    padding-bottom: 1rem;
    margin: 0 -1rem 1rem -1rem;
    border-bottom: 1px solid #999;
  }
 #output {
    text-align: center;
    min-height: 250px;
  }
  div#clear {
    text-align: center;
    padding-top: 1rem;
    margin: 1rem -1rem 0 -1rem;
    border-top: 1px solid #999;
  }
  input[type=text], textarea {
    width: 100%;
    padding: 1rem 0.5rem;
    margin: 0.5rem 0;
    border: 0;
    border-bottom: 1px solid #999;
    background-color: #f0f0f0;
  }
  textarea {
    height: 5rem;
  }
  small {
    color: #999;
  }
  input[type=submit], input[type=reset] {
    padding: 1rem;
    border: none;
    background-color: #6200ee;
    color: #fff;
    border-radius: 0.25rem;
    width: 25%;
  }
  .hidden {
    display: none;
  }
  .text-center {
    text-align: center;
  }
  .error {
    color: red;
  }
</style>

查找您的 Cloud 项目编号和 ID

1. 在 Google Cloud 控制台中，前往您的 Cloud 项目。

   转到 Google Cloud 控制台

2. 依次点击“设置和实用程序”图标 > 项目设置。

3. 记下项目编号和项目 ID 字段中的值。您将在后续部分中使用它们。

创建 Apps 脚本项目

如需创建 Apps 脚本项目并将其与您的 Cloud 项目相关联，请执行以下操作：

1. 点击以下按钮，打开 使用 Google Chat 响应突发事件 Apps 脚本项目。
   打开项目
2. 点击 概览。
3. 在概览页面上，点击 复制。

4. 为复制的 Apps 脚本项目命名：

   1. 点击使用 Google Chat 应对突发事件的副本。

   2. 在项目标题中，输入 Incident Management Chat app。

   3. 点击重命名。

5. 在复制的 Apps 脚本项目中，前往 Consts.gs 文件，并将 YOUR_PROJECT_ID 替换为您的 Cloud 项目 ID。

设置 Apps 脚本项目的 Cloud 项目

1. 在 Apps 脚本项目中，点击 项目设置。
2. 在 Google Cloud Platform (GCP) 项目下，点击更改项目。
3. 在 GCP 项目编号中，粘贴您的 Cloud 项目的编号。
4. 点击设置项目。Cloud 项目和 Apps 脚本项目现已关联。

创建 Apps 脚本部署

现在，所有代码都已就绪，接下来请部署 Apps 脚本项目。在 Google Cloud 中配置 Chat 应用时，您需要使用部署 ID。

1. 在 Apps 脚本中，打开突发事件响应应用的项目。

   前往 Apps 脚本

2. 依次点击部署 > 新部署。

3. 如果尚未选择插件和 Web 应用，请点击选择类型旁边的部署类型 ，然后选择插件和 Web 应用。

4. 在说明中，输入此版本的说明，例如 Complete version of incident management app。

5. 在执行身份中，选择访问 Web 应用的用户

6. 在谁有访问权限中，选择您 Google Workspace 组织中的任何人，其中“您 Google Workspace 组织”是您 Google Workspace 组织的名称。

7. 点击部署。Apps 脚本会报告部署成功，并提供部署 ID 和事件初始化网页的网址。

8. 记下 Web 应用网址，以便稍后在开始处理突发事件时访问该网址。 复制部署 ID。您可以在 Google Cloud 控制台中配置 Chat 应用时使用此 ID。

9. 点击完成。

在 Google Cloud 控制台中配置 Chat 应用

本部分将介绍如何在 Google Cloud 控制台中配置 Google Chat API，其中包含有关 Chat 应用的信息，包括您刚刚从 Apps 脚本项目创建的部署的 ID。

1. 在 Google Cloud 控制台中，依次点击菜单 > 更多产品 > Google Workspace > 产品库 > Google Chat API > 管理 > 配置。

   前往 Chat API 配置

2. 在应用名称中，输入 Incident Management。

3. 在头像网址中，输入 https://developers.google.com/chat/images/quickstart-app-avatar.png。

4. 在说明中，输入 Responds to incidents.。

5. 点击启用互动功能切换开关，以切换到开启位置。

6. 在功能下，选择加入聊天室和群组对话。

7. 在连接设置下，选择 Apps 脚本。

8. 在部署 ID 中，粘贴您之前从 Apps 脚本项目部署中复制的 Apps 脚本部署 ID。

9. 注册完全实现的 Chat 应用使用的斜杠命令：

   1. 在命令下，点击添加命令。

   2. 在命令 ID 中，输入 1。

   3. 在说明中，输入 Closes the incident being discussed in the space.

   4. 在命令类型下，选择斜杠命令。

   5. 在斜杠命令名称中，输入 /closeIncident。

   6. 选择打开对话框。

   7. 点击完成。斜杠命令已注册并列出。

10. 在公开范围下，选择面向您的 Workspace 网域中的特定人员和群组提供此 Chat 扩展应用，然后输入您的电子邮件地址。

11. 在日志下，选择将错误记录到 Logging。

12. 点击保存。系统会显示一条“配置已保存”消息，表示应用已准备好进行测试。

获得管理员批准

如需获得管理员批准，您必须在 Google Workspace Marketplace SDK 中配置 Chat 应用。

在 Google Workspace Marketplace SDK 中配置 Chat 应用

如需在 Google Workspace Marketplace SDK 中配置 Chat 应用，请按以下步骤操作：

1. 在 Google Cloud 控制台中，依次前往菜单 > API 和服务 > 已启用的 API 和服务 > Google Workspace Marketplace SDK > 应用配置。

   前往“应用配置”

2. 完成“应用配置”页面。您如何配置 Chat 应用取决于您的目标受众群体和其他因素。如需有关完成应用配置页面的帮助，请参阅在 Google Workspace Marketplace SDK 中配置您的应用。 在本指南中，请输入以下信息：

   1. 在应用显示设置下，选择不公开。
   2. 在安装设置下，选择管理员安装。
   3. 在应用集成下，选择 Chat 应用。
   4. 在 OAuth 范围下，输入以下范围：
      • https://www.googleapis.com/auth/chat.app.spaces
      • https://www.googleapis.com/auth/chat.app.memberships
   5. 在开发者信息下方，输入您的开发者名称、开发者网站网址和开发者电子邮件地址。
   6. 点击 Save draft。

配置应用后，请更新商品详情：

1. 在 Google Cloud 控制台中，依次前往菜单 > API 和服务 > 已启用的 API 和服务 > Google Workspace Marketplace SDK > 商店详情。
2. 在应用详情中，选择“Web 开发”作为类别。
3. 在图形资源中，上传所需格式的应用图标。
4. 在屏幕截图中，上传应用的屏幕截图。
5. 在支持链接中，填写服务条款网址、隐私权网址和支持网址。
6. 在分发中，选择此应用将面向的区域。
7. 点击发布。

获得管理员批准

现在，您的服务账号已配置为接收管理员审批，请从 Google Workspace 管理员处获取审批，管理员可以按照为 Chat 应用设置授权中的步骤授予审批。

测试 Chat 应用

如需测试突发事件管理 Chat 应用，请从网页发起突发事件，并验证 Chat 应用是否按预期运行：

1. 前往 Apps 脚本部署 Web 应用网址。

2. 当 Apps 脚本请求访问您的数据时，请点击查看权限，使用 Google Workspace 网域中的相应 Google 账号登录，然后点击允许。

3. 系统会打开突发事件初始化网页。输入测试信息：

   1. 在突发事件标题中，输入 The First Incident。
   2. （可选）在突发事件响应人员中，输入其他突发事件响应人员的电子邮件地址。他们必须是 Google Workspace 组织中拥有 Google Chat 账号的用户，否则聊天室创建会失败。请勿输入您自己的电子邮件地址，因为系统会自动添加。
   3. 在初始消息中，输入 Testing the incident management Chat app.

4. 点击创建聊天室。系统会显示一条 creating space 消息。

5. 创建聊天室后，系统会显示 Space created! 消息。点击打开聊天室，这会在新标签页中打开 Chat 中的相应聊天室。

6. 您和其他突发事件响应者可以选择在空间中发送消息。该应用使用 Vertex AI 总结这些消息，并分享回顾性文档。

7. 如需结束突发事件响应并开始解决流程，请在聊天室中输入 /closeIncident。系统会打开一个突发事件管理对话框。

8. 在关闭突发事件中，输入突发事件解决情况的说明，例如 Test complete。

9. 点击关闭突发事件。

事件管理应用会列出聊天室中的消息，使用 Vertex AI 总结这些消息，将总结内容粘贴到 Google 文档中，然后在聊天室中分享该文档。

清理

为避免系统因本教程中使用的资源向您的 Google Cloud 账号收取费用，我们建议您删除 Cloud 项目。

警告：删除项目会产生以下影响：

• 项目中的所有内容都会被删除。如果您在本教程使用现有项目，则删除该项目后，还将删除您已在该项目中完成的其他所有工作。
• 自定义项目 ID 会丢失。创建此项目时，您可能创建了要在将来使用的自定义项目 ID。如需保留使用该项目 ID 的网址（例如 appspot.com 上的网址），请删除项目内的所选资源，而不是删除整个项目。

如果您打算浏览多个教程和快速入门，重复使用项目可以帮助您避免超出项目配额上限。

1. 在 Google Cloud 控制台中，前往管理资源页面。依次点击 菜单 > IAM 和管理 > 管理资源。

   前往资源管理器

2. 在项目列表中，选择要删除的项目，然后点击删除 。
3. 在对话框中输入项目 ID，然后点击关停以删除项目。

相关主题

• 使用 Gemini AI Chat 应用，根据 Chat 对话内容回答问题
• 使用 Google Chat、Vertex AI 和 Firestore 管理项目
• 使用 Google Chat、Vertex AI 和 Apps 脚本响应突发事件（用户身份验证）
• 突发事件响应应用会使用用户凭据进行身份验证，以调用 API 和调用 Google Cloud 服务，例如 Chat API 和 Vertex AI API。这意味着，发起突发事件的用户必须有权访问这些服务。为了使应用更可靠，请考虑使用服务账号（而不是调用 /closeIncident 斜杠命令的用户的用户凭据）调用 Vertex AI API。如需有关为 Vertex AI API 配置服务账号的帮助，请参阅使用自定义服务账号。