En resumen
- Respuestas reales de sus sistemas.El agente lee datos en directo de su API, como el estado de un pedido, en lugar de adivinar a partir de una página de ayuda.
- Firmadas y seguras de reintentar.Cada llamada va firmada para que su servidor pueda demostrar que viene de OneType, y lleva una clave de idempotencia estable.
- Los visitantes aprueban los cambios.Las herramientas que cambian algo preguntan antes al visitante en el chat, y las destructivas siempre preguntan.
- Sin números de pedido inventados.Un número de pedido u otro ID debe venir del visitante, de la página o de un resultado anterior, nunca de la imaginación del modelo.
La mayoría de los chatbots se quedan en responder. Un visitante pregunta dónde está su pedido y el bot lo envía a una página de seguimiento. Con las acciones de API, su agente llama a su propio sistema, lee el estado real y se lo dice en la misma conversación. Es como hablar con alguien de su equipo que tiene abierta la pantalla correcta.
Cómo funciona
Una API es la dirección en la que responde su propio software. Con las acciones de API (próximamente), usted añade una herramienta: le da un nombre, describe con palabras sencillas cuándo debe usarla el agente e introduce el método y la dirección https de su endpoint. Describe los datos de entrada que necesita, como un número de pedido, en un pequeño JSON Schema. Cuando un visitante pregunta algo que encaja, el agente rellena esos datos, OneType llama a su endpoint y el agente responde con lo que devolvió su API.
- Elija el método: GET, POST, PUT, PATCH o DELETE.
- Ponga los datos de entrada en la ruta con {parameter}; el resto van en la consulta o en el cuerpo JSON.
- Añada cabeceras y marque las credenciales como secretas, para que se guarden cifradas y no se vuelvan a mostrar.
- Indique qué hace la herramienta con sus datos: lee, cambia algo o es destructiva.
El agente encadena pasos por sí solo
Una respuesta puede usar varias herramientas. El agente puede consultar un pedido, después comprobar un plazo de devolución y luego ofrecer pasar el chat a una persona, todo en una respuesta. Puede hacer hasta 20 llamadas a herramientas en una sola respuesta, y un agente puede tener hasta 100 herramientas.
Pensado para que su API pueda confiar
Cada llamada se firma con un secreto de firma por agente, usando el esquema abierto Standard Webhooks, para que su servidor pueda comprobar que viene realmente de OneType. Cada llamada lleva además una clave de idempotencia que se mantiene igual en un reintento, para que su API pueda ignorar duplicados. OneType solo llama a direcciones públicas de internet y nunca sigue redirecciones.
Para datos personales, active “Only for signed-in visitors”. La llamada incluye entonces el contacto verificado, tomado de su propio token de identidad firmado, de modo que el modelo nunca puede elegir de qué cuenta trata una consulta. Los visitantes anónimos se rechazan.
Los cambios necesitan el clic del visitante
Una herramienta que solo lee se ejecuta enseguida. Una herramienta que cambia algo muestra al visitante una pregunta que usted escribe, como «¿Cancelar el pedido #1234?», y se ejecuta solo después de que haga clic para aprobar. Las herramientas destructivas siempre preguntan. Los ID, como números de pedido o SKU, deben venir de lo que escribió el visitante, de lo que muestra la página o de un resultado anterior de una herramienta. Si el modelo inventa uno, la llamada no se ejecuta y se indica al agente que lo busque o lo pregunte.
Ver cómo funciona la aprobación del visitante
Límites que conviene conocer
Su endpoint debe responder con JSON en menos de 10 segundos, y el agente lee hasta 32 KB. Cada herramienta tiene su propio límite de llamadas por minuto, de 1 a 60, 10 de forma predeterminada. Si una llamada falla, se informa al agente y este continúa, por ejemplo ofreciendo una persona.