Integración de IA

AI Importer te permite conectar Clerk.io con cualquier plataforma que exponga una API, sin necesidad de una configuración predefinida o campos de formulario fijos.

La configuración se realiza completamente dentro de Ask Clerk.io. Describe lo que quieres conectar y Ask Clerk.io te guía en el resto: encontrar la API, solicitar credenciales, crear el importador y probarlo antes de transferirlo a Data Sync.

Primeros pasos #

Ve a Ask Clerk.io y dile desde qué plataforma quieres importar. Incluye una URL de tu tienda si tienes una — le da a Ask Clerk.io un punto de partida útil.

Ask Clerk.io determinará qué configuración es necesaria. En lugar de presentarte un formulario lleno de campos desconocidos, identifica los requisitos por sí mismo y pide lo que necesita, una cosa a la vez.

Credenciales #

Ask Clerk.io solicitará credenciales según lo que requiera la plataforma. Esto puede ser una clave de API, un conjunto de datos de inicio de sesión o un token, dependiendo de cómo autentique la plataforma.

Si Ask Clerk.io puede encontrar la documentación relevante de la API por sí solo, lo hará. Si la documentación no está disponible públicamente o quieres acelerar el proceso, puedes pegarla o compartir una URL directamente en el chat. Ask Clerk.io la utilizará como contexto para el resto de la configuración.

Pruebas #

Una vez que la conexión está configurada, Ask Clerk.io realiza una prueba para verificar que puede alcanzar la plataforma y recuperar los datos esperados.

Si la prueba tiene éxito, verás un resumen de lo que se encontró. Si algo falla, Ask Clerk.io identifica la causa y propone una solución, ya sea un problema de credenciales, un endpoint incorrecto o algo en la respuesta de la API.

Resolución de problemas #

Cuando algo sale mal, Ask Clerk.io explicará lo que sucedió y sugerirá qué intentar a continuación.

Puedes pedirle que reintente con la configuración actual, ajustar detalles específicos o volver a empezar desde cero. La conversación mantiene el contexto en todo momento, por lo que Ask Clerk.io recuerda lo que ya se intentó y no repite pasos que no funcionaron.

Si quieres cancelar por completo y empezar de nuevo, solo pídeselo. Ask Clerk.io borrará el estado y te permitirá comenzar otra vez desde el principio.

Ampliando la importación #

Después de que la conexión inicial funcione, puedes ampliar lo que se importa. Ask Clerk.io puede:

• Obtener atributos de producto adicionales que use tu catálogo
• Conectarse a fuentes de datos de terceros junto con tu plataforma principal
• Ajustar la lógica de importación para que coincida con la estructura de tu catálogo

Solo describe lo que necesitas. Ask Clerk.io actualizará la configuración sin requerir que expliques el proceso desde el inicio otra vez.

Transferencia a Data Sync #

Cuando el importador esté listo, Ask Clerk.io lo transfiere a Data Sync con toda la configuración en su lugar.

El contexto de la conversación — la plataforma, credenciales y cualquier ajuste realizado durante la configuración — se transfiere automáticamente. No necesita volver a ingresarse nada cuando llegues a Data Sync.

Desde allí, puedes gestionar el importador, controlar la programación de la sincronización y monitorear los registros de sincronización de la misma manera que con cualquier otro método de sincronización.

Lee más en Data Sync.

Gestionar un importador #

Abre Data > Configuration. Las Sync settings comunes, incluyendo Sync Time, aparecen después de Sync platform. Si tienes múltiples importadores, selecciona la pestaña relevante bajo Your importers.

La sección del importador muestra una descripción legible basada en su código actual. Explica la fuente de datos, los tipos de datos importados, transformaciones y límites relevantes. Los campos de credenciales aparecen cuando el importador los necesita.

Elige Edit importer para abrir Ask Clerk.io con el importador seleccionado como contexto. Esto no envía una solicitud ni inicia ningún trabajo. Escribe el cambio que deseas en el campo de mensaje y luego envíalo.

Elige Test importer para ejecutar una prueba de simulación. Un popup explica la prueba y muestra un resumen de resultados, detalles de validación y una vista previa limitada de registros. La prueba no inicia una sincronización real de datos. Cierra el popup para volver a la configuración.

Utiliza la acción separada Start new data sync cuando quieras ejecutar una sincronización real.