En resumen
- Usa el código de su propia página.El agente llama a las herramientas que usted declara en su panel y registra en la página, con la propia sesión y el propio carrito del visitante.
- Pregunta antes de cambiar nada.Las acciones que cambian algo muestran una tarjeta de confirmación, y solo el clic del visitante la aprueba.
- Buscar y luego actuar.El agente puede encadenar pasos, como encontrar un producto y luego añadirlo al carrito, en una misma respuesta.
- Solo en las páginas adecuadas.Limite cada acción a rutas como /shop/*, para que se ofrezca solo donde tiene sentido.
Los visitantes suelen saber exactamente qué quieren, pero no dónde hacer clic. Las acciones del sitio les permiten simplemente decirlo. Añade dos bolsas del café de Kenia, muéstrame solo opciones veganas, resérvame una demo el martes. El agente lo hace en su página, y el visitante ve el resultado al instante.
Cómo funciona
Su desarrollador registra una herramienta en la página con una sola llamada, onetype addTool, y usted declara la misma herramienta en su panel en “Developer › Tools”. Una herramienta tiene un nombre, una descripción en palabras sencillas de cuándo usarla, las entradas que acepta como un pequeño JSON Schema y un handler: su propio JavaScript que hace el trabajo, como llamar a su carrito. Cuando un visitante pide algo que encaja, el agente rellena las entradas, OneType las comprueba con su esquema y su handler se ejecuta en el navegador del visitante.
- Indique qué hace la acción: lee, escribe o es destructiva.
- Escriba la pregunta de confirmación, con marcadores {param} que se rellenan con las entradas.
- Límitela a ciertas páginas, hasta 50 rutas.
- Fije un tiempo límite de 1 a 120 segundos, 15 por defecto.
- Actualice o elimine una herramienta en cualquier momento con updateTool y removeTool.
Muestre al agente lo que hay en pantalla
El agente solo puede usar un ID de producto que haya visto realmente. Pase los productos de la página actual con setContext, añada una herramienta de búsqueda para catálogos grandes, o deje que su herramienta acepte nombres de producto y busque el ID en su propio código. Un ID que el modelo se inventó no vale: la llamada no se ejecuta y se indica al agente que busque primero o pregunte al visitante.
El visitante sigue al mando
Todo lo que cambia la página o el carrito pregunta antes, salvo que usted indique expresamente lo contrario. Las acciones destructivas, como quitar un artículo, preguntan siempre. La aprobación es un clic en el chat, que ni el modelo ni el texto de una página web pueden falsificar. Si el visitante declina, su handler nunca se ejecuta.
Leer sobre la aprobación del visitante
Cadenas de pasos
El agente puede combinar herramientas en una respuesta. Puede buscar en su catálogo y luego añadir el artículo correcto al carrito, o consultar un pedido en su servidor con una acción de API y luego abrir la página del pedido en el navegador. Puede hacer hasta 20 llamadas a herramientas en una sola respuesta.
Los argumentos se comprueban con su esquema antes de que se ejecute su handler, así que una llamada no válida nunca llega a su código y se indica al agente qué estaba mal. Su handler puede devolver cualquier resultado JSON, y el agente lo usa en su respuesta. Indique los importes con su código de moneda para que el agente nunca tenga que adivinarla.