Crea tu primer agente

Requisitos previos

Crea el agente

En esta guía, se explica cómo crear un agente con una aplicación de ejemplo. La muestra proporciona una forma rápida de explorar la funcionalidad de un agente y puede servir como punto de partida para el desarrollo de tu agente. Si deseas modificar una aplicación existente para 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:

  • Regístrate como socio
  • Crea una marca y un agente
  • Opcionalmente, explora las funciones en 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.

Regístrate como socio

  1. Abre la Consola para desarrolladores de Business Communications.
  2. En Business Messages, haz clic en Crear cuenta de socio.

  3. Ingresa la información de tu socio:

    Campo Valor
    Tu nombre Tu 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 Mensajes de Negocios

  4. Revisa y acepta las Condiciones del Servicio de Mensajes de Negocios.

  5. Haz clic en Crear.

Ya te registraste como socio de Business Messages. Se creó un nuevo proyecto de Google Cloud para ti con las APIs de Business Messages y Business Communications habilitadas. No tienes acceso a este proyecto, y no interferirá con ninguno de tus proyectos existentes de Google Cloud.

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

Crea una cuenta de servicio

  1. En la página principal de la Consola para desarrolladores de Business Communications, 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.

    El navegador descarga la clave de la cuenta de servicio. Almacénala en una ubicación segura. Necesitarás esta clave más adelante para implementar una aplicación web y acceder a las APIs 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. Creas una marca para representar la empresa y un agente para que los consumidores puedan conectarse con ella de forma conversacional.

  1. Abre la consola de Business Communications para desarrolladores y accede con tu Cuenta de Google de Business Messages.
  2. Haz clic en Create agent.
  3. En Tipo de agente, selecciona Mensajes de la empresa.
  4. Ingresa los valores de Nombre de la marca y Nombre del agente.
  5. Realiza alguna 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.
    • Para personalizar tu agente y prepararlo para el control de mensajes, anula la selección de 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, continúa con la configuración del agente para el procesamiento de mensajes.

Explora 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 experimentes lo que la plataforma tiene para ofrecer. Habilitar el bot de ayuda es opcional, pero se recomienda hacerlo cuando crees tu primer agente.

El bot de ayuda te permite hacer lo siguiente:

  • Explora los atributos enriquecidos
  • Aprende a implementar funciones
  • Busca recursos para la configuración de agentes

Cuando el bot de ayuda está habilitado, envía y recibe mensajes para tu agente sin necesidad de un webhook. Debes inhabilitar el bot de ayuda antes de poder configurar un webhook o habilitar Dialogflow para controlar los mensajes de los usuarios.

Inicia 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 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 desde este diálogo:

  1. Accede a las URLs de prueba del agente. Puedes hacerlo de las siguientes maneras:

    • Haz clic en el botón Android o 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 para Android o Copiar URL para iOS para copiar la URL de prueba del agente.
    • Haz clic en Enviar para enviar las URLs 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).

Inhabilita el bot de ayuda

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

Para inhabilitar el bot de ayuda, sigue estos pasos:

  1. Abre la Consola para desarrolladores de Business Communications.
  2. Selecciona el agente.
  3. En el menú de navegación de la izquierda, haz clic en Integraciones.
  4. En Bot de ayuda, haz clic en Inhabilitar.

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

Configura tu agente para el procesamiento de mensajes

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

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

Completarás los siguientes pasos:

  • Implementa el ejemplo de Echo Bot en GCP
  • Configura la URL del 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.

Implementa la aplicación web en GCP

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

Crea un entorno de Cloud

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

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

  1. Abre el selector de proyectos de la consola de Google Cloud.

    Si nunca creaste un proyecto de Google Cloud, deberás aceptar los Términos y Condiciones.

  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 aparece debajo del nombre del proyecto.
    • En el campo Ubicación, haz clic en Explorar para mostrar las posibles ubicaciones de tu proyecto. Si no encuentras tu organización de Google Workspace, significa que no accediste a una cuenta de Google Workspace. Puedes crear un proyecto sin una organización, pero algunas funciones están limitadas. Consulta Beneficios del recurso de la 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 usarás 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 de acceso 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 la 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 aparece 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 aparece 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 aparece en el panel del proyecto en Google Cloud.

  6. Observa la URL de la aplicación implementada en el resultado del último comando. Esta es la base de la URL de tu 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 tú operas) para comenzar a recibir mensajes.

  1. Abre la Configuración de la cuenta en Business Communications Developer Console.
  2. Asegúrate de que esté seleccionada la cuenta de socio correcta.
  3. En URL de webhook de Mensajes de Negocios, haz clic en Configurar.

  4. En Webhook endpoint URL, ingresa la URL de tu aplicación y agrega "/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 implementaste en GCP.

  5. En la consola de Google Developers, haz clic en Verificar.

    Cuando Mensajes de la Empresa verifique tu webhook, se cerrará el diálogo.

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

Puedes usar el framework de pruebas de Mensajes de Negocios para probar si tu webhook responde correctamente a las cargas útiles de Mensajes de Negocios.

Ingresa la información del agente

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

  1. Abre la Consola para desarrolladores de Business Communications.
  2. En el panel de navegación izquierdo, haz clic en Información del agente.

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

    Campo Valor
    Mensaje de bienvenida ¡Te damos la bienvenida a la conversación con Echo Bot!
    Política de Privacidad https://policies.google.com/privacy

  4. Haz clic en Guardar.

Iniciar la conversación

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

  1. Abre la Consola para desarrolladores de Business Communications.
  2. En el panel de navegación izquierdo, haz clic en Información del agente.
  3. En URLs de prueba del agente, haz clic en el botón Android o 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 URLs 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).

Aparecerá el mensaje de bienvenida del agente. En este punto, puedes interactuar con el bot de eco. Repite los mensajes que le envías. Además, puedes invocar funciones enriquecidas enviando cadenas específicas: "carrusel", "tarjeta" y "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.