Acción API personalizada

La acción de API personalizada permite a su agente de IA en Social Intents consultar API externas y mostrar el resultado directamente en la conversación. Esto permite realizar búsquedas, actualizaciones o acciones en tiempo real activadas por el usuario, como comprobar el estado del pedido, extraer datos de la cuenta o enviar un formulario.

Configuración de la acción personalizada de solicitud de la API meteorológica

General

  • Nombre de la acción: Proporcione un nombre descriptivo como obtener_tiempo o actualizar_suscripción.
  • Cuándo utilizar: Describa cuándo debe activarse esta acción de la API. Incluya frases de ejemplo que la IA deba reconocer y qué tipo de información proporciona la API como respuesta.

Configuración API

  • Tipo de acción: Llamada a la API
  • Nombre de la acción: Un nombre descriptivo como get_weather
  • Cuándo utilizarlo: Ejemplo: "Esta acción se activa cuando un visitante pregunta por el tiempo en cualquier ciudad".
  • Respuesta desencadenada: Ejemplo: "Claro, déjame que te busque el tiempo".
  • Recoge las entradas de datos para la acción: Cualquier parámetro en la solicitud como ciudad, o apiKey
  • Solicitud API: La URL del punto final, utilizando variables si es necesario (p. ej. https://api.openweathermap.org/data/2.5/weather?q={{city}}&appid={{apikey}}&units=imperial).
  • Método API: Elija GET, POST, PUT o DELETE.

Solicitud de API de acción personalizada AI

Ejemplos de casos prácticos

Actualizar suscripción

En este ejemplo, el agente de IA ayuda a los usuarios a actualizar su plan. La API recibe el estado actual y el nombre del nuevo plan. El punto final es:
https://api.socialintents.com/upgrade-subscription?status={{status}}&plan={{plan}}

Cuando un usuario dice "Quiero pasar a Premium", la IA utiliza esta API para procesar la solicitud y confirmar la actualización.

Consulta meteorológica

Esta acción extrae los datos meteorológicos de una ciudad determinada mediante una solicitud GET a:
https://api.openweathermap.org/data/2.5/weather?q={{city}}&appid={{apikey}}&units=imperial

Cuando un usuario dice "¿Qué tiempo hace en Nueva York?", el agente de IA recupera y resume la respuesta.