P+F sobre la cuenta de Intelligent Recommendations
Este artículo proporciona respuestas a preguntas o problemas comunes que pueden surgir al usar Intelligent Recommendations.
Contenido
-
Mantenimiento de cuentas
- ¿Cómo creo una cuenta de Intelligent Recommendations?
- ¿Cómo creo recursos de modelado y servicio?
- ¿Cómo contacto con el equipo de soporte?
- ¿Dónde puedo encontrar la URL del punto de servicio?
- Mi contrato de datos tiene errores, ¿qué significan?
- ¿Cómo puedo ver los registros de errores de mi instancia de modelado?
- ¿Por qué no puedo ver ningún registro escrito en mi carpeta de registros?
- ¿Qué sucede si configuro mal la marca de fecha y hora?
- ¿Mis archivos Model.JSON/CSV no se leen correctamente?
- ¿Cuál es el enfoque recomendado para actualizar correctamente mis datos de entrada?
-
Resultados de API y registro de errores
- ¿Cómo puedo verificar si soy un usuario autorizado para realizar solicitudes de API?
- La solicitud ha fallado, pero la URL es correcta.
- Acabo de crear una cuenta, ¿pero no veo resultados?
- ¿Cómo puedo seguir el estado de un modelo en mi cuenta IR?
- ¿Dónde están mis archivos de registro o por qué están vacíos?
- ¿Por qué solo ciertos productos o ciertas listas no devuelven resultados?
- ¿Qué debo hacer si mis resultados de tendencia están vacíos?
- ¿Qué debo hacer si mis resultados de "Picking para usted" están vacíos?
- ¿Por qué no veo recomendaciones de looks similares?
- ¿Dónde puedo ver la lista completa de códigos de estado de API?
- ¿Qué parámetros admite la recomendación inteligente para el seguimiento de las solicitudes de la API?
Mantenimiento de cuentas
Esta sección es para preguntas relacionadas con la configuración o el mantenimiento de cuentas de Intelligent Recommendations.
¿Cómo creo una cuenta de Intelligent Recommendations?
Para conocer los pasos sobre cómo configurar su cuenta, vaya a Descripción general de la configuración.
¿Cómo creo recursos de modelado y servicio?
Para conocer los pasos sobre cómo crear recursos de modelado y servicio, consulte el paso 5 de la guía de inicio rápido de creación de cuenta.
¿Cómo me comunico con el equipo de soporte de Intelligent Recommendations?
Para preguntas o problemas no respondidos anteriormente, puede comunicarse con el equipo de soporte de Intelligent Recommendations abriendo una incidencia de soporte técnico en el Portal de Microsoft Azure.
- En el menú de la izquierda, seleccione Ayuda y soporte.
- Seleccione Crear una nueva solicitud de soporte.
- Complete el formulario. Se crea una incidencia.
¿Dónde puedo encontrar la URL del punto de conexión?
Para conocer los pasos sobre cómo ubicar la URL de servicio punto de conexión, vaya a su cuenta de Intelligent Recommendations en Azure Portal y busque el recurso punto de conexión que desea usar. Desde allí, puede copiar la URL de publicación punto de conexión. Para obtener más información, vaya a la guía de inicio rápido para ver los resultados de las recomendaciones.
¿Cómo solucionar errores en el contrato de datos?
Para comprender los registros de errores que se devuelven en el contrato de datos, vaya a Tipos de errores.
¿Cómo puedo ver los registros de errores de mi instancia de modelado?
Para ver los registros de errores de su instancia de modelado, configure su cuenta para habilitar el modelado de errores. Para obtener más información, vaya a Configurar registro de errores. Para obtener más información sobre los tipos de errores que se pueden devolver, vaya a tipos de errores.
¿Por qué no puedo ver ningún registro escrito en mi carpeta de registros?
Si no puede ver ningún registro escrito en su carpeta de registros dedicada, puede verificar si su cuenta de IR tiene acceso para escribir en el contenedor correspondiente:
- Vaya a su cuenta de Intelligent Recommendations.
- Seleccione la pestaña Informes.
- Haga clic en el botón "Comprobar acceso"
- Si el mensaje devuelto indica que "Falta la configuración para acceder a la cuenta de almacenamiento", debe otorgar permisos de escritura para acceder al contenedor asociado. Si el mensaje devuelto indica que "La cuenta de almacenamiento solicitada no existe o no tiene permisos", asegúrese de que la URL proporcionada sea correcta.
¿Qué sucede si configuro mal la marca de fecha y hora?
Si tiene problemas con sus marcas de tiempo, el producto se elimina de la lista de candidatos disponibles y se filtrará de las recomendaciones. Para solucionar este problema, comience por verificar las entradas de la entidad de datos ItemsAndVariants y asegúrese de que la fecha de lanzamiento esté en el formato de fecha y hora compatible (que es "yyyy-MM-ddTHH: mm:ss.fffZ").
Problemas al leer los CSV de model.json
Abrir los CSV en Excel o cualquier otra herramienta que no sea compatible con CSV puede eliminar las columnas vacías que se requieren en el formato CSV para las entidades de datos. Sugerimos abrir y verificar sus CSV en el Bloc de notas o en una aplicación relacionada que no modifique el contenido.
¿Cuál es el enfoque recomendado para actualizar correctamente mis datos de entrada?
Si intenta modelar y actualizar sus datos de entrada al mismo tiempo, a veces puede conducir al modelado de datos de versiones de datos mixtos y resultados de recomendación no deseados. Consulte nuestra Guía de prácticas recomendadas para obtener más información sobre cómo actualizar sus datos de entrada correctamente.
Resultados de API y registro de errores
Esta sección es para preguntas relacionadas con los resultados de la API o la documentación de registro de errores.
¿Cómo puedo verificar si soy un usuario autorizado para realizar solicitudes de API?
Los usuarios deben agregarse a la lista de usuarios autorizados para un recurso punto de conexión antes de que puedan llamar correctamente al servicio. Para obtener más información sobre cómo consultar el estado de los usuarios autorizados, vaya al paso 2 de la guía de inicio rápido para crear solicitudes de API.
La solicitud ha fallado, pero la URL es correcta.
Si la URL es correcta, es posible que el usuario que realiza la solicitud no está en la lista de usuarios autorizados para este recurso punto de conexión.
Para obtener más información sobre cómo consultar el estado de los usuarios autorizados, vaya al paso 2 de la guía de inicio rápido para crear solicitudes de API.
Acabo de crear una cuenta, pero no veo resultados.
Si acaba de comenzar, el servicio tarda algún tiempo antes de que los resultados estén disponibles. Puede realizar un seguimiento del estado de modelado de cada uno de los modelos que ha creado. Para obtener más información, consulte nuestra Guía de informes de estado de modelado.
También puede consultar la carpeta de registros para conocer cualquier problema con su contrato de datos y si necesita realizar cambios o correcciones.
Si aún no puede ver ningún resultado, asegúrese de haber otorgado a su cuenta de Intelligent Recommendations un permiso para leer datos del contenedor correspondiente:
- Vaya a su cuenta de Intelligent Recommendations.
- Seleccione la pestaña "Modelado".
- Elija el componente de modelado relevante.
- Seleccione la pestaña "Cadena de conexión".
- Haga clic en el botón "Comprobar acceso".
- Si el mensaje devuelto indica que "Falta la configuración para acceder a la cuenta de almacenamiento", debe otorgar permisos de lectura para acceder al contenedor asociado. Si el mensaje devuelto indica que "La cuenta de almacenamiento solicitada no existe o no tiene permisos", asegúrese de que la URL proporcionada sea correcta.
Verifique también que las carpetas y los archivos correctos estén colocados en la cuenta de almacenamiento. Para obtener más información, vea Descargar el archivo model.json y configurar la carpeta raíz.
¿Cómo puedo hacer un seguimiento del estado de modelado?
Los clientes de Intelligent Recommendations pueden realizar un seguimiento del estado de modelado de cada uno de los modelos que han creado en sus cuentas. Después de configurar un modelo, el servicio creará periódicamente un archivo de registro de estado para informar sobre el estado actual de todos los algoritmos (para su nivel de modelado). Para obtener más información sobre cómo acceder a estos registros, consulte la Guía de informes de estado de modelado.
¿Dónde están mis archivos de registro o por qué están vacíos?
Sus archivos de registro pueden estar vacíos si no concedió los permisos correctos para Colaborador de datos de blob de almacenamiento o apuntó a la cadena de conexión incorrecta. Para confirmar, siga nuestra guía de inicio rápido.
Además, asegúrese de que sus archivos de registro de errores se hayan configurado correctamente y verifique que su cadena de conexión para su instancia de modelado apunte a la carpeta que contiene sus archivos de registro.
¿Por qué solo ciertos productos o ciertas listas no devuelven resultados?
En general, las interacciones insuficientes para un elemento o usuario determinado pueden afectar la calidad de los resultados o la falta de devolución de resultados. A veces, los productos nuevos también necesitan algo de tiempo para adquirir señales antes de aparecer en ciertas listas de recomendaciones. Siempre puede observar más de cerca el rendimiento de su producto utilizando los paneles.
¿Qué debo hacer si mis resultados de tendencia están vacíos?
La API de lista de tendencias tiene en cuenta tanto la antigüedad de un producto como el número de interacciones al calificar (clasificar) cada elemento de la lista.
Primero contamos la cantidad de interacciones en una ventana de tiempo establecida, luego nuetros factores de modelo en la antigüedad del producto (días desde su fecha de lanzamiento tal como aparece en el catálogo). Cuanto más nuevo es un artículo, mayor es la puntuación y, a medida que el producto "envejece", su puntuación decae exponencialmente.
Para controlar los resultados en Tendencias, deberá ajustar dos campos configurables en la Carpeta de entidad de datos de configuración de Reco:
- TrendingListMaxAgeDays establece la antigüedad máxima en días de un producto. Un producto que se lanzó hace más de TrendingListMaxAgeDays hace días no aparecerá en la lista de tendencias.
- TrendingListTransactionsIntervalDays establece la ventana de tiempo en la que se agregan las interacciones. Un elemento puede ser más antiguo que este valor, pero solo se cuentan las interacciones con menos de TrendingListTransactionsIntervalDays hace días.
Ajuste esta configuración en su entidad de datos de configuración de Reco y vuelva a publicar su modelo. Entonces debería empezar a ver los resultados de las recomendaciones.
¿Qué debo hacer si mis resultados de "Picking para usted" están vacíos?
La capacidad de "elegir para usted" solo está disponible para instancias de modelado con un conjunto de funciones marcado como Estándar o Premium. Si ha confirmado que el conjunto de funciones se configuró correctamente, observe más de cerca a los usuarios para los que está tratando de obtener recomendaciones. Una identificación de usuario sin datos de interacción históricos (como compras anteriores) no devolverá resultados cuando llame "seleccione para usted". Confirme también si el usuario ha optado recientemente por no recibir recomendaciones personalizadas. Cualquier usuario que haya optado por no personalizar no recibirá recomendaciones personalizadas.
¿Por qué no veo recomendaciones de Looks similares?
Las recomendaciones de aspectos similares se basan en imágenes similares y estas recomendaciones solo se mostrarán a los clientes que hayan seleccionado el conjunto de características premium y hayan compartido fotos de sus artículos en el contrato de datos. Confirme que ha seleccionado el conjunto de funciones premium para su modelo y que tiene las imágenes configuradas correctamente como se describe en Entidades de datos de asignación de imagen a elemento.
¿Dónde puedo ver la lista completa de códigos de estado de API?
La lista completa de códigos de estado de API están disponibles en la página Solicitudes de API de ejemplo, aquí.
¿Qué parámetros admite Intelligent Recommendations para el seguimiento de las solicitudes de la API?
Es opcional agregar uno o más de los siguientes ID de seguimiento como parámetros de encabezado para sus solicitudes de API. En caso de que encuentre problemas con sus solicitudes de API, al agregar uno o más de esos parámetros, podemos rastrear e investigar sus solicitudes de manera más efectiva de acuerdo con las ID relevantes que proporcione.
| Parámetro de clave de encabezado | Descripción |
|---|---|
| CorrelationId | |
| trace-id | |
| parent-id | Se puede utilizar según sus necesidades para agrupar solicitudes, por ejemplo del mismo usuario, región, etc. |
Esos parámetros de encabezado se pueden agregar a cualquier tipo de solicitud, independientemente del URI, los parámetros de consulta, el escenario, etc.
Consulte también
Guía de inicio rápido: configurar y ejecutar Intelligent Recommendations con datos de ejemplo
Guía de inicio rápido: realizar una llamada de API autenticada
Códigos de estado de API
Registros de errores
Descripción general de la configuración
Descripción general del contrato de datos