Búsquedas recientes


No hay búsquedas recientes

James Rodewig's Avatar

James Rodewig

Incorporación 25 mar 2022

·

Última actividad 16 may 2023

Zendesk Documentation Team

Seguimientos

0

Seguidores

0

Actividad total

81

Voto

1

Suscripciones

40

RESUMEN DE LA ACTIVIDAD

Última actividad de James Rodewig

James Rodewig creó un artículo,

ArtículoMejores prácticas de bots y automatización
Disponible en los planes Suite Enterprise y superiores
Este artículo describe la funcionalidad disponible solo para los clientes que tenían un agente IA en borrador o publicado el 2 de febrero de 2025. Si desea información acerca de la funcionalidad equivalente en el complemento Agentes IA – Avanzado, consulte Creación de diálogos para Agentes IA – Avanzado.
El paso Agregar condición de horario comercial del generador de bots le permite ramificar las respuestas de un agente IA de acuerdo con su horario comercial. Sin embargo, no puede ramificar una conversación en función de la disponibilidad del agente.

En esta receta, usará los pasos del generador de bots Hacer llamada de API y Ramificar por condición para ramificar una respuesta del agente IA existente en función del número de agentes conectados en el momento de la conversación. El paso Hacer llamada de API obtiene un recuento de los agentes conectados actualmente. Para ello, llama al extremo Get Agent Status Count de la API de REST de Chat en tiempo real de Zendesk. Luego el paso Ramificar por condición utiliza el recuento para ramificar el flujo de respuesta.

Esta configuración se puede usar para enviar mensajes personalizados del agente IA antes de crear un ticket con el paso Transferir a agente. Estos mensajes pueden ayudar a establecer mejores expectativas en los clientes en lo que respecta a los tiempos de espera y de respuesta.

Tarea 1: Verificar la configuración

Para completar esta receta, se necesita lo siguiente:

Tarea 2: Crear una conexión de API

Para comenzar, cree una conexión de API para guardar el token de acceso de OAuth para la API de Chat. Su agente IA puede usar esta conexión para autenticar las llamadas a la API.

Para crear la conexión
  1. En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione Conexiones > Conexiones.
  2. Haga clic en Crear conexión.
  3. Seleccione el tipo de autenticación Token de portador.
  4. En Nombre de la conexión, ingrese "zendesk_chat_api_oauth_token".
  5. En Token, ingrese el token de acceso de OAuth (consulte Tarea 1: Verificar la configuración).
  6. En Dominio permitido, ingrese "rtm.zopim.com".
  7. Haga clic en Guardar para crear la conexión.

Tarea 3: Obtener la disponibilidad del agente

Luego agregue el paso Hacer llamada de API a una respuesta existente en el agente IA. Este paso obtiene un recuento actualizado de los agentes conectados del extremo Get Agent Status Count de la API de Chat en tiempo real.

Para agregar el paso Hacer llamada de API

  1. En el Centro de administración, haga clic en Canales en la barra lateral y luego seleccione Agentes IA y automatización > Agentes IA.
  2. Haga clic en Administrar agentes IA para mensajería.
  3. Haga clic en el agente IA que desea actualizar y luego en la respuesta que desea actualizar.
  4. En el generador de bots, agregue un paso en el lugar deseado en el flujo de respuesta.
  5. Bajo Elegir paso, seleccione Hacer llamada de API.
  6. Escriba Obtener disponibilidad del agente como Nombre.
  7. En Detalles de la API, ingrese https://rtm.zopim.com/stream/agents/agents_online como URL de extremo.
  8. En Autenticación, seleccione la conexión zendesk_chat_api_oauth_token.
  9. Para probar la solicitud de API, haga clic en Hacer llamada de API.
  10. Bajo Datos de prueba, ingrese Melbourne, AU como Ubicación.
  11. Haga clic en Hacer llamada de API
  12. Guarde la siguiente variable usando su nombre predeterminado:
    • content > data > agents_online
  13. (Opcional) Agregue un paso en la rama Error de llamada de API del paso Obtener disponibilidad del agente. Este paso se ejecuta si falla la solicitud Get Agent Status Count.

Tarea 4: Ramificar según la disponibilidad del agente

Ahora agregue un paso Ramificar por condición para ramificar el flujo de respuesta según el valor de la variable agents_online.

Para agregar un paso Ramificar por condición

  1. En el generador de bots, agregue un paso en la rama La llamada a la API se realizó correctamente del paso Obtener disponibilidad del agente.
  2. Bajo Elegir paso, seleccione Ramificar por condición.
  3. Escriba Obtener disponibilidad del agente como Nombre.
  4. En la rama Si cumple, ingrese Agentes conectados como Nombre.
  5. En la rama Si cumple, haga clic en Agregar condición. Configure la condición de esta manera:
    • Variable: agents_online
    • Operador: No es
    • Valor: 0
  6. Haga clic en Agregar.
  7. Agregue cualquier paso deseado bajo las ramas Agentes conectados y Si no. Los pasos de la rama Agentes conectados se ejecutan cuando la solicitud Get Agent Status Count indica que hay uno o más agentes conectados. Los pasos de la rama Si no se ejecutan cuando la solicitud indica que no hay agentes conectados.

Tarea 5: Publicar el agente IA actualizado

Cuando termine de editar la respuesta, puede publicar el agente IA actualizado.

Para publicar el agente IA
  1. Haga clic en Terminado en la esquina superior derecha del generador de bots.
  2. En la página del agente IA, haga clic en Publicar agente IA.
  3. Haga clic en Publicar.

Tarea 6: Probar los cambios

Después de publicar los cambios, puede probar la respuesta actualizada usando una de sus frases de entrenamiento en una conversación con el agente IA actualizado. Si desea más información sobre cómo probar los agentes IA, consulte Pruebas de la experiencia de mensajería del usuario final.

Editado 20 feb 2025 · James Rodewig

2

Seguidores

1

Voto

0

Comentarios


James Rodewig hizo un comentario,

Comentario de la comunidad Developer - Zendesk APIs

Hi Agave,

I'm sorry to hear you ran into this issue.

The Leads endpoints are part of the Sales CRM API. The Sales CRM API use the following base URL for their endpoints: https://api.getbase.com

We call that out in the Sales CRM API intro docs, but it's easy to miss.

I hope that helps!

Ver comentario · Editado 19 abr 2023 · James Rodewig

0

Seguidores

0

Votos

0

Comentarios


James Rodewig hizo un comentario,

ComentarioSelf-service best practices and recipes

Hi Tony,

There's a column for Field ID on the Fields page.


When you create the Help Article URL field, Zendesk will automatically send you to this page. Otherwise, you can find the page at the following URL:

https://{your-subdomain}.zendesk.com/admin/objects-rules/tickets/ticket-fields

In the URL, replace {your-subdomain} with your Zendesk subdomain.

I hope that helps!

Ver comentario · Editado 10 abr 2023 · James Rodewig

0

Seguidores

1

Voto

0

Comentarios


James Rodewig hizo un comentario,

Comentario de la comunidad Developer - Zendesk Apps Framework (ZAF)

If it helps, the following tutorial shows how you can use secure settings to pass an OpenAI API token:

Using AI to summarize conversations in a Support app

 

I hope that helps!

Ver comentario · Publicado 10 abr 2023 · James Rodewig

0

Seguidores

0

Votos

0

Comentarios


James Rodewig hizo un comentario,

Comentario de la comunidad Developer - Zendesk APIs

Hi Nishaant,

Thanks for reaching out.

The Using OAuth to authenticate Zendesk API requests in a web app article is currently misleading about this. I apologize for the error (it was my mistake), and I'm working on fixing it now. In the meantime, I hope this information is helpful.

By default, OAuth clients are scoped to one Zendesk subdomain. You can only use the client to create OAuth flows on behalf of users who are on the same subdomain used to create the client.

If you're creating an app that serves users on multiple Zendesk subdomains, you'll need to request a global OAuth client. In this case, you'd need some mechanism to capture the user's subdomain. When a user signs in to Zendesk, they must sign into a specific Zendesk subdomain.

I hope that helps!

Ver comentario · Publicado 04 abr 2023 · James Rodewig

0

Seguidores

0

Votos

0

Comentarios


James Rodewig hizo un comentario,

Comentario de la comunidad Developer - Zendesk APIs

Hi Eric,

Thank you for the feedback. I work on our docs. I agree with you that these docs could be clearer and tighter.


I can't guarantee a timeline, but I'll work on this.

Thanks again for raising this. Please let us know if there's anything else we can do to improve our docs.

Ver comentario · Publicado 04 abr 2023 · James Rodewig

0

Seguidores

1

Voto

0

Comentarios


James Rodewig creó un artículo,

ArtículoUso de agentes IA - Esencial

Disponible en todos los planes de Zendesk Suite

Este artículo describe la funcionalidad disponible solo para los clientes que tenían un agente IA en borrador o publicado el 2 de febrero de 2025. Si desea información acerca de la funcionalidad equivalente en el complemento Agentes IA – Avanzado, consulte Creación de diálogos para Agentes IA – Avanzado.
El paso Mostrar artículos del centro de ayuda del generador de bots recomienda artículos específicos del centro de ayuda a los clientes, que podrían servirles para resolver sus propias preguntas. Si tiene artículos públicos y restringidos en el centro de ayuda, puede configurar qué artículos se pueden mostrar a los usuarios finales anónimos (no autenticados) y cuáles se deben mostrar a los usuarios finales autenticados.

Las sugerencias de artículos restringidos del centro de ayuda en una respuesta del agente IA están disponibles en todos los planes que pueden usar la mensajería.

Este artículo contiene los siguientes temas:

Información general sobre los artículos restringidos del centro de ayuda

Hay tres casos de uso para los agentes IA y los artículos:
  • El agente IA atiende las consultas de los usuarios anónimos y comparte artículos públicos del centro de ayuda.
  • El agente IA atiende las consultas de los usuarios autenticados y comparte artículos restringidos del centro de ayuda.
  • El agente IA atiende las consultas de los usuarios anónimos y los autenticados, crea condiciones en función de si el usuario está autenticado y muestra todos los artículos a los usuarios autenticados y solo los artículos públicos a los usuarios no autenticados.

La autenticación se basa en la autenticación de mensajería con JWT.

Si el usuario final está autenticado con un Token Web JSON (JWT) de mensajería, nosotros verificaremos si puede acceder al artículo según las reglas de permiso del artículo y el segmento de usuarios al que pertenece. Si el usuario final tiene acceso, se mostrará una vista previa del artículo. Solo se mostrará el marcador de posición de la vista previa si el usuario final no pertenece al segmento de usuarios.

Si el usuario final es anónimo o fue autenticado a través del SSO o la autenticación de Zendesk, el mensaje del agente IA muestra el vínculo al artículo, pero no el título ni la vista previa.

Cuando el usuario final hace clic en el vínculo al artículo restringido, se le redirige a Guide, donde debe iniciar sesión. Para que el usuario final pueda ver el artículo restringido, necesita tener una cuenta en su sistema de ayuda y, además, los permisos de usuario de Guide.
Nota: Si el permiso del artículo se actualiza de público a restringido o de restringido a público, habrá una breve demora antes de que los usuarios finales vean el cambio de permiso.

Mostrar el título de los artículos restringidos del centro de ayuda

De manera predeterminada, no se muestran los títulos ni las vistas previas de los artículos restringidos del centro de ayuda a los usuarios no autenticados con JWT de mensajería. Solo se muestra el vínculo.

Sin embargo, si lo desea, puede configurar su agente IA para que muestre el título y la vista previa de los artículos restringidos del centro de ayuda a todos los usuarios, independientemente del método de autenticación que se haya usado o de si son anónimos.

Nota: Antes de configurar el agente IA para que muestre los títulos restringidos, es necesario que configure la autenticación de los usuarios finales para la mensajería.
Para mostrar siempre el título de los artículos restringidos del centro de ayuda
  1. En el Centro de administración, haga clic en Canales en la barra lateral y luego seleccione Agentes IA y automatización > Agentes IA.
  2. Haga clic en Administrar agentes IA para mensajería.
  3. Haga clic en el agente IA con el que desea trabajar.
  4. Amplíe la configuración de Canales y seleccione Mostrar siempre el título y la vista previa para los artículos restringidos. Esta opción está visible solo si el centro de ayuda está activo. Solo los agentes que tienen permisos de administrador de Guide pueden configurar esta opción.

Buscar artículos restringidos del centro de ayuda

El paso Mostrar artículos del centro de ayuda recomienda artículos específicos a los clientes, que podrían servirles para resolver sus preguntas sin ayuda. Presenta hasta seis artículos del centro de ayuda al cliente durante una conversación.

Es necesario tener un centro de ayuda activo para poder usar este paso.

Si tiene acceso de visualización a un artículo restringido, puede agregar ese artículo al generador de bots y ver la vista previa del artículo. El artículo no aparecerá en los resultados de las búsquedas del generador de bots si usted no tiene acceso de visualización. Si, por ejemplo, un administrador de Guide agrega un artículo restringido y usted no tiene acceso de visualización para ese artículo, el artículo aparecerá como restringido para usted en el generador de bots.

Editado 20 feb 2025 · James Rodewig

0

Seguidores

1

Voto

0

Comentarios


James Rodewig creó un artículo,

ArtículoUso de agentes IA - Esencial

Disponible en todos los planes de Zendesk Suite

Este artículo describe la funcionalidad disponible solo para los clientes que tenían un agente IA en borrador o publicado el 2 de febrero de 2025. Si desea información acerca de la funcionalidad equivalente en el complemento Agentes IA – Avanzado, consulte Creación de diálogos para Agentes IA – Avanzado.

En el generador de bots, una variable es un contenedor para los datos relacionados con una conversación, como el nombre de un cliente o la ID del pedido de una tienda. Durante una conversación, un agente IA para mensajería puede utilizar las variables de maneras como las siguientes (por poner solo unos ejemplos):

  • Insertadas en los mensajes del agente IA para personalizar las respuestas de texto, mostrar imágenes e información dinámica o ramificar la conversación.
  • Para establecer un valor para una variable en función de lo que introduce un usuario final.
  • En las etiquetas que se agregan a los tickets durante el paso Transferir a agente.

Un agente IA puede incluir hasta 46 variables únicas en todas las respuestas. Cada variable única se puede usar en una respuesta todas las veces que sea necesario.

Acerca de los nombres y valores de las variables

En el generador de bots, cada variable tiene un nombre y un valor. Cuando se configura un paso en una respuesta, el nombre actúa como marcador de posición para el valor. Cuando el agente IA ejecuta la respuesta, reemplaza el nombre de la variable por el valor de la variable. Por ejemplo, puede usar una variable llamada Correo electrónico como marcador de posición para la dirección de correo electrónico del cliente.

Nota: Solo los primeros 280 caracteres del valor de una variable aparecen en la respuesta que se muestra en la conversación de mensajería.

Dentro de un agente IA, las variables son globales. Una vez creadas, están disponibles en todas las respuestas subsiguientes en la conversación del usuario final, ya sea en forma de texto libre o a través del paso Vincular a otra respuesta.

Qué pasa con las variables vacías

Una variable está vacía si no tiene valor, y los agentes IA omiten las variables vacías durante una conversación.

Supongamos que, por ejemplo, un paso Enviar mensaje incluye un mensaje del agente IA que dice "El estado del envío de su paquete es shipping_status". Si la variable shipping_status está vacía durante una conversación, el mensaje que envía el agente IA sería "El estado del envío de su paquete es ."

Mensaje del agente IA Vista del cliente

Tratar las variables que faltan

En el paso Hacer llamada de API, si falta una de las variables guardadas de la respuesta, se gatilla la rama Desaprobar del paso. Consulte Uso del paso Hacer llamada de API en un agente IA para mensajería (heredado).

Acerca de los tipos de variables

El generador de bots organiza las variables según cómo se crean y los datos que guardan. Estos son los tipos:

Variables de cliente

Las variables de cliente guardan la información que el cliente proporciona durante un paso Solicitar detalles, como su nombre y su dirección de correo electrónico.

Cuando se inserta una variable en un paso a través del icono Agregar una variable (), las variables de cliente aparecen bajo Respuestas del cliente.

Variables de servicio externo

Las variables de servicio externo guardan la información recibida de un sistema externo durante un paso Hacer llamada de API. Por ejemplo, el paso puede hacer una solicitud de API de REST a una empresa de servicios de envíos para obtener el estado actual de un paquete.

Los administradores crean variables de servicio externo cuando configuran el paso Hacer llamada de API. Como parte de la configuración, el administrador puede definir un nombre personalizado para cada variable.

Cuando se inserta una variable en un paso a través del icono Agregar una variable (), las variables de servicio externo aparecen bajo Respuestas del servicio externo.

Variables de metadatos de mensajería

Las variables de metadatos de mensajería contienen información sobre la identidad de un cliente y su estado de autenticación. Las variables de metadatos de mensajería obtienen sus valores de los Tokens Web JSON (JWT) firmados que se utilizan para la autenticación de la mensajería.

Las variables de metadatos de mensajería no están activadas de manera predeterminada y solo están disponibles para el Web Widget y los canales de SDK para móviles. Si desea más información sobre cómo activar y usar las variables de metadatos de mensajería, consulte Uso de metadatos de autenticación en una respuesta del agente IA.

Si están activadas, las variables de metadatos de mensajería aparecen bajo Metadatos de mensajería cuando se inserta una variable en un paso con el icono Agregar una variable ().

Variables de Sunshine Conversations

Las variables de Sunshine Conversations se pueden usar para conectar las integraciones de Sunshine Conversations.

Las variables disponibles incluyen las siguientes:

Usar variables en una respuesta

Personalizar los mensajes del agente IA

Los administradores pueden insertar variables en distintos tipos de pasos del mensaje del agente IA, como estos: El siguiente mensaje del agente IA, por ejemplo, incluye la variable Nombre.

Enviar datos a sistemas externos

Al hacer una llamada de API de REST a un sistema externo mediante el paso Hacer llamada de API, los administradores pueden insertar variables en la ruta y la cadena de consulta del campoURL de extremo del paso. Si desea más información, consulte Utilización del paso Hacer llamada de API en el generador de bots.

Ramificar el flujo de una respuesta

El paso Ramificar por condición le permite a un administrador ramificar el flujo de una respuesta en función del valor de una o más variables. Si desea más información, consulte Comprender las condiciones de ramificación.
Nota: Los campos de ticket desplegables personalizados usan el valor Etiqueta como valor de la variable.

Establecer los valores de las variables

Los administradores pueden usar el paso Configurar variables para crear una nueva variable y asignarle un valor, o para seleccionar una variable existente y sobrescribir su valor en función de las acciones que realiza un usuario final en una conversación. Se puede hacer referencia a las variables en todas las respuestas del agente IA.

Consulte Comprender los tipos de pasos de respuesta: Configurar variables si desea ver los detalles del uso.

Usar variables en las etiquetas

Los administradores pueden usar variables en las etiquetas que se agregan a un ticket creado como parte del paso Transferir a agente. Los agentes pueden usar estas etiquetas para ver, organizar y hacer seguimiento de los tickets, y en acciones automatizadas, como el desvío de tickets y otras reglas de negocio.

Aunque desde el punto de vista técnico son parte de una respuesta, las variables en las etiquetas están sujetas a reglas y restricciones, lo que no sucede con otras variables.

Se pueden usar variables generadas por las llamadas de API y otras variables del sistema. Las variables disponibles aparecen en el menú desplegable de selección:

Sin embargo, las variables que contienen información introducida por los usuarios finales no pueden usarse en las etiquetas. Aparecerán en la lista desplegable, pero estarán desactivadas. Por ejemplo, no es posible hacer referencia a una variable usando la información recopilada en el paso Solicitar detalles anteriormente en una conversación.

Las siguientes reglas y recomendaciones se aplican al uso de variables en las etiquetas:

Límite de caracteres

  • Las etiquetas con codificación fija tienen un límite de 80 caracteres cada una.

Caracteres especiales

  • Las variables que contienen los siguientes caracteres especiales no pueden usarse y no aparecerán en la lista de variables disponibles: £, `, ´, \, [, ], {, }, (, ), <, >, %, &, ?, +, @, !, *, $, #, = y "
  • Los espacios y las comas que se usen en las variables aparecerán como caracteres de subrayado en las etiquetas.

Además, recomendamos las siguientes mejores prácticas cuando se usan variables como etiquetas:

  • Las etiquetas suelen usarse para el desvío de conversaciones o en las condiciones de los disparadores. Si desea agregar información a los tickets para proporcionar contexto a los agentes, se recomienda usar campos personalizados.
  • Limite el número de posibles valores para una variable. Demasiados valores pueden ocasionar comportamientos inesperados.
  • Asegúrese de que las opciones de valores sean cortas para evitar que se trunquen como etiquetas.
  • No use caracteres especiales en los valores.

Editado 20 feb 2025 · James Rodewig

0

Seguidores

2

Votos

2

Comentarios


James Rodewig hizo un comentario,

Comentario de la comunidad Q&A - AI and automation

You may be interested in this app tutorial: Using AI to summarize conversations in a Support app

The tutorial explains how you can use the Zendesk Apps framework (ZAF) to extend Zendesk using GPT-3 and the OpenAI API. You can use the tutorial as a starting point for building your own apps and integrations.

Ver comentario · Publicado 28 feb 2023 · James Rodewig

0

Seguidores

2

Votos

0

Comentarios


James Rodewig creó un artículo,

ArtículoMejores prácticas de bots y automatización
Este artículo describe la funcionalidad disponible solo para los clientes que tenían un agente IA en borrador o publicado el 2 de febrero de 2025. Si desea información acerca de la funcionalidad equivalente en el complemento Agentes IA – Avanzado, consulte Creación de diálogos para Agentes IA – Avanzado.
El paso Hacer llamada de API permite que un agente IA para mensajería utilice una solicitud de API de REST para extraer datos de un sistema externo como Shopify o Salesforce.

Esta receta sirve de guía para crear una respuesta del agente IA encargada de extraer información meteorológica para un lugar proporcionado por el usuario final. La respuesta obtiene los datos de la API de OpenWeather. El flujo de respuesta creado con esta receta se puede usar como un punto de partida para crear sus propias respuestas impulsadas por la API.

La receta incluye las siguientes tareas:
Nota: Zendesk ofrece este artículo con fines de instrucción únicamente. Zendesk no ofrece soporte para los ejemplos presentados en este artículo, ni tampoco para las tecnologías de terceros, como la API de OpenWeather.

Tarea 1: Verificar la configuración

Para completar esta receta, se necesita lo siguiente:

  • Una cuenta de Zendesk con un agente IA para mensajería publicado. Puede usar un entorno de pruebas de sandbox para probar el agente IA antes de usarlo en producción.

    Para configurar un agente IA en un canal de mensajería por web y móvil, consulte Creación de un agente IA para los canales web y móvil. Si desea información sobre cómo usar la mensajería en un entorno de sandbox, consulte Uso de la mensajería en un sandbox.

  • Una clave de API para una cuenta de OpenWeather. La API que se usa en esta receta está disponible en el plan gratuito de OpenWeather.

    Para registrarse para una cuenta gratis de OpenWeather, consulte la página Create New Account (Crear nueva cuenta) del sitio web openweathermap.org. Después de iniciar sesión, puede obtener una clave de API en la página de su cuenta de OpenWeather.

    Para activar las claves de API de OpenWeather, debe verificar la dirección de correo electrónico de su cuenta. Después de la verificación, las claves de API pueden demorar hasta dos horas para activarse. Si desea más información, consulte las preguntas frecuentes en openweathermap.org.

Tarea 2: Crear una conexión de API

Para comenzar, cree una conexión de API para guardar su clave de API de OpenWeather. Su agente IA puede usar esta conexión para autenticar las llamadas a la API de OpenWeather.

Para crear la conexión
  1. En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione Conexiones > Conexiones.
  2. Haga clic en Crear conexión.
  3. Seleccione el tipo de autenticación Clave API.
  4. Ingrese openweather_api_key como el Nombre de la conexión.
  5. Ingrese x-api-key como el Nombre del encabezado.
  6. Ingrese la clave de API de OpenWeather como el Valor.
  7. Ingrese api.openweathermap.org como el Dominio permitido.
  8. Haga clic en Guardar para crear la conexión.

Tarea 3: Crear un campo de ticket personalizado

Luego cree un campo de ticket personalizado para capturar la ubicación proporcionada por el usuario final.

Para crear el campo de ticket personalizado
  1. En el Centro de administración, haga clic en Objetos y reglas en la barra lateral y luego seleccione Tickets > Campos.
  2. Haga clic en Agregar campo.
  3. Seleccione el tipo de campo Texto.

  4. Ingrese Ubicación como el Nombre mostrado.
  5. Bajo Permisos, seleccione Los clientes pueden editar.
  6. Bajo Clientes, ingrese Ubicación como el Título mostrado a los clientes.
  7. Haga clic en Guardar.

Si su cuenta usa un solo formulario de ticket, el campo nuevo aparece automáticamente en el formulario de ticket. Para eliminar el campo, consulte Editar formularios de ticket.

Tarea 4: Elaborar una respuesta de agente IA

Paso 1: Crear la respuesta

Utilice el generador de bots para crear una respuesta para su agente IA.

Para crear la respuesta
  1. En el Centro de administración, haga clic en Canales en la barra lateral y luego seleccione Agentes IA y automatización > Agentes IA.
  2. Haga clic en Administrar agentes IA para mensajería.
  3. Haga clic en el agente IA con el que desea trabajar.
  4. En la pestaña Respuestas, haga clic en Crear respuesta.

Paso 2: Definir la intención de la respuesta

Defina la intención de la respuesta y las frases de entrenamiento. Aquí se incluyen frases y palabras que se usan para gatillar la respuesta en una conversación.

Para definir la intención de la respuesta
  1. En la pestaña Respuestas de la página de edición del agente IA, haga clic en Crear respuesta.
  2. Haga clic en Cree su propia respuesta y luego en Siguiente.
  3. Ingrese Obtener tiempo como la Intención de la respuesta.
  4. Bajo Frases de entrenamiento, ingrese Obtener pronóstico del tiempo y Obtener temperatura actual.
  5. Haga clic en Siguiente.

    La respuesta se abre en el generador de bots, donde se puede desarrollar la respuesta.

Paso 3: Agregar un paso de mensaje inicial

Agregue un paso Enviar mensaje para solicitar al usuario final la ubicación que le interesa. Este es el primer paso en el flujo de respuesta.

Para agregar un paso de mensaje inicial
  1. En el generador de bots, haga clic en Agregar paso.
  2. Bajo Elegir paso, seleccione Enviar mensaje.
  3. En Mensaje del agente IA, ingrese el siguiente texto:
    
            What location would you like to get the weather for?
    
    Include the country code. For example: "Melbourne, AU" or  "San Francisco, US"
           

Paso 4: Solicitar una ubicación al usuario final

Después del mensaje inicial, agregue un paso Solicitar detalles para presentar un formulario básico al usuario final. El formulario incluye un cuadro de texto para el valor del campo de ticket Ubicación.

Para agregar un paso Solicitar detalles
  1. En el generador de bots, haga clic en el icono Agregar paso ().
  2. Bajo Elegir paso, seleccione Solicitar detalles.
  3. Ingrese Obtener ubicación como el Nombre.
  4. En Campos, escriba y seleccione el campo de ticket Ubicación.

Paso 5: Obtener información meteorológica para la ubicación

Agregue un paso Hacer llamada de API para obtener la información meteorológica del extremo Current weather data de la API de OpenWeather.

Para agregar un paso Hacer llamada de API
  1. En el generador de bots, haga clic en Agregar paso.
  2. Bajo Elegir paso, seleccione Hacer llamada de API.
  3. Ingrese Obtener tiempo como el Nombre de la respuesta.
  4. Bajo Detalles de la API, ingrese https://api.openweathermap.org/data/2.5/weather?units=metric&q= como URL de extremo.
  5. Use el icono Agregar una variable () para adjuntar la variable del campo Ubicación al valor de URL de extremo.

    El valor terminado de URL de extremo se debería ver así:

  6. En Autenticación, seleccione la conexión openweather_api.
  7. Para probar la solicitud de API, haga clic en Hacer llamada de API.
  8. Bajo Datos de prueba, ingrese Melbourne, AU como Ubicación.
  9. Haga clic en Hacer llamada de API
  10. Guarde las siguientes variables usando sus nombres predeterminados:
    • main > temp
    • weather > item 1 > description

Paso 6: Enviar un mensaje sobre el tiempo al usuario final

Después de obtener la información meteorológica, use un paso Enviar mensaje para enviársela al cliente.

Para agregar un mensaje de éxito de API
  1. En el generador de bots, haga clic en Agregar paso bajo la rama La llamada a la API se realizó correctamente del paso Obtener tiempo.
  2. Bajo Elegir paso, seleccione Enviar mensaje.
  3. En Mensaje del agente IA, ingrese el siguiente texto:
    
            It's {{temp}}° C with {{description}} in
           
  4. Use el icono Agregar una variable () para adjuntar la variable del campo Ubicación al valor de Mensaje del agente IA. Luego agregue un punto (.).

    El valor terminado de Mensaje del agente IA se debería ver así:

Paso 7: Agregar un mensaje de falla

La solicitud hecha durante el paso Hacer llamada de API puede fallar si, por ejemplo, la solicitud incluye una ubicación que no existe. Agregue un paso Enviar mensaje a la rama Error de llamada de API. Este paso devuelve un mensaje en caso de que la llamada de API de OpenWeather llegue a fallar.

Para agregar un mensaje de falla de la API
  1. En el generador de bots, haga clic en Agregar paso bajo la rama Error de llamada de API del paso Obtener tiempo.
  2. Bajo Elegir paso, seleccione Enviar mensaje.
  3. En Mensaje del agente IA, ingrese el siguiente texto:
    
            I'm sorry. I wasn't able to get weather data for
           
  4. Use el icono Agregar una variable () para adjuntar la variable del campo Ubicación al valor de Mensaje del agente IA. Luego agregue un punto (.).

    El valor terminado de Mensaje del agente IA se debería ver así:

Paso 8: Publicar el agente IA actualizado

Para hacer push de la respuesta en vivo, publique el agente IA actualizado.

Para publicar el agente IA
  1. Haga clic en Terminado en la esquina superior derecha del generador de bots.
  2. En la página del agente IA, haga clic en Publicar agente IA.
  3. Haga clic en Publicar.

Tarea 5: Probar los cambios

Después de publicar los cambios, puede probar la nueva respuesta haciendo la pregunta “¿Cómo está el tiempo?” en una conversación con el agente IA actualizado. Si desea más información sobre cómo probar los agentes IA para mensajería, consulte Pruebas de la experiencia de mensajería del usuario final.

Editado 20 feb 2025 · James Rodewig

4

Seguidores

1

Voto

0

Comentarios