Consultar LogTree

Mediante esta interfaz se pueden consultar los datos de traza LogTree correspondientes a partir del ID del mensaje.

Método de solicitud

GET

Endpoint

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

Autenticación

Para obtener instrucciones de autenticación, consúltese Visión general de la API (API Overview).

Solicitud

Ejemplo de solicitud

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}'

Este bloque de código en una ventana flotante

Cabeceras de la solicitud

Campo	Tipo	Descripción
Authorization	Bearer ${API Key}	Para la autenticación, se utiliza `Authorization: Bearer ${API Key}`. La clave de API se obtiene en la página «API Key».

Parámetros de la solicitud

Campo	Tipo	Obligatorio	Descripción
msgid	String	Sí	ID del mensaje; normalmente es el message_id devuelto por la API de conversación.

Respuesta

Ejemplo de respuesta

{ "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"
}

Este bloque de código en una ventana flotante

Respuesta correcta

Campo	Tipo	Descripción
treeData	Array<Object>	Lista de nodos de LogTree; los parámetros de los nodos se detallan en la tabla siguiente. Puede ser null si no hay datos de traza.
summary	Object	Resumen a nivel de mensaje. Puede ser null si no hay datos de traza.
runningStatus	String	Estado de ejecución general, por ejemplo SUCCESS, FAILED, RUNNING.
botId	String	ID del agente.
startTimestampMillis	Long	Marca de tiempo de inicio, en milisegundos.
endTimestampMillis	Long	Marca de tiempo de fin, en milisegundos.
totalLatencyMillis	Long	Duración total, en milisegundos.
totalTokens	Long	Número total de tokens.
stepCount	Integer	Número de pasos, derivado del número de nodos de LogTree devueltos.
credit	Number	Créditos consumidos. Puede ser null si no hay datos de créditos.
msgId	String	ID del mensaje.
conversationId	String	ID de la conversación.
traceId	String	ID de la traza.

Parámetros de los nodos de treeData

Campo	Tipo	Descripción
children	Array<Object>	Nodos hijos, con la misma estructura que esta tabla. Puede ser null en los nodos hoja.
actionId	String	ID de la acción.
traceId	String	ID de la traza.
msgId	String	ID del mensaje.
botId	String	ID del agente.
logComponentId	String	ID del componente.
logComponentName	String	Nombre del componente.
logComponentTitle	String	Título del componente.
logComponentType	String	Tipo de componente.
isComponent	Boolean	Indica si el nodo es un nodo de componente.
actionType	String	Tipo de acción.
actionName	String	Nombre de la acción.
runningStatus	String	Estado de ejecución del nodo.
startTimestampMillis	Long	Marca de tiempo de inicio del nodo, en milisegundos.
endTimestampMillis	Long	Marca de tiempo de fin del nodo, en milisegundos.
latencyMillis	Long	Duración del nodo, en milisegundos.
input	Object/String/Array	Entrada del nodo.
output	Object/String/Array	Salida del nodo.
inputTokens	Integer	Número de tokens de entrada.
outputTokens	Integer	Número de tokens de salida.
totalTokens	Integer/String	Número total de tokens, según el tipo de retorno existente de LogTree.
extension	String/Object	Información de extensión.
createTime	Long	Marca de tiempo de creación, en milisegundos.
uuid	String	Identificador único del nodo.
workflowExecutionId	String	ID de ejecución del workflow.
parentId	String	ID del nodo padre.

Respuesta de error

Campo	Tipo	Descripción
code	Integer	Código de error.
message	String	Detalles del error.