Responda a incidentes con Google Chat, Vertex AI y Apps Script

En este instructivo, se muestra cómo crear una app de Google Chat que responda a incidentes en tiempo real. Cuando responde a un incidente, la app crea y propaga un espacio de Chat, facilita la resolución de incidentes con mensajes, comandos de barra y diálogos, y usa la IA para resumir la respuesta ante el incidente en un documento de Documentos de Google.

Un incidente es un evento que requiere la atención inmediata de un equipo de personas para resolverlo. Entre los ejemplos de incidentes, se incluyen los siguientes:

• Los casos urgentes se crean en una plataforma de administración de relaciones con clientes (CRM), lo que requiere que un equipo de servicio colabore en una resolución.
• Un sistema se desconecta y alerta a un grupo de ingenieros de confiabilidad de sitios (SRE) para que puedan trabajar juntos a fin de volver a ponerlo en línea.
• Se produce un terremoto de gran magnitud y los trabajadores de emergencia deben coordinar su respuesta.

A los fines de este instructivo, la alerta de incidente se inicia cuando alguien informa el incidente con un clic en un botón desde una página web. Para simular un incidente, la página web solicita a los usuarios que ingresen información básica del incidente: el título, la descripción y las direcciones de correo electrónico de los responsables de la respuesta.

Observa cómo funciona la app de Chat de administración de incidentes:

• 

  Figura 1: Es el sitio web en el que alguien puede denunciar un incidente.

• 
  Figura 2: Notificación que indica que se creó el espacio de Chat del incidente
• 
  Figura 3: El espacio de Chat de respuesta ante incidentes
• 
  Figura 4: Resolver el incidente con un comando de barra
• 
  Figura 5: Diálogo de resolución de incidentes
• 
  Figura 6: Documento de Documentos de Google de resolución de incidentes que se comparte en el espacio.
• 
  Figura 7: El documento de Documentos de Google sobre la resolución de incidentes con resumen de IA.

Requisitos previos

Si necesitas activar alguno de estos requisitos previos para tu organización, pídele al administrador de Google Workspace que los active:

• Una cuenta de Google Workspace con acceso a Google Chat
• Tener activado el directorio (uso compartido de los contactos) para Google Workspace La app de incidentes usa el directorio para buscar la información de contacto del personal de respuesta ante incidentes, como el nombre y la dirección de correo electrónico. Los responsables de respuesta ante incidentes deben ser usuarios con una cuenta de Google Chat en tu organización de Google Workspace.

Objetivos

• Compila una app de Chat que responda a los incidentes.
• Ayuda a los usuarios a responder a los incidentes de la siguiente manera:
  • Crear espacios de respuesta ante incidentes
  • Publicación de mensajes que resumen incidentes y respuestas
  • Respalda la colaboración con funciones interactivas de la app de Chat.
• Resume conversaciones y soluciones con Vertex AI.

Arquitectura

En el siguiente diagrama, se muestra la arquitectura de los recursos de Google Workspace y Google Cloud que usa la app de Google Chat de respuesta ante incidentes.

En la arquitectura, se muestra cómo la app de Google Chat de respuesta ante incidentes procesa un incidente y su resolución.

1. Un usuario inicia un incidente desde un sitio web externo alojado en Apps Script.

2. El sitio web envía una solicitud HTTP asíncrona a la app de Google Chat, que también se aloja en Apps Script.

3. La app de Google Chat de respuesta ante incidentes procesa la solicitud:

   1. El servicio del SDK de Admin de Apps Script obtiene información de los miembros del equipo, como el ID del usuario y la dirección de correo electrónico.

   2. Con un conjunto de solicitudes HTTP a la API de Chat con el servicio de Chat avanzado de Apps Script, la app de Google Chat de respuesta ante incidentes crea un espacio de Chat sobre incidentes, lo propaga con los miembros del equipo y envía un mensaje al espacio.

4. Los miembros del equipo analizan el incidente en el espacio de Chat.

5. Un miembro del equipo invoca un comando de barra para indicar una resolución al incidente.

   1. Una llamada HTTP a la API de Chat con el servicio de Chat avanzado de Apps Script enumera todos los mensajes del espacio de Chat.

   2. Vertex AI recibe los mensajes enumerados y genera un resumen.

   3. El servicio DocumentApp de Apps Script crea un documento de Documentos y le agrega el resumen de Vertex AI.

   4. La app de Google Chat de respuesta ante incidentes llama a la API de Chat para enviar un mensaje con un vínculo al documento de resumen de Documentos.

Prepare el entorno

En esta sección, se muestra cómo crear y configurar un proyecto de Google Cloud para la app de Chat.

Crea un proyecto de Google Cloud

Consola de Google Cloud

1. En la consola de Google Cloud, ve a Menú > IAM y administración > Crear un proyecto.

   Ir a Crear un proyecto

2. En el campo Nombre del proyecto, ingresa un nombre descriptivo para tu proyecto.

   Opcional: Para editar el ID del proyecto, haz clic en Editar. El ID del proyecto no se puede cambiar después de que se crea, por lo que debes elegir un ID que satisfaga tus necesidades durante todo el ciclo de vida del proyecto.

3. En el campo Ubicación, haz clic en Explorar para mostrar las ubicaciones posibles del proyecto. Luego, haga clic en Seleccionar.
   Precaución: ¿No encuentras tu organización de Google Workspace?
   Esto significa que no accediste a una cuenta de Google Workspace. Algunas de las funciones que se describen en la documentación para desarrolladores de Google Workspace solo están disponibles para proyectos asociados con una organización.
4. Haz clic en Crear. La consola de Google Cloud navega a la página Panel y tu proyecto se crea en unos minutos.

gcloud CLI

En uno de los siguientes entornos de desarrollo, accede a Google Cloud CLI (`gcloud`):

• Cloud Shell: Para usar una terminal en línea con la CLI de gcloud ya configurada, activa Cloud Shell.
  Activar Cloud Shell
• Shell local: Para usar un entorno de desarrollo local, instala e initialize la CLI de gcloud.
  Para crear un proyecto de Cloud, usa el comando “gcloud projects create”:

  gcloud projects create PROJECT_ID

  Reemplaza PROJECT_ID mediante la configuración del ID del proyecto que deseas crear.

Habilita la facturación para el proyecto de Cloud

Si no puedes vincular una cuenta de facturación, no tienes los permisos necesarios para realizar este cambio. Si quieres obtener más información, consulta Permisos necesarios para habilitar la facturación.

Consola de Google Cloud

1. En la consola de Google Cloud, ve a Facturación. Haz clic en Menú > Facturación > Mis proyectos.

   Ir a Facturación de mis proyectos

2. En Selecciona una organización, elige la organización asociada con tu proyecto de Google Cloud.
3. En la fila del proyecto, abre el menú Acciones (), haz clic en Cambiar facturación y elige la cuenta de Facturación de Cloud.
4. Haz clic en Establecer cuenta.

gcloud CLI

1. Para enumerar las cuentas de facturación disponibles, ejecuta

   gcloud billing accounts list

   .
2. Vincula una cuenta de facturación con un proyecto de Google Cloud:

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

   Reemplaza lo siguiente:

   • PROJECT_ID es el ID del proyecto de Cloud para el que deseas habilitar la facturación.
   • BILLING_ACCOUNT_ID es el ID de la cuenta de facturación que se vinculará con el proyecto de Google Cloud.

Habilita las APIs

Consola de Google Cloud

1. En la consola de Google Cloud, habilita la API de Google Chat, la API de Documentos de Google, la API del SDK de Admin y la API de Vertex AI.

   Habilita las APIs

2. Confirma que estás habilitando las APIs en el proyecto de Cloud correcto y, luego, haz clic en Siguiente.

3. Confirma que estás habilitando las APIs correctas y, luego, haz clic en Habilitar.

gcloud CLI

1. Si es necesario, configura el proyecto de Cloud actual como el que creaste con el comando gcloud config set project:

   gcloud config set project PROJECT_ID
   

   Reemplaza PROJECT_ID por el ID del proyecto de Cloud que creaste.

2. Habilita la API de Google Chat, la API de Documentos de Google, la API del SDK de Admin y la API de Vertex AI con el comando gcloud services enable:

   gcloud services enable chat.googleapis.com docs.googleapis.com admin.googleapis.com aiplatform.googleapis.com
   

Configura la autenticación y la autorización

La autenticación y la autorización permiten que la app de Chat acceda a los recursos en Google Workspace y Google Cloud para procesar una respuesta ante incidentes.

En este instructivo, publicarás la app internamente para que sea correcto usar información del marcador de posición. Antes de publicar la app de forma externa, reemplaza la información del marcador de posición con información real para la pantalla de consentimiento.

1. En la consola de Google Cloud, ve a Menú > APIs y servicios > Pantalla de consentimiento de OAuth.

   Ir a la pantalla de consentimiento de OAuth

2. En Tipo de usuario, selecciona Interno y, luego, haz clic en Crear.

3. En Nombre de la app, escribe Incident Management.

4. En Correo electrónico de asistencia del usuario, selecciona tu dirección de correo electrónico o un Grupo de Google adecuado.

5. En Información de contacto del desarrollador, ingresa tu dirección de correo electrónico.

6. Haz clic en Save and Continue.

7. Haz clic en Add or Remove Scopes. Aparecerá un panel con una lista de permisos para cada API que hayas habilitado en tu proyecto de Cloud.

8. En Agregar permisos de forma manual, pega los siguientes permisos:

   • https://www.googleapis.com/auth/chat.spaces.create
   • https://www.googleapis.com/auth/chat.memberships
   • https://www.googleapis.com/auth/chat.memberships.app
   • https://www.googleapis.com/auth/chat.messages
   • 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

9. Haz clic en Add to Table.

10. Haz clic en Update.

11. Haz clic en Save and Continue.

12. Revisa el resumen de registro de la app y, luego, haz clic en Volver al panel.

Crea e implementa la app de Chat

En la siguiente sección, copiarás y actualizarás un proyecto de Apps Script completo que contiene todo el código de aplicación requerido para tu app de Chat, por lo que no es necesario copiar y pegar cada archivo.

Algunas funciones incluyen guiones bajos al final de sus nombres, como processSlashCommand_() de ChatApp.gs. El guion bajo oculta la función de la página web de inicialización de incidentes cuando se abre en un navegador. Para obtener más información, consulta Funciones privadas.

Apps Script admite dos tipos de archivos: secuencias de comandos .gs y archivos .html. Para cumplir con esta compatibilidad, el código JavaScript del cliente de la app se incluye dentro de las etiquetas <script />, y su CSS se incluye dentro de las etiquetas <style />, dentro de un archivo HTML.

De manera opcional, puedes ver el proyecto completo en GitHub.

Ver en GitHub

A continuación, se incluye una descripción general de cada archivo:

Consts.gs

Define las constantes a las que hacen referencia otros archivos de código, incluido el ID del proyecto de Cloud, el ID de ubicación de Vertex AI y el ID del comando de barra para cerrar un incidente.

Ver el código de Consts.gs

apps-script/incident-response/Consts.gs

Ver en GitHub

const PROJECT_ID = 'replace-with-your-project-id';
const VERTEX_AI_LOCATION_ID = 'us-central1';
const CLOSE_INCIDENT_COMMAND_ID = 1;

ChatApp.gs

Controla los eventos de interacción de Chat, incluidos los mensajes, los clics en tarjetas, los comandos de barra y los diálogos. Responde al comando de barra /closeIncident mediante la apertura de un diálogo para recopilar detalles sobre la resolución de incidentes. Lee mensajes en el espacio llamando al método spaces.messages.list en la API de Chat. Obtiene los ID de usuario mediante el servicio de Directorio del SDK de Admin en Apps Script.

Ver el código de ChatApp.gs

apps-script/incident-response/ChatApp.gs

Ver en 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

Recibe los datos del formulario que los usuarios ingresan en la página web de inicialización del incidente y los usa para configurar un espacio de Chat creando y propagándolo, y, luego, publica un mensaje sobre el incidente.

Ver el código de ChatSpaceCreator.gs

apps-script/incident-response/ChatSpaceCreator.gs

Ver en GitHub

/**
 * Creates a space in Google Chat with the provided title and members, and posts an
 * initial message to it.
 *
 * @param {Object} formData the data submitted by the user. It should contain the fields
 *                          title, description, and users.
 * @return {string} the resource name of the new space.
 */
function createChatSpace(formData) {
  const users = formData.users.trim().length > 0 ? formData.users.split(',') : [];
  const spaceName = setUpSpace_(formData.title, users);
  addAppToSpace_(spaceName);
  createMessage_(spaceName, formData.description);
  return spaceName;
}

/**
 * Creates a space in Google Chat with the provided display name and members.
 *
 * @return {string} the resource name of the new space.
 */
function setUpSpace_(displayName, users) {
  const memberships = users.map(email => ({
    member: {
      name: `users/${email}`,
      type: "HUMAN"
    }
  }));
  const request = {
    space: {
      displayName: displayName,
      spaceType: "SPACE",
      externalUserAllowed: true
    },
    memberships: memberships
  };
  // Call Chat API method spaces.setup
  const space = Chat.Spaces.setup(request);
  return space.name;
}

/**
 * Adds this Chat app to the space.
 *
 * @return {string} the resource name of the new membership.
 */
function addAppToSpace_(spaceName) {
  const request = {
    member: {
      name: "users/app",
      type: "BOT"
    }
  };
  // Call Chat API method spaces.members.create
  const membership = Chat.Spaces.Members.create(request, spaceName);
  return membership.name;
}

/**
 * Posts a text message to the space on behalf of the user.
 *
 * @return {string} the resource name of the new message.
 */
function createMessage_(spaceName, text) {
  const request = {
    text: text
  };
  // Call Chat API method spaces.messages.create
  const message = Chat.Spaces.Messages.create(request, spaceName);
  return message.name;
}

DocsApi.gs

Llama a la API de Documentos de Google para crear un documento de Documentos de Google en la unidad de Google Drive de un usuario y escribe en el documento un resumen de la información del incidente, creado en VertexAiApi.gs.

Ver el código de DocsApi.gs

apps-script/incident-response/DocsApi.gs

Ver en 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

Resume la conversación en el espacio de Chat con Vertex AI. Este resumen se publica en un documento creado especialmente en DocsAPI.gs.

Ver el código de VertexAiApi.gs

apps-script/incident-response/VertexAiApi.gs

Ver en 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 prompt =
    "Summarize the following conversation between Engineers resolving an incident"
      + " in a few sentences. Use only the information from the conversation.\n\n"
      + chatHistory;
  const request = {
    instances: [
      { prompt: prompt }
    ],
    parameters: {
      temperature: 0.2,
      maxOutputTokens: 256,
      topK: 40,
      topP: 0.95
    }
  }
  const fetchOptions = {
    method: 'POST',
    headers: { Authorization: 'Bearer ' + ScriptApp.getOAuthToken() },
    contentType: 'application/json',
    payload: JSON.stringify(request)
  }
  const response = UrlFetchApp.fetch(
    `https://${VERTEX_AI_LOCATION_ID}-aiplatform.googleapis.com/v1`
      + `/projects/${PROJECT_ID}/locations/${VERTEX_AI_LOCATION_ID}`
      + "/publishers/google/models/text-bison:predict",
    fetchOptions);
  const payload = JSON.parse(response.getContentText());
  return payload.predictions[0].content;
}

WebController.gs

Entrega el sitio web de inicialización de incidentes.

Ver el código de WebController.gs

apps-script/incident-response/WebController.gs

Ver en 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

El HTML que comprende el sitio web de inicialización del incidente.

Ver el código de Index.html

apps-script/incident-response/Index.html

Ver en 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

Controla el comportamiento del formulario, incluidos los envíos, errores y eliminaciones, para el sitio web de inicialización de incidentes. Se incluye en Index.html mediante la función include personalizada en WebController.gs.

Ver el código de JavaScript.html

apps-script/incident-response/JavaScript.html

Ver en 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)
      .createChatSpace(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

El CSS para el sitio web de inicialización del incidente. Se incluye en Index.html mediante la función include personalizada en WebController.gs.

Ver el código de Stylesheet.html

apps-script/incident-response/Stylesheet.html

Ver en 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>

Busca el número y el ID del proyecto de Cloud

1. En la consola de Google Cloud, ve a tu proyecto de Cloud.

   Ir a la consola de Google Cloud

2. Haz clic en Configuración y Utilidades > Configuración del proyecto.

3. Anota los valores en los campos Número del proyecto y ID del proyecto. Se usarán en las siguientes secciones.

Crea el proyecto de Apps Script

Para crear un proyecto de Apps Script y conectarlo a tu proyecto de Cloud, sigue estos pasos:

1. Haz clic en el siguiente botón para abrir el proyecto de Apps Script Responde a incidentes con Google Chat.
   Abre el proyecto.
2. Haz clic en Descripción general.
3. En la página de resumen, haz clic en Crear una copia.

4. Asigna un nombre a tu copia del proyecto Apps Script:

   1. Haz clic en Copiar de Responder a incidentes con Google Chat.

   2. En Título del proyecto, escribe Incident Management Chat app.

   3. Haga clic en Cambiar nombre.

5. En tu copia del proyecto de Apps Script, ve al archivo Consts.gs y reemplaza YOUR_PROJECT_ID por el ID de tu proyecto de Cloud.

Configura el proyecto de Cloud del proyecto de Apps Script

1. En tu proyecto de Apps Script, haz clic en Configuración del proyecto.
2. En Proyecto de Google Cloud Platform (GCP), haz clic en Cambiar proyecto.
3. En número de proyecto de GCP, pega el número de tu proyecto de Cloud.
4. Haz clic en Establecer el proyecto. Los proyectos de Cloud y de Apps Script ahora están conectados.

Crea una implementación de Apps Script

Ahora que todo el código está listo, implementa el proyecto de Apps Script. Usa el ID de implementación cuando configures la app de Chat en Google Cloud.

1. En Apps Script, abre el proyecto de la app de respuesta ante incidentes.

   Ir a Apps Script

2. Haz clic en Implementar > Implementación nueva.

3. Si Complemento y Aplicación web no están seleccionados, junto a Seleccionar tipo, haz clic en los tipos de implementación y selecciona Complemento y Aplicación web.

4. En Descripción, ingresa una descripción para esta versión, como Complete version of incident management app.

5. En Ejecutar como, selecciona El usuario accede a la app web.

6. En Quién tiene acceso, selecciona Cualquier persona de tu organización de Workspace, en la que “tu organización de Workspace” es el nombre de tu organización de Google Workspace.

7. Haz clic en Implementar. Apps Script informa que la implementación se realizó correctamente y proporciona un ID de implementación y una URL para la página web de inicialización del incidente.

8. Toma nota de la URL de la aplicación web para visitarla más tarde cuando inicies un incidente. Copia el ID de implementación. Usarás este ID cuando configures la app de Chat en la consola de Google Cloud.

9. Haz clic en Listo.

Configura la app de Chat en la consola de Google Cloud

En esta sección, se muestra cómo configurar la API de Google Chat en la consola de Google Cloud con información sobre tu app de Chat, incluido el ID de la implementación que acabas de crear desde tu proyecto de Apps Script.

1. En la consola de Google Cloud, haz clic en Menú > Más productos > Google Workspace > Biblioteca de productos > API de Google Chat > Administrar > Configuración.

   Ir a la configuración de la API de Chat

2. En Nombre de la app, escribe Incident Management.

3. En URL del avatar, escribe https://developers.google.com/chat/images/quickstart-app-avatar.png.

4. En Descripción, escribe Responds to incidents..

5. Haz clic en el botón Enable Interactive features para que se active.

6. En Funcionalidad, selecciona Recibir mensajes 1:1 y Unirse a espacios y conversaciones grupales.

7. En Configuración de la conexión, selecciona Proyecto de Apps Script.

8. En ID de implementación, pega el ID de implementación de Apps Script que copiaste antes de la implementación del proyecto de Apps Script.

9. Registra un comando de barra que use la app de Chat completamente implementada:

   1. En Comandos de barra, haz clic en Agregar un comando de barra.

   2. En Nombre, escribe /closeIncident.

   3. En ID de comando, escribe 1.

   4. En Descripción, escribe Closes the incident being discussed in the space..

   5. Selecciona Abrir un diálogo.

   6. Haz clic en Listo. El comando de barra está registrado y en la lista.

10. En Visibilidad, selecciona Hacer que esta app de chat esté disponible para personas y grupos específicos de tu dominio de Workspace y, luego, ingresa tu dirección de correo electrónico.

11. En Registros, selecciona Registrar errores en Logging.

12. Haz clic en Guardar. Aparecerá un mensaje de configuración guardada, lo que significa que la app está lista para probarse.

Prueba la app de Chat

Para probar la app de Chat de administración de incidentes, inicia un incidente desde la página web y verifica que la app de Chat funcione como se espera:

1. Ve a la URL de la aplicación web de implementación de Apps Script.

2. Cuando Apps Script te solicite permiso para acceder a tus datos, haz clic en Revisar permisos, accede con una Cuenta de Google adecuada en tu dominio de Google Workspace y haz clic en Permitir.

3. Se abrirá la página web de inicialización de incidentes. Ingresa la información de la prueba:

   1. En Título del incidente, escribe The First Incident.
   2. De manera opcional, en Respuestas a incidentes, ingresa las direcciones de correo electrónico de los demás responsables de la respuesta ante incidentes. Deben ser usuarios con una cuenta de Google Chat en tu organización de Google Workspace, de lo contrario, no se pudo crear el espacio. No ingreses tu propia dirección de correo electrónico, ya que se incluye automáticamente.
   3. En Mensaje inicial, escribe Testing the incident management Chat app.

4. Haz clic en Crear espacio de Chat. Aparecerá el mensaje creating space.

5. Una vez que se cree el espacio, aparecerá un mensaje Space created!. Haz clic en Abrir espacio para que se abra el espacio en Chat en una pestaña nueva.

6. De manera opcional, tú y los otros responsables de la respuesta ante incidentes pueden enviar mensajes en el espacio. La app resume estos mensajes con Vertex AI y comparte un documento retrospectivo.

7. Para finalizar la respuesta ante incidentes y comenzar el proceso de resolución, en el espacio de Chat, escribe /closeIncident. Se abrirá un diálogo de administración de incidentes.

8. En Cerrar incidente, ingresa una descripción para la resolución del incidente, como Test complete.

9. Haz clic en Cerrar incidente.

La app de administración de incidentes enumera los mensajes en el espacio, los resume con Vertex AI, pega el resumen en un documento de Documentos de Google y comparte el documento en el espacio.

Limpia

Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en este instructivo, te recomendamos que borres el proyecto de Cloud.

Precaución: Borrar un proyecto tiene las siguientes consecuencias:

• Se borra todo en el proyecto. Si utilizaste un proyecto existente para este instructivo, cuando lo borres, también borrarás cualquier otro trabajo que hayas realizado en el proyecto.
• Se pierden los ID personalizados de proyectos. Cuando creaste este proyecto, es posible que hayas creado un ID del proyecto personalizado que desees utilizar en el futuro. Para conservar las URLs que usan el ID del proyecto, como una URL en appspot.com, borra los recursos seleccionados dentro del proyecto en lugar de borrar todo el proyecto.

Si planeas explorar varios instructivos y guías de inicio rápido, la reutilización de proyectos puede ayudarte a evitar exceder los límites de las cuotas del proyecto.

1. En la consola de Google Cloud, ve a la página Administrar recursos. Haz clic en Menú > IAM y administración > Administrar recursos.

   Ir a Resource Manager

2. En la lista de proyectos, selecciona el proyecto que deseas borrar y haz clic en Borrar .
3. En el diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrarlo.

Temas relacionados

• Responde preguntas basadas en conversaciones de chat con una app de chat con IA de Gemini
• Administra proyectos con Google Chat, Vertex AI y Firestore
• La app de respuesta ante incidentes se autentica con credenciales de usuario para llamar a las APIs y, luego, invocar servicios de Google Cloud, como la API de Chat y la API de Vertex AI. Esto significa que el usuario que inicializa un incidente debe tener acceso a estos servicios. Para que la app sea más sólida, considera llamar a la API de Vertex AI con como cuenta de servicio en lugar de las credenciales del usuario que invoca el comando de barra /closeIncident. Si quieres obtener ayuda para configurar una cuenta de servicio para la API de Vertex AI, consulta Usa una cuenta de servicio personalizada.