From ed00e2887cc83c897e2a99fff17b703fee69d27c Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 17 Sep 2026 17:01:31 +0000 Subject: [PATCH 1/2] docs: document feedback field in assistant analytics exports --- analytics.openapi.json | 13 +++++++++++++ analytics/export.mdx | 5 ++++- api/analytics/assistant-conversations.mdx | 1 + es/analytics.openapi.json | 13 +++++++++++++ es/analytics/export.mdx | 5 ++++- es/api/analytics/assistant-conversations.mdx | 1 + fr/analytics.openapi.json | 13 +++++++++++++ fr/analytics/export.mdx | 5 ++++- fr/api/analytics/assistant-conversations.mdx | 1 + zh/analytics.openapi.json | 13 +++++++++++++ zh/analytics/export.mdx | 5 ++++- zh/api/analytics/assistant-conversations.mdx | 1 + 12 files changed, 72 insertions(+), 4 deletions(-) diff --git a/analytics.openapi.json b/analytics.openapi.json index 46f3931e75..0385855038 100644 --- a/analytics.openapi.json +++ b/analytics.openapi.json @@ -352,6 +352,18 @@ ], "description": "Auto-assigned category grouping for the conversation, if applicable." }, + "feedback": { + "type": [ + "string", + "null" + ], + "enum": [ + "positive", + "negative", + null + ], + "description": "The user's thumbs rating on the assistant's response. `positive` for thumbs up, `negative` for thumbs down, or `null` if the user did not rate the response. If a user regenerates an answer and rates it again, the latest rating is used." + }, "pageUrl": { "type": [ "string", @@ -368,6 +380,7 @@ "sources", "resolutionStatus", "queryCategory", + "feedback", "pageUrl" ] } diff --git a/analytics/export.mdx b/analytics/export.mdx index e3914e2561..5d6221c100 100644 --- a/analytics/export.mdx +++ b/analytics/export.mdx @@ -50,7 +50,10 @@ Mintlify classifies each view using known user-agent patterns for search crawler ## Interpret assistant exports -Assistant exports include the queries, responses, sources, and a `resolutionStatus` column. The column indicates whether the assistant successfully answered each question with a value of `answered` or `unanswered`. Use it to identify documentation gaps surfaced by questions the assistant could not resolve. +Assistant exports include the queries, responses, sources, a `resolutionStatus` column, and a `feedback` column. + +- `resolutionStatus` indicates whether the assistant successfully answered each question with a value of `answered` or `unanswered`. Use it to identify documentation gaps surfaced by questions the assistant could not resolve. +- `feedback` records the user's thumbs rating on the assistant's response as `positive` or `negative`. The column is empty for responses the user did not rate. When a user regenerates an answer and rates it again, the latest rating is used. Sample analysis prompts for assistant exports: diff --git a/api/analytics/assistant-conversations.mdx b/api/analytics/assistant-conversations.mdx index b68e798672..e97699ca93 100644 --- a/api/analytics/assistant-conversations.mdx +++ b/api/analytics/assistant-conversations.mdx @@ -27,6 +27,7 @@ Each row includes: - **resolutionStatus**: Whether the assistant successfully answered this turn. Either `answered` or `unanswered`. Computed per row, so a single conversation can contain both statuses. Use this field to track and analyze documentation gaps surfaced by user questions the assistant could not resolve. - **timestamp**: When the user sent the message that started this turn. Rows in the same conversation have different timestamps. - **queryCategory**: Classification of the query type, if available. +- **feedback**: The user's thumbs rating on the assistant's response. Either `positive`, `negative`, or `null` if the user did not rate the response. When a user regenerates an answer and rates it again, the latest rating is used. - **pageUrl**: Full URL of the documentation page where the conversation started, or `null` if no page path is available. Use this field to attribute conversations to a specific page. ## Rate limits diff --git a/es/analytics.openapi.json b/es/analytics.openapi.json index be994838c3..b367929ffa 100644 --- a/es/analytics.openapi.json +++ b/es/analytics.openapi.json @@ -412,6 +412,18 @@ ], "description": "Categoría de agrupación asignada automáticamente a la conversación, si corresponde." }, + "feedback": { + "type": [ + "string", + "null" + ], + "enum": [ + "positive", + "negative", + null + ], + "description": "Valoración con pulgar del usuario sobre la respuesta del assistant. `positive` para pulgar arriba, `negative` para pulgar abajo, o `null` si el usuario no valoró la respuesta. Si el usuario regenera una respuesta y la vuelve a valorar, se usa la valoración más reciente." + }, "pageUrl": { "type": [ "string", @@ -427,6 +439,7 @@ "response", "sources", "queryCategory", + "feedback", "pageUrl" ] } diff --git a/es/analytics/export.mdx b/es/analytics/export.mdx index 20022728d3..235221e4c3 100644 --- a/es/analytics/export.mdx +++ b/es/analytics/export.mdx @@ -54,7 +54,10 @@ Mintlify clasifica cada vista utilizando patrones conocidos de user-agent para c ## Interpretar las exportaciones del assistant -Las exportaciones del assistant incluyen las consultas, las respuestas, las fuentes y una columna `resolutionStatus`. La columna indica si el assistant respondió con éxito a cada pregunta con un valor de `answered` o `unanswered`. Úsala para identificar brechas en la documentación reveladas por preguntas que el assistant no pudo resolver. +Las exportaciones del assistant incluyen las consultas, las respuestas, las fuentes, una columna `resolutionStatus` y una columna `feedback`. + +- `resolutionStatus` indica si el assistant respondió con éxito a cada pregunta con un valor de `answered` o `unanswered`. Úsala para identificar brechas en la documentación reveladas por preguntas que el assistant no pudo resolver. +- `feedback` registra la valoración con pulgar del usuario sobre la respuesta del assistant como `positive` o `negative`. La columna queda vacía para las respuestas que el usuario no valoró. Si el usuario regenera una respuesta y la vuelve a valorar, se usa la valoración más reciente. Prompts de análisis de ejemplo para las exportaciones del assistant: diff --git a/es/api/analytics/assistant-conversations.mdx b/es/api/analytics/assistant-conversations.mdx index 777fdec9a8..90674febd9 100644 --- a/es/api/analytics/assistant-conversations.mdx +++ b/es/api/analytics/assistant-conversations.mdx @@ -33,6 +33,7 @@ Cada fila incluye: - **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. +- **feedback**: Valoración con pulgar del usuario sobre la respuesta del assistant. Puede ser `positive`, `negative` o `null` si el usuario no valoró la respuesta. Si el usuario regenera una respuesta y la vuelve a valorar, se usa la valoración más reciente. - **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 diff --git a/fr/analytics.openapi.json b/fr/analytics.openapi.json index 9b53fcc41a..ece45ce56c 100644 --- a/fr/analytics.openapi.json +++ b/fr/analytics.openapi.json @@ -424,6 +424,18 @@ ], "description": "Catégorie de regroupement automatiquement attribuée à la conversation, le cas échéant." }, + "feedback": { + "type": [ + "string", + "null" + ], + "enum": [ + "positive", + "negative", + null + ], + "description": "Évaluation par pouce de l'utilisateur sur la réponse de l'Assistant. `positive` pour un pouce en l'air, `negative` pour un pouce vers le bas, ou `null` si l'utilisateur n'a pas évalué la réponse. Si l'utilisateur régénère une réponse et la réévalue, l'évaluation la plus récente est utilisée." + }, "pageUrl": { "type": [ "string", @@ -439,6 +451,7 @@ "response", "sources", "queryCategory", + "feedback", "pageUrl" ] } diff --git a/fr/analytics/export.mdx b/fr/analytics/export.mdx index 4ac1dd3b1a..7c37d99e09 100644 --- a/fr/analytics/export.mdx +++ b/fr/analytics/export.mdx @@ -54,7 +54,10 @@ Mintlify classe chaque vue à l'aide de schémas connus de user-agents pour les ## Interpréter les exports de l'assistant -Les exports de l'assistant incluent les requêtes, les réponses, les sources et une colonne `resolutionStatus`. Cette colonne indique si l'assistant a répondu avec succès à chaque question avec la valeur `answered` ou `unanswered`. Utilisez-la pour identifier les lacunes de la documentation révélées par les questions que l'assistant n'a pas pu résoudre. +Les exports de l'assistant incluent les requêtes, les réponses, les sources, une colonne `resolutionStatus` et une colonne `feedback`. + +- `resolutionStatus` indique si l'assistant a répondu avec succès à chaque question avec la valeur `answered` ou `unanswered`. Utilisez-la pour identifier les lacunes de la documentation révélées par les questions que l'assistant n'a pas pu résoudre. +- `feedback` enregistre l'évaluation par pouce de l'utilisateur sur la réponse de l'assistant avec la valeur `positive` ou `negative`. La colonne est vide pour les réponses que l'utilisateur n'a pas évaluées. Si l'utilisateur régénère une réponse et la réévalue, l'évaluation la plus récente est utilisée. Exemples de prompts d'analyse pour les exports de l'assistant : diff --git a/fr/api/analytics/assistant-conversations.mdx b/fr/api/analytics/assistant-conversations.mdx index cd04db5a8c..d01fb35d25 100644 --- a/fr/api/analytics/assistant-conversations.mdx +++ b/fr/api/analytics/assistant-conversations.mdx @@ -33,6 +33,7 @@ Chaque ligne comprend : - **resolutionStatus** : indique si l’Assistant a répondu correctement à ce tour. La valeur est `answered` ou `unanswered`. Elle est calculée par ligne, une même conversation peut donc contenir les deux statuts. Utilisez ce champ pour suivre et analyser les lacunes de la documentation mises en évidence par les questions des utilisateurs auxquelles l’Assistant n’a pas pu répondre. - **timestamp** : le moment où l’utilisateur a envoyé le message qui a lancé ce tour. Les lignes d’une même conversation ont des horodatages différents. - **queryCategory** : la classification du type de requête, si disponible. +- **feedback** : l'évaluation par pouce de l'utilisateur sur la réponse de l'Assistant. La valeur est `positive`, `negative` ou `null` si l'utilisateur n'a pas évalué la réponse. Si l'utilisateur régénère une réponse et la réévalue, l'évaluation la plus récente est utilisée. - **pageUrl** : URL complète de la page de documentation où la conversation a démarré, ou `null` si aucun chemin de page n'est disponible. Utilisez ce champ pour attribuer les conversations à une page spécifique.
diff --git a/zh/analytics.openapi.json b/zh/analytics.openapi.json index 2789e0f3a6..b865223dda 100644 --- a/zh/analytics.openapi.json +++ b/zh/analytics.openapi.json @@ -424,6 +424,18 @@ ], "description": "会话自动分配的分类分组（如适用）。" }, + "feedback": { + "type": [ + "string", + "null" + ], + "enum": [ + "positive", + "negative", + null + ], + "description": "用户对 AI 助手响应的点赞或点踩评价。`positive` 表示点赞，`negative` 表示点踩，`null` 表示用户未评价该响应。如果用户重新生成回答并再次评价，则使用最新的评价。" + }, "pageUrl": { "type": [ "string", @@ -439,6 +451,7 @@ "response", "sources", "queryCategory", + "feedback", "pageUrl" ] } diff --git a/zh/analytics/export.mdx b/zh/analytics/export.mdx index e4e6671f14..ae2c0ec5a8 100644 --- a/zh/analytics/export.mdx +++ b/zh/analytics/export.mdx @@ -54,7 +54,10 @@ Mintlify 使用已知的 user-agent 模式对搜索爬虫、训练爬虫和 AI ## 解读助手导出数据
-助手导出包含查询、响应、来源以及 `resolutionStatus` 列。该列表示助手是否成功回答了每个问题,其值为 `answered` 或 `unanswered`。可利用它识别助手无法解决的问题所暴露出的文档缺口。 +助手导出包含查询、响应、来源、`resolutionStatus` 列以及 `feedback` 列。 + +- `resolutionStatus` 表示助手是否成功回答了每个问题,其值为 `answered` 或 `unanswered`。可利用它识别助手无法解决的问题所暴露出的文档缺口。 +- `feedback` 记录用户对助手响应的点赞或点踩评价,值为 `positive` 或 `negative`。用户未评价的响应此列为空。如果用户重新生成回答并再次评价,则使用最新的评价。 助手导出的示例分析提示词: diff --git a/zh/api/analytics/assistant-conversations.mdx b/zh/api/analytics/assistant-conversations.mdx index 2cd43cfb58..a46006142a 100644 --- a/zh/api/analytics/assistant-conversations.mdx +++ b/zh/api/analytics/assistant-conversations.mdx @@ -33,6 +33,7 @@ keywords: [ "analytics", "assistant", "conversations", "export", "AI" ] - **resolutionStatus**: AI 助手是否成功回答了该轮次。值为 `answered` 或 `unanswered`。按行计算，因此同一个会话可能同时包含这两种状态。使用此字段可跟踪并分析 AI 助手无法解答的用户问题所暴露出的文档缺口。 - **timestamp**: 用户发送开启该轮次消息的时间。同一会话中的各行具有不同的时间戳。 - **queryCategory**: query 的类型分类（如果可用）。 +- **feedback**: 用户对 AI 助手响应的点赞或点踩评价。值为 `positive`、`negative`，或 `null`（如果用户未评价该响应）。如果用户重新生成回答并再次评价，则使用最新的评价。 - **pageUrl**: 会话开始时所在文档页面的完整 URL；如果没有可用的页面路径，则为 `null`。使用此字段可将会话归因到具体页面。
From 0ca9a7f63e07988704ab9e9bf90fc972d153fdcf Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Thu, 24 Sep 2026 16:46:16 -0700 Subject: [PATCH 2/2] docs: correct regenerate claim and tabulate assistant export columns Regenerating an assistant response soft-deletes the prior response and its rating, so the "latest rating is used" sentence implied ratings carry over when they don't. Remove it from the export page, API page, and OpenAPI spec in all locales. Format the assistant export columns as a table to match the traffic export section, and add a feedback-based analysis prompt. Co-Authored-By: Claude Opus 5.5 (1M context) --- analytics.openapi.json | 2 +- analytics/export.mdx | 9 ++++++--- api/analytics/assistant-conversations.mdx | 2 +- es/analytics.openapi.json | 2 +- es/analytics/export.mdx | 9 ++++++--- es/api/analytics/assistant-conversations.mdx | 2 +- fr/analytics.openapi.json | 2 +- fr/analytics/export.mdx | 9 ++++++--- fr/api/analytics/assistant-conversations.mdx | 2 +- zh/analytics.openapi.json | 2 +- zh/analytics/export.mdx | 9 ++++++--- zh/api/analytics/assistant-conversations.mdx | 2 +- 12 files changed, 32 insertions(+), 20 deletions(-) diff --git a/analytics.openapi.json b/analytics.openapi.json index 0385855038..58dd2450a2 100644 --- a/analytics.openapi.json +++ b/analytics.openapi.json @@ -362,7 +362,7 @@ "negative", null ], - "description": "The user's thumbs rating on the assistant's response. `positive` for thumbs up, `negative` for thumbs down, or `null` if the user did not rate the response. If a user regenerates an answer and rates it again, the latest rating is used." + "description": "The user's thumbs rating on the assistant's response. `positive` for thumbs up, `negative` for thumbs down, or `null` if the user did not rate the response." }, "pageUrl": { "type": [ diff --git a/analytics/export.mdx b/analytics/export.mdx index 5d6221c100..1e29d3d8c9 100644 --- a/analytics/export.mdx +++ b/analytics/export.mdx @@ -50,10 +50,12 @@ Mintlify classifies each view using known user-agent patterns for search crawler ## Interpret assistant exports -Assistant exports include the queries, responses, sources, a `resolutionStatus` column, and a `feedback` column. +Assistant exports include the queries, responses, and sources for each question, plus the following columns. -- `resolutionStatus` indicates whether the assistant successfully answered each question with a value of `answered` or `unanswered`. Use it to identify documentation gaps surfaced by questions the assistant could not resolve. -- `feedback` records the user's thumbs rating on the assistant's response as `positive` or `negative`. The column is empty for responses the user did not rate. When a user regenerates an answer and rates it again, the latest rating is used. +| Column | Description | +| --- | --- | +| `resolutionStatus` | Whether the assistant answered the question: `answered` or `unanswered`. Use it to identify documentation gaps surfaced by questions the assistant could not resolve. | +| `feedback` | The user's thumbs rating on the response: `positive` or `negative`. Empty if the user did not rate the response. | Sample analysis prompts for assistant exports: @@ -61,4 +63,5 @@ Assistant exports include the queries, responses, sources, a `resolutionStatus` - List any queries that had no sources cited. - Find patterns in unsuccessful interactions. - Group unanswered queries by topic to prioritize content updates. + - Summarize the sources cited in responses with `negative` feedback. diff --git a/api/analytics/assistant-conversations.mdx b/api/analytics/assistant-conversations.mdx index e97699ca93..443f84b003 100644 --- a/api/analytics/assistant-conversations.mdx +++ b/api/analytics/assistant-conversations.mdx @@ -27,7 +27,7 @@ Each row includes: - **resolutionStatus**: Whether the assistant successfully answered this turn. Either `answered` or `unanswered`. Computed per row, so a single conversation can contain both statuses. Use this field to track and analyze documentation gaps surfaced by user questions the assistant could not resolve. - **timestamp**: When the user sent the message that started this turn. Rows in the same conversation have different timestamps. - **queryCategory**: Classification of the query type, if available. -- **feedback**: The user's thumbs rating on the assistant's response. Either `positive`, `negative`, or `null` if the user did not rate the response. When a user regenerates an answer and rates it again, the latest rating is used. +- **feedback**: The user's thumbs rating on the assistant's response. Either `positive`, `negative`, or `null` if the user did not rate the response. - **pageUrl**: Full URL of the documentation page where the conversation started, or `null` if no page path is available. Use this field to attribute conversations to a specific page. ## Rate limits diff --git a/es/analytics.openapi.json b/es/analytics.openapi.json index b367929ffa..6629eba299 100644 --- a/es/analytics.openapi.json +++ b/es/analytics.openapi.json @@ -422,7 +422,7 @@ "negative", null ], - "description": "Valoración con pulgar del usuario sobre la respuesta del assistant. `positive` para pulgar arriba, `negative` para pulgar abajo, o `null` si el usuario no valoró la respuesta. Si el usuario regenera una respuesta y la vuelve a valorar, se usa la valoración más reciente." + "description": "Valoración con pulgar del usuario sobre la respuesta del assistant. `positive` para pulgar arriba, `negative` para pulgar abajo, o `null` si el usuario no valoró la respuesta." }, "pageUrl": { "type": [ diff --git a/es/analytics/export.mdx b/es/analytics/export.mdx index 235221e4c3..f71c97fa19 100644 --- a/es/analytics/export.mdx +++ b/es/analytics/export.mdx @@ -54,10 +54,12 @@ Mintlify clasifica cada vista utilizando patrones conocidos de user-agent para c ## Interpretar las exportaciones del assistant
-Las exportaciones del assistant incluyen las consultas, las respuestas, las fuentes, una columna `resolutionStatus` y una columna `feedback`. +Las exportaciones del assistant incluyen las consultas, las respuestas y las fuentes de cada pregunta, además de las siguientes columnas. -- `resolutionStatus` indica si el assistant respondió con éxito a cada pregunta con un valor de `answered` o `unanswered`. Úsala para identificar brechas en la documentación reveladas por preguntas que el assistant no pudo resolver. -- `feedback` registra la valoración con pulgar del usuario sobre la respuesta del assistant como `positive` o `negative`. La columna queda vacía para las respuestas que el usuario no valoró. Si el usuario regenera una respuesta y la vuelve a valorar, se usa la valoración más reciente. +| Columna | Descripción | +| --- | --- | +| `resolutionStatus` | Si el assistant respondió la pregunta: `answered` o `unanswered`. Úsala para identificar brechas en la documentación reveladas por preguntas que el assistant no pudo resolver. | +| `feedback` | La valoración con pulgar del usuario sobre la respuesta: `positive` o `negative`. Vacía si el usuario no valoró la respuesta. | Prompts de análisis de ejemplo para las exportaciones del assistant: @@ -65,4 +67,5 @@ Las exportaciones del assistant incluyen las consultas, las respuestas, las fuen - Enumera cualquier consulta que no tenga fuentes citadas. - Encuentra patrones en las interacciones no exitosas. - Agrupa las consultas sin respuesta por tema para priorizar las actualizaciones de contenido. + - Resume las fuentes citadas en las respuestas con feedback `negative`. diff --git a/es/api/analytics/assistant-conversations.mdx b/es/api/analytics/assistant-conversations.mdx index 90674febd9..8b9d650faa 100644 --- a/es/api/analytics/assistant-conversations.mdx +++ b/es/api/analytics/assistant-conversations.mdx @@ -33,7 +33,7 @@ Cada fila incluye: - **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. -- **feedback**: Valoración con pulgar del usuario sobre la respuesta del assistant. Puede ser `positive`, `negative` o `null` si el usuario no valoró la respuesta. Si el usuario regenera una respuesta y la vuelve a valorar, se usa la valoración más reciente. +- **feedback**: Valoración con pulgar del usuario sobre la respuesta del assistant. Puede ser `positive`, `negative` o `null` si el usuario no valoró la respuesta. - **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 diff --git a/fr/analytics.openapi.json b/fr/analytics.openapi.json index ece45ce56c..fb3d2144df 100644 --- a/fr/analytics.openapi.json +++ b/fr/analytics.openapi.json @@ -434,7 +434,7 @@ "negative", null ], - "description": "Évaluation par pouce de l'utilisateur sur la réponse de l'Assistant. `positive` pour un pouce en l'air, `negative` pour un pouce vers le bas, ou `null` si l'utilisateur n'a pas évalué la réponse. Si l'utilisateur régénère une réponse et la réévalue, l'évaluation la plus récente est utilisée." + "description": "Évaluation par pouce de l'utilisateur sur la réponse de l'Assistant. `positive` pour un pouce en l'air, `negative` pour un pouce vers le bas, ou `null` si l'utilisateur n'a pas évalué la réponse." }, "pageUrl": { "type": [ diff --git a/fr/analytics/export.mdx b/fr/analytics/export.mdx index 7c37d99e09..0ec8977b5c 100644 --- a/fr/analytics/export.mdx +++ b/fr/analytics/export.mdx @@ -54,10 +54,12 @@ Mintlify classe chaque vue à l'aide de schémas connus de user-agents pour les ## Interpréter les exports de l'assistant -Les exports de l'assistant incluent les requêtes, les réponses, les sources, une colonne `resolutionStatus` et une colonne `feedback`. +Les exports de l'assistant incluent les requêtes, les réponses et les sources de chaque question, ainsi que les colonnes suivantes. -- `resolutionStatus` indique si l'assistant a répondu avec succès à chaque question avec la valeur `answered` ou `unanswered`. Utilisez-la pour identifier les lacunes de la documentation révélées par les questions que l'assistant n'a pas pu résoudre. -- `feedback` enregistre l'évaluation par pouce de l'utilisateur sur la réponse de l'assistant avec la valeur `positive` ou `negative`. La colonne est vide pour les réponses que l'utilisateur n'a pas évaluées. Si l'utilisateur régénère une réponse et la réévalue, l'évaluation la plus récente est utilisée. +| Colonne | Description | +| --- | --- | +| `resolutionStatus` | Indique si l'assistant a répondu à la question : `answered` ou `unanswered`. Utilisez-la pour identifier les lacunes de la documentation révélées par les questions que l'assistant n'a pas pu résoudre. | +| `feedback` | L'évaluation par pouce de l'utilisateur sur la réponse : `positive` ou `negative`. Vide si l'utilisateur n'a pas évalué la réponse. | Exemples de prompts d'analyse pour les exports de l'assistant : @@ -65,4 +67,5 @@ Les exports de l'assistant incluent les requêtes, les réponses, les sources, u - Lister toutes les requêtes pour lesquelles aucune source n'a été citée. - Trouver des schémas dans les interactions infructueuses. - Regrouper les requêtes sans réponse par sujet afin de prioriser les mises à jour de contenu. + - Résumer les sources citées dans les réponses avec un feedback `negative`. diff --git a/fr/api/analytics/assistant-conversations.mdx b/fr/api/analytics/assistant-conversations.mdx index d01fb35d25..3623f4639a 100644 --- a/fr/api/analytics/assistant-conversations.mdx +++ b/fr/api/analytics/assistant-conversations.mdx @@ -33,7 +33,7 @@ Chaque ligne comprend : - **resolutionStatus** : indique si l’Assistant a répondu correctement à ce tour. La valeur est `answered` ou `unanswered`. Elle est calculée par ligne, une même conversation peut donc contenir les deux statuts. Utilisez ce champ pour suivre et analyser les lacunes de la documentation mises en évidence par les questions des utilisateurs auxquelles l’Assistant n’a pas pu répondre. - **timestamp** : le moment où l’utilisateur a envoyé le message qui a lancé ce tour. Les lignes d’une même conversation ont des horodatages différents. - **queryCategory** : la classification du type de requête, si disponible. -- **feedback** : l'évaluation par pouce de l'utilisateur sur la réponse de l'Assistant. La valeur est `positive`, `negative` ou `null` si l'utilisateur n'a pas évalué la réponse. Si l'utilisateur régénère une réponse et la réévalue, l'évaluation la plus récente est utilisée. +- **feedback** : l'évaluation par pouce de l'utilisateur sur la réponse de l'Assistant. La valeur est `positive`, `negative` ou `null` si l'utilisateur n'a pas évalué la réponse. - **pageUrl** : URL complète de la page de documentation où la conversation a démarré, ou `null` si aucun chemin de page n'est disponible. Utilisez ce champ pour attribuer les conversations à une page spécifique.
diff --git a/zh/analytics.openapi.json b/zh/analytics.openapi.json index b865223dda..13652df300 100644 --- a/zh/analytics.openapi.json +++ b/zh/analytics.openapi.json @@ -434,7 +434,7 @@ "negative", null ], - "description": "用户对 AI 助手响应的点赞或点踩评价。`positive` 表示点赞，`negative` 表示点踩，`null` 表示用户未评价该响应。如果用户重新生成回答并再次评价，则使用最新的评价。" + "description": "用户对 AI 助手响应的点赞或点踩评价。`positive` 表示点赞，`negative` 表示点踩，`null` 表示用户未评价该响应。" }, "pageUrl": { "type": [ diff --git a/zh/analytics/export.mdx b/zh/analytics/export.mdx index ae2c0ec5a8..18e752cb7e 100644 --- a/zh/analytics/export.mdx +++ b/zh/analytics/export.mdx @@ -54,10 +54,12 @@ Mintlify 使用已知的 user-agent 模式对搜索爬虫、训练爬虫和 AI ## 解读助手导出数据
-助手导出包含查询、响应、来源、`resolutionStatus` 列以及 `feedback` 列。 +助手导出包含每个问题的查询、响应和来源,以及以下列。 -- `resolutionStatus` 表示助手是否成功回答了每个问题,其值为 `answered` 或 `unanswered`。可利用它识别助手无法解决的问题所暴露出的文档缺口。 -- `feedback` 记录用户对助手响应的点赞或点踩评价,值为 `positive` 或 `negative`。用户未评价的响应此列为空。如果用户重新生成回答并再次评价,则使用最新的评价。 +| 列 | 描述 | +| --- | --- | +| `resolutionStatus` | 助手是否回答了该问题:`answered` 或 `unanswered`。可利用它识别助手无法解决的问题所暴露出的文档缺口。 | +| `feedback` | 用户对该响应的点赞或点踩评价:`positive` 或 `negative`。用户未评价时为空。 | 助手导出的示例分析提示词: @@ -65,4 +67,5 @@ Mintlify 使用已知的 user-agent 模式对搜索爬虫、训练爬虫和 AI - 列出没有引用任何来源的查询。 - 找出未成功交互中的模式。 - 按主题对未回答的查询进行分组,以确定内容更新的优先级。 + - 汇总 `feedback` 为 `negative` 的响应中引用的来源。 diff --git a/zh/api/analytics/assistant-conversations.mdx b/zh/api/analytics/assistant-conversations.mdx index a46006142a..d5ad0e6309 100644 --- a/zh/api/analytics/assistant-conversations.mdx +++ b/zh/api/analytics/assistant-conversations.mdx @@ -33,7 +33,7 @@ keywords: [ "analytics", "assistant", "conversations", "export", "AI" ] - **resolutionStatus**: AI 助手是否成功回答了该轮次。值为 `answered` 或 `unanswered`。按行计算，因此同一个会话可能同时包含这两种状态。使用此字段可跟踪并分析 AI 助手无法解答的用户问题所暴露出的文档缺口。 - **timestamp**: 用户发送开启该轮次消息的时间。同一会话中的各行具有不同的时间戳。 - **queryCategory**: query 的类型分类（如果可用）。 -- **feedback**: 用户对 AI 助手响应的点赞或点踩评价。值为 `positive`、`negative`，或 `null`（如果用户未评价该响应）。如果用户重新生成回答并再次评价，则使用最新的评价。 +- **feedback**: 用户对 AI 助手响应的点赞或点踩评价。值为 `positive`、`negative`，或 `null`（如果用户未评价该响应）。 - **pageUrl**: 会话开始时所在文档页面的完整 URL；如果没有可用的页面路径，则为 `null`。使用此字段可将会话归因到具体页面。