Obtener conversaciones del assistant
Devuelve el historial paginado de conversaciones del Asistente de IA
Autentícate con una clave de API de administrador.
Uso
cursor devuelto en la respuesta. Continúa obteniendo resultados mientras hasMore sea true.
Filtrado
dateFrom y dateTo.
Datos de conversación
conversationId.
Cada fila incluye:
- query: La pregunta del usuario.
- response: La respuesta del assistant. En los turnos de pregunta aclaratoria, es la pregunta de seguimiento que el assistant le hizo al usuario.
- responseType:
answeroclarifying_question.clarifying_questionindica que el assistant hizo una pregunta de seguimiento en lugar de responder. Su valor predeterminado esanswercuando no está presente. - sources: Páginas a las que se hace referencia en la respuesta, con título y URL.
- resolutionStatus: Indica si el assistant respondió correctamente a este turno. Puede ser
answeredounanswered. Se calcula por fila, por lo que una misma conversación puede contener ambos estados. Usa este campo para identificar y analizar lagunas en la documentación detectadas a partir de preguntas de usuarios que el assistant no pudo resolver. - timestamp: Cuándo el usuario envió el mensaje que inició este turno. Las filas de la misma conversación tienen marcas de tiempo distintas.
- queryCategory: Clasificación del tipo de búsqueda, si está disponible.
- pageUrl: URL completa de la página de documentación donde se inició la conversación, o
nullsi no hay ninguna ruta de página disponible. Usa este campo para atribuir conversaciones a una página específica.
Límites de uso
Este endpoint permite 100 solicitudes por organización por hora. Todos los endpoints de analytics comparten este límite.Autorizaciones
El encabezado Authorization requiere un token de tipo Bearer. Usa una clave de API de administrador. Esta es una clave secreta del lado del servidor. Genera una en la página de claves de API de tu dashboard.
Parámetros de ruta
Parámetros de consulta
Fecha en formato ISO 8601 o AAAA-MM-DD
"2024-01-01"
Fecha en formato ISO 8601 o AAAA-MM-DD. dateTo es un límite superior exclusivo. Los resultados incluyen fechas anteriores, pero no la fecha especificada.
"2024-01-01"
Número máximo de resultados por página
1 <= x <= 1000Cursor de paginación (formato ULID)
Respuesta
Datos de conversación paginados