Crea tu primer agente

Requisitos previos

Crea tu agente

En esta guía, se explica cómo crear un agente con una aplicación de muestra. La muestra proporciona una forma rápida de explorar la funcionalidad de un agente y puede servir como punto de partida para el desarrollo del agente. Si deseas modificar una aplicación existente a fin de incluir un agente, la muestra ofrece un buen modelo para la lógica de tu aplicación.

En esta guía de inicio rápido, harás lo siguiente:

  • Registrarse como socio
  • Crea una marca y un agente
  • De manera opcional, explora las funciones de una conversación con el bot de ayuda de Business Messages
  • Configura tu agente para enviar y recibir mensajes

Para crear un agente sin usar la muestra, consulta Crea tu agente.

Registrarse como socio

  1. Abre la consola para desarrolladores de Business Communications.
  2. En Business Messages, haga clic en Create partner account.

  3. Ingresa tu información de socio:

    Campo Valor
    Tu nombre Su nombre completo
    Nombre del socio Nombre de tu organización
    Sitio web del socio Sitio web de tu organización
    Región La región en la que deseas alojar el servicio de Business Messages

  4. Revisa y acepta las Condiciones del Servicio de Business Messages.

  5. Haz clic en Crear.

Ahora estás registrado como socio de Business Messages. Se creó un nuevo proyecto de Google Cloud con las API de Business Messages y Business Communications habilitadas. No tienes acceso a este proyecto y no interferirá con ninguno de tus proyectos de Google Cloud existentes.

Ahora tienes acceso a las API de Business Messages y Business Communications.

Crea una cuenta de servicio

  1. En la página principal de Business Communications Developer Console, haz clic en Configuración de la cuenta de socio.
  2. En el panel de navegación izquierdo, haz clic en Cuenta de servicio.

  3. Haz clic en Crear clave y, luego, en Crear.

    Tu navegador descarga la clave de la cuenta de servicio. Almacénala en un lugar seguro. Necesitarás esta clave más adelante para implementar una aplicación web y acceder a las API de Business Messages y Business Communications en el futuro.

Crea una marca y un agente

Un agente es una representación conversacional de una marca, la entidad conversacional con la que interactúan los usuarios. Debes crear una marca para representar a la empresa y un agente a fin de que los consumidores puedan conectarse con ella de forma conversacional.

  1. Abre la consola para desarrolladores de Business Communications y accede con tu Cuenta de Google de Business Messages.
  2. Haz clic en Create Agent.
  3. En Agent type, seleccione Business Messages.
  4. Ingresa los valores para el nombre de la marca y el nombre del agente.
  5. Realiza una de las siguientes acciones:
    • Para experimentar una conversación con tu agente en la que puedas explorar las funciones disponibles, selecciona Habilitar el bot de ayuda de Business Messages.
    • A fin de personalizar tu agente y prepararlo para el manejo de mensajes, anula la selección de la opción Habilitar el bot de ayuda de Business Messages.
  6. Haz clic en Create Agent.

Si habilitaste el bot de ayuda de Business Messages, puedes iniciar una conversación de inmediato. De lo contrario, sigue con la configuración de tu agente para el manejo de mensajes.

Explora las funciones con el bot de ayuda de Business Messages

El bot de ayuda de Business Messages te permite iniciar rápidamente una conversación con tu agente para que puedas experimentar lo que ofrece la plataforma. Habilitar el bot de ayuda es opcional, pero es muy recomendable cuando creas tu primer agente.

El bot de ayuda te permite

  • Explora funciones completas
  • Aprende a implementar las funciones
  • Buscar recursos para la configuración del agente

Cuando el bot de ayuda está habilitado, envía y recibe mensajes para tu agente; no se requiere webhook. Debes inhabilitar el bot de ayuda para poder configurar un webhook o habilitar Dialogflow a fin de controlar los mensajes del usuario.

Cómo iniciar una conversación con el bot de ayuda

Una vez que habilites el bot de ayuda de Business Messages, podrás iniciar una conversación. Se abrirá un cuadro de diálogo inmediatamente después de la creación del agente para ayudarte a comenzar.

Para interactuar con el bot de ayuda, sigue estos pasos:

  1. Accede a las URL de prueba del agente. Existen varias formas de hacerlo:

    • Haz clic en el botón Android o en el botón iOS. Luego, escanea el código QR con el dispositivo móvil correspondiente y haz clic en Launch. Como alternativa, haz clic en Copiar URL de Android o Copiar URL de iOS para copiar la URL de prueba del agente.
    • Haz clic en Enviar para enviar las URL a tu dirección de correo electrónico.

  2. Abre la URL en tu dispositivo móvil. (los dispositivos iOS requieren la app de Google Maps).

Inhabilitar el bot de ayuda

Antes de que puedas personalizar tu agente y prepararlo para el lanzamiento, debes inhabilitar el bot de ayuda de Business Messages.

Para inhabilitar el bot de ayuda, haz lo siguiente:

  1. Abre la Developers Communications Console.
  2. Selecciona el agente.
  3. En el panel de navegación izquierdo, haga clic en Integraciones.
  4. Para Bot de ayuda, haz clic en Inhabilitar.

Cuando el bot de ayuda está inhabilitado, ya no envía y recibe mensajes para tu agente. Ahora puedes configurar tu agente para manejar el flujo de mensajería.

Configura tu agente para el manejo de mensajes

En esta guía, implementarás un Echo Bot en Google Cloud Platform (GCP) con un webhook diseñado para procesar mensajes de usuarios.

El Echo Bot es una aplicación de muestra que repite los mensajes al usuario. Te permite experimentar con funciones enriquecidas, como las acciones sugeridas y las tarjetas enriquecidas, en una conversación con tu agente. También puedes usar el bot de eco como punto de partida para desarrollar tu agente.

Deberás completar los siguientes pasos:

  • Implementa la muestra de Echo Bot en GCP
  • Configura la URL de webhook para tu cuenta de socio de Business Messages
  • Proporciona información básica sobre tu agente

Al final de esta guía, tu agente estará listo para enviar y recibir mensajes.

Implemente la aplicación web en GCP

Business Messages reenvía los mensajes de los usuarios a un webhook en la infraestructura. En esta guía, implementarás el código fuente de muestra de Echo Bot en un webhook preconfigurado. Si ya tienes una infraestructura web para aprovechar la recepción de mensajes, puedes crear un nuevo webhook en ese servicio web, pero deberás configurar la lógica tú mismo. Consulta Cómo configurar tu webhook de nivel de socio para obtener más información.

Crea un entorno de Cloud

Necesita un entorno de nube para implementar la muestra de Echo Bot.

Para crear un proyecto de GCP como un entorno de nube, sigue estos pasos:

  1. Abre el Selector de proyectos de Google Cloud Console.

    Si nunca creaste un proyecto de Google Cloud, deberás Aceptar las Condiciones del Servicio.

  2. Haz clic en Crear proyecto.

  3. Ingresa un nombre y una ubicación para tu proyecto nuevo

    • El ID del proyecto se genera automáticamente y se muestra debajo del nombre del proyecto.
    • En el campo Ubicación, haz clic en Explorar para mostrar las ubicaciones posibles de tu proyecto. Si no encuentras tu organización de Google Workspace, significa que no accediste con una cuenta de Google Workspace. Puedes crear un proyecto sin una organización, pero algunas funciones son limitadas. Consulta Beneficios del recurso de organización para obtener más información.

  4. Haz clic en Crear.

  5. Haz clic en Menú.

  6. Haga clic en Facturación.

  7. Haz clic en Vincular una cuenta de facturación.

  8. Crea una cuenta de facturación nueva o agrega una existente al proyecto. Consulta las Funciones del programa gratuito de Google Cloud para comprender las opciones de pago.

Implementa la muestra de Echo Bot

  1. Instala la CLI de gcloud Lo utilizará para implementar el código de muestra en Google Cloud.

  2. Descarga y extrae la muestra de Echo Bot (Node.js, Java, Python).

  3. Copia el archivo de credenciales JSON que descargaste en Crea una cuenta de servicio en la carpeta de recursos de la muestra y cambia el nombre de las credenciales a "bm-agent-service-account-credentials.json". La ruta a este archivo de credenciales depende de la muestra que descargaste.

    Node.js

    ./bm-nodejs-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

    Java

    ./bm-java-echo-bot/full_sample/src/main/resources/bm-agent-service-account-credentials.json

    Python

    ./bm-python-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

  4. En una terminal, navega al directorio full_sample de muestra.

  5. Ejecuta los siguientes comandos en una terminal para implementar la muestra:

    Node.js

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID es el ID del proyecto que creaste en Crea un entorno de Cloud. El ID del proyecto se muestra en el panel del proyecto en Google Cloud.

    Java

    gcloud config set project PROJECT_ID
gcloud app create
mvn appengine:deploy

    PROJECT_ID es el ID del proyecto que creaste en Crea un entorno de Cloud. El ID del proyecto se muestra en el panel del proyecto en Google Cloud.

    Python

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID es el ID del proyecto que creaste en Crea un entorno de Cloud. El ID del proyecto se muestra en el panel del proyecto en Google Cloud.

  6. Tome nota de la URL de la aplicación implementada en el resultado del último comando. Esta es la base de tu URL de webhook:

    Deployed service [default] to [https://PROJECT_ID.appspot.com]

Configura tu webhook

Ahora que el bot de Echo está implementado, debes especificar una URL de webhook (que operas) para comenzar a recibir mensajes.

  1. Abre la configuración de la cuenta en la consola para desarrolladores de Business Communications.
  2. Asegúrate de que esté seleccionada la cuenta de socio correcta.
  3. En URL de webhook de Business Messages, haz clic en Configurar.

  4. En URL de extremo de webhook, ingresa la URL de tu aplicación + "/callback".

    Tu extremo tendrá el siguiente formato: "https://PROJECT_ID.appspot.com/callback".

    Este extremo está predefinido en la lógica de la aplicación de la muestra que implementó en GCP.

  5. En Developer Console, haz clic en Verificar.

    Cuando Business Messages verifica tu webhook, se cierra el diálogo.

Para configurar tu webhook con la API de Business Communications, consulta Ejemplo: Actualiza la URL de webhook.

Puedes usar el marco de trabajo de pruebas de Business Messages para probar si tu webhook responde correctamente a las cargas útiles de Business Messages.

Ingresa la información del agente

Proporciona información básica para completar la configuración de tu agente.

  1. Abre la Developers Communications Console.
  2. En el panel de navegación izquierdo, haga clic en Información del agente.

  3. Actualiza los valores como desees o usa las siguientes sugerencias:

    Campo Valor
    Mensaje de bienvenida Le damos la bienvenida a la conversación sobre el eco.
    Política de privacidad https://policies.google.com/privacy

  4. Haz clic en Guardar.

Iniciar la conversación

Para interactuar con Echo Bot, siga estos pasos:

  1. Abre la Developers Communications Console.
  2. En el panel de navegación izquierdo, haga clic en Información del agente.
  3. En Agent test URLs, haz clic en el botón Android o en el botón iOS.

  4. Escanea el código QR con el dispositivo móvil correspondiente o haz clic en Copiar URL de Android o Copiar URL de iOS para copiar la URL de prueba del agente.

    También puedes hacer clic en Enviar para enviar las URL a tu dirección de correo electrónico.

  5. Abre la URL en tu dispositivo móvil. (los dispositivos iOS requieren la app de Google Maps).

El mensaje de bienvenida del agente te saluda. En este punto, puedes interactuar con el Echo Bot. Se repite en los mensajes que le devuelve. Además, puedes enviar atributos enriquecidos mediante el envío de strings específicas: “carrusel”, “tarjeta”, “chips”.

Próximos pasos

Ahora que creaste tu primer agente, obtén más información sobre Business Messages y qué más puedes hacer en la plataforma.