Interroger LogTree

Cette interface permet d'interroger les données de trace LogTree correspondantes à partir de l'ID du message.

Méthode de requête

GET

Endpoint

https://api-${endpoint}.gptbots.ai/v1/bot/logtree/query

Authentification

Consultez la Présentation de l'API pour les instructions d'authentification.

Requête

Exemple de requête

curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/bot/logtree/query?msgid=6a475fa11d276b3d062a1be8' \ -H 'Authorization: Bearer ${API Key}'

                      
                      curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/bot/logtree/query?msgid=6a475fa11d276b3d062a1be8' \
-H 'Authorization: Bearer ${API Key}'

Ce bloc de code dans la fenêtre flottante

En-têtes de la requête

Champ	Type	Description
Authorization	Bearer ${API Key}	Utilisez Authorization: Bearer ${API Key} pour l'authentification. Obtenez la clé API depuis la page Clé API.

Paramètres de la requête

Champ	Type	Obligatoire	Description
msgid	String	Oui	ID du message, généralement le message_id renvoyé par l'API de conversation.

Réponse

Exemple de réponse

{ "treeData": [ { "children": null, "actionId": "START_001", "traceId": "lyyqYMnfFSW5vWF5qdj5lR0t0DpjQR3icJi1lxm2CvUWpW8oI1-1783062433496", "msgId": "6a475fa11d276b3d062a1be8", "botId": "664ed07a277ef442b132feba", "logComponentId": "1lwSWOnjxuQK", "logComponentName": "Start", "logComponentTitle": null, "logComponentType": "Start", "isComponent": true, "actionType": "Start", "actionName": "Start", "startTimestampMillis": 1783062433496, "endTimestampMillis": 1783062433654, "runningStatus": "SUCCESS", "latencyMillis": 0, "input": { "content": [ { "type": "Text", "text": "1+1=?" } ] }, "output": { "content": [ { "type": "Text", "text": "1+1=?" } ] }, "inputTokens": 0, "outputTokens": 0, "totalTokens": "0", "extension": "{}", "createTime": 1783062433679, "uuid": "e53dcbb9-07d1-4019-9b66-e9d32b28bcbf", "workflowExecutionId": "", "parentId": "1lwSWOnjxuQK" } ], "summary": { "runningStatus": "SUCCESS", "botId": "664ed07a277ef442b132feba", "startTimestampMillis": 1783062433498, "endTimestampMillis": 1783062434933, "totalLatencyMillis": 1437, "totalTokens": 34, "stepCount": 3, "credit": -0.0031 }, "msgId": "6a475fa11d276b3d062a1be8", "conversationId": "6a475fa11d276b3d062a1be5", "traceId": "lyyqYMnfFSW5vWF5qdj5lR0t0DpjQR3icJi1lxm2CvUWpW8oI1-1783062433496" }

                      
                      {
  "treeData": [
    {
      "children": null,
      "actionId": "START_001",
      "traceId": "lyyqYMnfFSW5vWF5qdj5lR0t0DpjQR3icJi1lxm2CvUWpW8oI1-1783062433496",
      "msgId": "6a475fa11d276b3d062a1be8",
      "botId": "664ed07a277ef442b132feba",
      "logComponentId": "1lwSWOnjxuQK",
      "logComponentName": "Start",
      "logComponentTitle": null,
      "logComponentType": "Start",
      "isComponent": true,
      "actionType": "Start",
      "actionName": "Start",
      "startTimestampMillis": 1783062433496,
      "endTimestampMillis": 1783062433654,
      "runningStatus": "SUCCESS",
      "latencyMillis": 0,
      "input": {
        "content": [
          {
            "type": "Text",
            "text": "1+1=?"
          }
        ]
      },
      "output": {
        "content": [
          {
            "type": "Text",
            "text": "1+1=?"
          }
        ]
      },
      "inputTokens": 0,
      "outputTokens": 0,
      "totalTokens": "0",
      "extension": "{}",
      "createTime": 1783062433679,
      "uuid": "e53dcbb9-07d1-4019-9b66-e9d32b28bcbf",
      "workflowExecutionId": "",
      "parentId": "1lwSWOnjxuQK"
    }
  ],
  "summary": {
    "runningStatus": "SUCCESS",
    "botId": "664ed07a277ef442b132feba",
    "startTimestampMillis": 1783062433498,
    "endTimestampMillis": 1783062434933,
    "totalLatencyMillis": 1437,
    "totalTokens": 34,
    "stepCount": 3,
    "credit": -0.0031
  },
  "msgId": "6a475fa11d276b3d062a1be8",
  "conversationId": "6a475fa11d276b3d062a1be5",
  "traceId": "lyyqYMnfFSW5vWF5qdj5lR0t0DpjQR3icJi1lxm2CvUWpW8oI1-1783062433496"
}

Ce bloc de code dans la fenêtre flottante

Réponse réussie

Champ	Type	Description
treeData	Array<Object>	Liste des nœuds LogTree ; les paramètres des nœuds sont détaillés dans le tableau ci-dessous. Peut être null en l'absence de données de trace.
summary	Object	Résumé au niveau du message. Peut être null en l'absence de données de trace.
runningStatus	String	Statut d'exécution global, par exemple SUCCESS, FAILED, RUNNING.
botId	String	ID de l'Agent.
startTimestampMillis	Long	Horodatage de début, en millisecondes.
endTimestampMillis	Long	Horodatage de fin, en millisecondes.
totalLatencyMillis	Long	Durée totale, en millisecondes.
totalTokens	Long	Nombre total de tokens.
stepCount	Integer	Nombre d'étapes, dérivé du nombre de nœuds LogTree renvoyés.
credit	Number	Crédits consommés. Peut être null en l'absence de données de crédits.
msgId	String	ID du message.
conversationId	String	ID de la conversation.
traceId	String	ID de la trace.

Paramètres des nœuds treeData

Champ	Type	Description
children	Array<Object>	Nœuds enfants, de structure identique à ce tableau. Peut être null pour les nœuds feuilles.
actionId	String	ID de l'action.
traceId	String	ID de la trace.
msgId	String	ID du message.
botId	String	ID de l'Agent.
logComponentId	String	ID du composant.
logComponentName	String	Nom du composant.
logComponentTitle	String	Titre du composant.
logComponentType	String	Type du composant.
isComponent	Boolean	Indique si le nœud est un nœud de composant.
actionType	String	Type de l'action.
actionName	String	Nom de l'action.
runningStatus	String	Statut d'exécution du nœud.
startTimestampMillis	Long	Horodatage de début du nœud, en millisecondes.
endTimestampMillis	Long	Horodatage de fin du nœud, en millisecondes.
latencyMillis	Long	Durée du nœud, en millisecondes.
input	Object/String/Array	Entrée du nœud.
output	Object/String/Array	Sortie du nœud.
inputTokens	Integer	Nombre de tokens en entrée.
outputTokens	Integer	Nombre de tokens en sortie.
totalTokens	Integer/String	Nombre total de tokens, conforme au type de retour existant de LogTree.
extension	String/Object	Informations d'extension.
createTime	Long	Horodatage de création, en millisecondes.
uuid	String	Identifiant unique du nœud.
workflowExecutionId	String	ID d'exécution du workflow.
parentId	String	ID du nœud parent.

Réponse d'erreur

Champ	Type	Description
code	Integer	Code d'erreur.
message	String	Détails de l'erreur.