Para crear un agente de IA para tu sitio web, empieza con una sola tarea del visitante y un conjunto pequeño de respuestas aprobadas. En Agentkit, añade esas fuentes, ajusta el chat, pruébalo en el Playground y después copia el código de inserción desde Channels → Website embed. Publica solo cuando una página real devuelva las respuestas que esperas. Puedes añadir acciones una vez que funcione el flujo básico de preguntas y respuestas.
Esta guía cubre un chat web respaldado por conocimiento, con acciones opcionales. No promete que un agente pueda completar una reserva, emitir un reembolso o cambiar un pedido solo porque es capaz de hablar de esas tareas.
1. Elige la tarea antes de elegir el modelo
Escribe la petición que quieres atender primero. Por ejemplo: «Ayudar a los visitantes a encontrar nuestra política de envíos y explicar cuándo un pedido tiene envío gratuito». Define la fuente de verdad y la vía alternativa para las preguntas que el agente no pueda responder. Así tendrás un criterio para juzgar el resultado más adelante.
Si necesitas un árbol de decisión fijo sin respuestas generadas, un chat guionizado puede encajar mejor. Si necesitas datos de una cuenta concreta o una transacción, planifica la integración y su límite de aprobación antes de invitar a los visitantes a usarla. Una fuente web por sí sola no puede consultar un pedido privado ni completar una compra.
2. Crea el agente y revisa sus fuentes
Crea una cuenta de Agentkit e inicia un nuevo chatbot. El asistente de configuración acepta una URL de sitio web o fuentes manuales, y después muestra las páginas encontradas antes de guiarte por el diseño y los ajustes de IA. Los modelos y cuotas disponibles dependen de tu plan actual, así que usa las opciones que aparecen en tu cuenta y consulta los precios actuales antes de presupuestar tráfico público.
Con una URL de sitio web, el asistente muestra las páginas detectadas, pero no permite quitar páginas individuales allí. Tras la configuración y el entrenamiento, abre Sources → Website. Elimina las páginas en las que los visitantes no deberían confiar, como ofertas caducadas o versiones antiguas de políticas. Conserva las páginas actuales de producto, políticas y ayuda. Si el rastreador omite una página, añádela desde Sources → Website después de la configuración. Desde Sources también puedes añadir archivos, texto y entradas de preguntas y respuestas. La guía de la fuente de sitio web explica los controles de rastreo.
Empieza con unas pocas páginas que puedas verificar. Un rastreo más amplio solo es útil si sus páginas son precisas y relevantes. No pongas documentos privados en las fuentes de un agente público solo porque un control de subida los acepte.
3. Configura el aspecto y las instrucciones del chat
En el asistente, elige el diseño y los ajustes de IA que encajen con la tarea del visitante. Después de la creación, puedes volver al diseño y las instrucciones del agente. Un mensaje de bienvenida útil indica qué puede responder el agente: «Pregunta sobre envíos, devoluciones o cuidado del producto». Las preguntas sugeridas pueden dar a los visitantes un punto de partida, pero no afirmes que esas sugerencias mejoran la conversión sin medirlo en tu propio sitio.
Dale al agente un límite que pueda respetar. Para el ejemplo de envíos: «Usa nuestra información publicada de envíos y devoluciones. Si una fecha de entrega depende de un pedido concreto, di que no puedes ver ese pedido y remite al visitante a soporte». Incluye la vía de soporte real. Las instrucciones no sustituyen a una fuente correcta ni a una prueba de la respuesta.
4. Prueba las respuestas antes de añadir acciones
Usa el Playground para hacer preguntas sobre las páginas aprobadas. Anota la pregunta, la fuente y la respuesta esperada. Este pequeño conjunto de lanzamiento facilita comprobar los cambios posteriores.
| Pregunta de prueba | Resultado esperado | Fallo que corregir |
|---|---|---|
| «¿Cuándo es gratuito el envío?» | Indica el umbral actual de la página de envíos publicada. | Cita un umbral antiguo o se inventa uno. |
| «¿Dónde está el pedido 12345?» | Dice que no puede ver un pedido privado sin una consulta de pedidos conectada y ofrece la vía de soporte. | Adivina una fecha de entrega. |
| «¿Puedes hacer una excepción a la política de devoluciones?» | Explica la política publicada y remite las excepciones a una persona. | Promete una excepción. |
El número de pedido es una prueba ilustrativa, no un registro real de cliente. Si una respuesta es incorrecta, revisa primero la fuente. Actualiza la página desactualizada o añade una entrada precisa de preguntas y respuestas, y después repite la misma pregunta. La guía de entrenamiento cubre el mantenimiento de fuentes y la comprobación de respuestas.
5. Añade una sola acción cuando tenga un resultado claro
Las acciones pueden captar un lead, mostrar un botón o conectar un servicio compatible. Elige una acción que pertenezca a la tarea del visitante y después prueba en el Playground tanto su ruta de éxito como su ruta de fallo. Por ejemplo, una acción Collect Leads puede pedir un correo electrónico para que una persona haga seguimiento. Un lead enviado es una solicitud de contacto, no una prueba de que se haya producido una venta o una cita. La guía de Collect Leads muestra la configuración.
Si la acción abre un proveedor de reservas, completa una reserva de prueba en ese proveedor y verifica su confirmación. Si necesita datos de una cuenta concreta, comprueba los permisos y evita prometer un resultado hasta que la integración lo devuelva. Para un agente útil de preguntas y respuestas, puedes dejar las acciones desactivadas.
6. Copia el código que genera tu cuenta
Cuando las respuestas y las acciones, si las hay, superen las pruebas, abre Channels → Website embed. Elige Chat widget para una burbuja flotante o Iframe para un panel integrado. Activa el canal que vayas a usar. Los dos canales tienen interruptores separados. Agentkit indica que el iframe no admite funciones avanzadas. Si añadiste una acción, pruébala en el canal que vas a publicar.
Para el widget, copia el código generado completo. Contiene un pequeño script de arranque y un script asíncrono del widget con el ID de tu agente y el host configurado. Coloca ambas etiquetas una sola vez en el pie de página compartido o en la plantilla HTML de tu sitio, antes de </body>, y después publica. Para un panel integrado, copia en su lugar el iframe generado y dale suficiente altura en tu diseño. No uses una URL de widget, una ruta de iframe ni un paquete de React copiados de un artículo antiguo. La guía de inserción cubre la colocación y la resolución de problemas. Los propietarios de sitios WordPress pueden seguir la guía de WordPress actual.
7. Verifica una página pública y sigue comprobándola
Abre la página publicada en una ventana nueva del navegador. Confirma que la burbuja o el panel aparece, se abre, acepta un mensaje y devuelve una respuesta respaldada por fuentes a una de tus preguntas de lanzamiento. Después haz una pregunta que debería rechazar o derivar a una persona. Anota lo que ocurrió. Una inserción que funciona solo demuestra que el chat se cargó; no demuestra que todas las respuestas sean seguras.
Si el chat no aparece, comprueba que el canal correcto está activado y que la página publicada contiene el código generado completo o el iframe. Un editor del sitio o una caché pueden eliminar o retrasar los scripts. Si carga pero no puede responder, revisa el estado de entrenamiento de las fuentes y los ajustes del agente. La guía de restricción de dominios explica un posible bloqueo de la inserción.
Tras el lanzamiento, revisa conversaciones reales en busca de preguntas sin respuesta que se repitan. Corrige la fuente y después vuelve a ejecutar la pregunta de lanzamiento afectada y una comprobación en la página pública. Mantén visible una vía de contacto normal para cuando el agente no pueda ayudar. Ese es el estándar práctico de un agente web: los visitantes obtienen una respuesta útil, ven cuándo no la tiene y llegan a la siguiente persona o página.
