mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
47447c8617
* docs: document responseType and per-row semantics in assistant analytics export * docs: mirror assistant analytics export updates in Chinese translation --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
40 lines
2.4 KiB
Plaintext
40 lines
2.4 KiB
Plaintext
---
|
|
title: "Obtener conversaciones del assistant"
|
|
openapi: /es/analytics.openapi.json GET /v1/analytics/{projectId}/assistant
|
|
keywords: [ "analytics", "assistant", "conversations", "export", "AI" ]
|
|
---
|
|
|
|
<div id="usage">
|
|
## Uso
|
|
</div>
|
|
|
|
Utiliza este endpoint para exportar el historial de conversaciones del Asistente de IA desde tu documentación. Cada conversación incluye la búsqueda del usuario, la respuesta del Asistente de IA, las fuentes citadas, el estado de resolución y la categoría de la búsqueda.
|
|
|
|
Pagina los resultados usando el parámetro `cursor` devuelto en la respuesta. Continúa obteniendo resultados mientras `hasMore` sea `true`.
|
|
|
|
<div id="filtering">
|
|
## Filtrado
|
|
</div>
|
|
|
|
Filtra conversaciones por intervalo de fechas usando los parámetros `dateFrom` y `dateTo`.
|
|
|
|
<div id="conversation-data">
|
|
## Datos de conversación
|
|
</div>
|
|
|
|
Cada fila representa un turno del usuario en una conversación. Una conversación con varios intercambios genera varias filas que comparten el mismo `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**: `answer` o `clarifying_question`. `clarifying_question` indica que el assistant hizo una pregunta de seguimiento en lugar de responder. Su valor predeterminado es `answer` cuando 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 `answered` o `unanswered`. 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 `null` si 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. |