Récupérer les conversations de l'Assistant
Renvoie l’historique de conversation paginé de l’Assistant IA
Authentifiez-vous avec une clé d’API administrateur.
Utilisation
cursor renvoyé dans la réponse. Continuez à récupérer les données tant que hasMore vaut true.
Filtrage
dateFrom et dateTo.
Données de conversation
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 :
answerouclarifying_question.clarifying_questionsignifie que l’Assistant a posé une question de suivi au lieu de répondre. La valeur par défaut estanswerlorsque 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
answeredouunanswered. 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
nullsi aucun chemin de page n’est disponible. Utilisez ce champ pour attribuer les conversations à une page spécifique.
Limites de débit
Autorisations
L'en-tête Authorization requiert un jeton Bearer. Utilisez une clé d'API administrateur. Il s'agit d'une clé secrète côté serveur. Générez-en une depuis la page des clés d'API de votre Dashboard.
Paramètres de chemin
Paramètres de requête
Date au format ISO 8601 ou AAAA-MM-JJ
"2024-01-01"
Date au format ISO 8601 ou AAAA-MM-JJ. dateTo est une borne supérieure exclusive. Les résultats incluent les dates antérieures, mais pas la date spécifiée.
"2024-01-01"
Nombre maximal de résultats par page
1 <= x <= 1000Curseur de pagination (format ULID)
Réponse
Données de conversation paginées
Liste des conversations de l’Assistant.
Curseur de pagination permettant de récupérer la page de résultats suivante. Null s’il n’y a plus de résultats.
Indique si des résultats supplémentaires sont disponibles au‑delà de cette page.