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>
43 lines
2.6 KiB
Plaintext
43 lines
2.6 KiB
Plaintext
---
|
||
title: "Récupérer les conversations de l'Assistant"
|
||
openapi: /fr/analytics.openapi.json GET /v1/analytics/{projectId}/assistant
|
||
keywords: [ "Analytics", "Assistant", "conversations", "export", "AI" ]
|
||
---
|
||
|
||
<div id="usage">
|
||
## Utilisation
|
||
</div>
|
||
|
||
Utilisez cet endpoint pour exporter l’historique des conversations de l’Assistant IA à partir de votre documentation. Chaque conversation inclut la requête de l’utilisateur, la réponse de l’Assistant IA, les sources citées, le statut de résolution et la catégorie de la requête.
|
||
|
||
Parcourez les résultats à l’aide du paramètre `cursor` renvoyé dans la réponse. Continuez à récupérer les données tant que `hasMore` vaut `true`.
|
||
|
||
<div id="filtering">
|
||
## Filtrage
|
||
</div>
|
||
|
||
Filtrez les conversations par plage de dates à l'aide des paramètres `dateFrom` et `dateTo`.
|
||
|
||
<div id="conversation-data">
|
||
## Données de conversation
|
||
</div>
|
||
|
||
Chaque ligne représente un tour de l’utilisateur dans une conversation. Une conversation comportant plusieurs échanges produit plusieurs lignes qui partagent le même `conversationId`.
|
||
|
||
Chaque ligne comprend :
|
||
|
||
- **query** : la question de l’utilisateur.
|
||
- **response** : la réponse de l’Assistant. Pour les tours de question de clarification, il s’agit de la question de suivi que l’Assistant a posée à l’utilisateur.
|
||
- **responseType** : `answer` ou `clarifying_question`. `clarifying_question` signifie que l’Assistant a posé une question de suivi au lieu de répondre. La valeur par défaut est `answer` lorsque le champ est absent.
|
||
- **sources** : les pages référencées dans la réponse, avec leur title et leur URL.
|
||
- **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.
|
||
- **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.
|
||
|
||
<div id="rate-limits">
|
||
## Limites de débit
|
||
</div>
|
||
|
||
Cet endpoint autorise 100 requêtes par organisation et par heure. Tous les endpoints d'analytics partagent cette limite.
|