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 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
  • De forma opcional, explora las funciones en una conversación con Business Messages bot de ayuda
  • 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 el Consola para desarrolladores de Business Communications.
  2. En Business Messages, haz clic en Crear cuenta de socio.

  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 quieres alojar el servicio de Business Messages

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

  5. Haz clic en Crear.

Ahora 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 de Google Cloud existentes.

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 Partner account settings.
  2. En el panel de navegación de la izquierda, haz clic Cuenta de servicio.

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

    Tu navegador descarga la clave de la cuenta de servicio. Guárdalo en un ubicación. 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 las que interactúan los usuarios. Creas una marca para representar a la empresa y crear un agente para que los consumidores puedan conectarse con él mediante conversaciones.

  1. Abre la página de desarrollador de comunicaciones empresariales. Consola y accede con tu Cuenta de Google de Business Messages.
  2. Haz clic en Create Agent.
  3. En Tipo de agente, selecciona Business Messages.
  4. Ingresa los valores para Brand name y Agent name.
  5. Realiza alguna de las siguientes acciones:
    • Para tener una conversación con tu agente en la que puedas explorar funciones disponibles, selecciona Habilitar el bot de ayuda de Business Messages.
    • Para personalizar tu agente y prepararlo para el manejo de mensajes, anula la selección de Habilita 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 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 para que puedas experimentar lo que ofrece la plataforma. Cómo habilitar el asistente El bot es opcional, pero se recomienda cuando crees tu primer agente.

El bot de ayuda te permite hacer lo siguiente:

  • Explora las funciones enriquecidas
  • Aprende a implementar funciones
  • Busca 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 un webhook. Debes inhabilitar el bot de ayuda. para que puedas configurar un webhook o habilitar Dialogflow para manejar los mensajes de los usuarios.

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 diálogo inmediatamente después de que se cree el 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 de Android o en el de iOS. Luego, escanea el código QR con el dispositivo móvil correspondiente y haga clic en Iniciar. De manera 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 URLs a tu dirección de correo electrónico.

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

Inhabilitar el bot de ayuda

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

Para inhabilitar el bot de ayuda, sigue estos pasos:

  1. Abre la página de desarrollador de comunicaciones empresariales. Consola.
  2. Selecciona el agente.
  3. En el panel de navegación izquierdo, 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 flujo de mensajes.

Configura tu agente para el control de mensajes

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

Echo Bot es una aplicación de ejemplo que repite mensajes al usuario. Integra 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 para desarrollar tu agente.

Completarás los siguientes pasos:

  • Implementa la muestra de Echo Bot en GCP
  • Cómo configurar 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.

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 la muestra de Echo Bot el código fuente en un webhook preconfigurado. Si ya tienes infraestructura web para aprovechar para recibir mensajes, puedes crear un webhook nuevo en esa servicio, pero tendrás que configurar la lógica tú mismo. Consulta Configura tu webhook a nivel de socio para conocer los detalles.

Crea un entorno en la nube

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 las Condiciones y los Servicios.

  2. Haz clic en Crear proyecto.

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

    • 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 puedes encontrar 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 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 nueva cuenta de facturación o agrega una existente al proyecto. Consulta 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á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 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 hasta el 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. Toma nota de 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 se implementó Echo Bot, debes especificar una URL de webhook (que operar) para comenzar recibir mensajes.

  1. Abre el Configuración de la cuenta en la Consola para desarrolladores de Business Communications.
  2. Asegúrate de que se haya seleccionado 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 y “/devolución de llamada”.

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

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

  5. En Play Console, haz clic en Verificar.

    Cuando Business Messages verifique tu webhook, se cerrará 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 prueba 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 página de desarrollador de comunicaciones empresariales. Consola.
  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 sobre Echo Bot.
    Política de Privacidad https://policies.google.com/privacy

  4. Haz clic en Guardar.

Iniciar la conversación

Para interactuar con el Echo Bot, sigue estos pasos:

  1. Abre la página de desarrollador de comunicaciones empresariales. Consola.
  2. En el panel de navegación izquierdo, haz clic en Información del agente.
  3. En URL 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 el Google Maps).

El mensaje de bienvenida del agente te saluda. En este punto, puedes interactuar con el Echo Bot. Repite los mensajes que te envías. Además, puedes invocar funciones enriquecidas mediante el envío de cadenas 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.