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.
General
- Nombre de la acción: Proporcione un nombre descriptivo como
obtener_tiempo
oactualizar_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.
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.