สอบถาม LogTree

สามารถใช้ API นี้เพื่อสอบถามข้อมูลเส้นทาง LogTree ที่เกี่ยวข้องตามรหัสข้อความ

วิธีการร้องขอ

GET

Endpoint

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

การยืนยันตัวตน

โปรดดูวิธีการยืนยันตัวตนที่ API Overview

การร้องขอ

ตัวอย่างการร้องขอ

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

บล็อกโค้ดนี้ในหน้าต่างลอย

Request Headers

ฟิลด์	ประเภท	คำอธิบาย
Authorization	Bearer ${API Key}	ใช้ Authorization: Bearer ${API Key} สำหรับการยืนยันตัวตน สามารถรับ API Key ได้จากหน้า API Key

พารามิเตอร์การร้องขอ

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
msgid	String	จำเป็น	รหัสข้อความ โดยทั่วไปคือ message_id ที่ส่งกลับจาก API การสนทนา

การตอบกลับ

ตัวอย่างการตอบกลับ

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

บล็อกโค้ดนี้ในหน้าต่างลอย

การตอบกลับสำเร็จ

ฟิลด์	ประเภท	คำอธิบาย
treeData	Array<Object>	รายการโหนด LogTree ดูพารามิเตอร์ของโหนดได้ในตารางด้านล่าง อาจเป็น null หากไม่มีข้อมูลเส้นทาง
summary	Object	ข้อมูลสรุประดับข้อความ อาจเป็น null หากไม่มีข้อมูลเส้นทาง
runningStatus	String	สถานะการทำงานโดยรวม เช่น SUCCESS, FAILED, RUNNING
botId	String	รหัส Agent
startTimestampMillis	Long	ไทม์สแตมป์เริ่มต้น หน่วยมิลลิวินาที
endTimestampMillis	Long	ไทม์สแตมป์สิ้นสุด หน่วยมิลลิวินาที
totalLatencyMillis	Long	เวลาที่ใช้ทั้งหมด หน่วยมิลลิวินาที
totalTokens	Long	จำนวนโทเคนทั้งหมด
stepCount	Integer	จำนวนขั้นตอน คำนวณจากจำนวนโหนด LogTree ที่ส่งกลับ
credit	Number	เครดิตที่ใช้ไป อาจเป็น null หากไม่มีข้อมูลเครดิต
msgId	String	รหัสข้อความ
conversationId	String	รหัสการสนทนา
traceId	String	รหัสเส้นทาง

พารามิเตอร์โหนด treeData

ฟิลด์	ประเภท	คำอธิบาย
children	Array<Object>	โหนดลูก โครงสร้างเหมือนกับตารางนี้ โหนดปลายทางอาจส่งกลับ null
actionId	String	รหัส Action
traceId	String	รหัสเส้นทาง
msgId	String	รหัสข้อความ
botId	String	รหัส Agent
logComponentId	String	รหัสคอมโพเนนต์
logComponentName	String	ชื่อคอมโพเนนต์
logComponentTitle	String	ชื่อเรื่องคอมโพเนนต์
logComponentType	String	ประเภทคอมโพเนนต์
isComponent	Boolean	เป็นโหนดคอมโพเนนต์หรือไม่
actionType	String	ประเภท Action
actionName	String	ชื่อ Action
runningStatus	String	สถานะการทำงานของโหนด
startTimestampMillis	Long	ไทม์สแตมป์เริ่มต้นของโหนด หน่วยมิลลิวินาที
endTimestampMillis	Long	ไทม์สแตมป์สิ้นสุดของโหนด หน่วยมิลลิวินาที
latencyMillis	Long	เวลาที่ใช้ของโหนด หน่วยมิลลิวินาที
input	Object/String/Array	อินพุตของโหนด
output	Object/String/Array	เอาต์พุตของโหนด
inputTokens	Integer	จำนวนโทเคนอินพุต
outputTokens	Integer	จำนวนโทเคนเอาต์พุต
totalTokens	Integer/String	จำนวนโทเคนทั้งหมด เป็นไปตามประเภทข้อมูลที่ LogTree ส่งกลับในปัจจุบัน
extension	String/Object	ข้อมูลส่วนขยาย
createTime	Long	ไทม์สแตมป์การสร้าง หน่วยมิลลิวินาที
uuid	String	ตัวระบุเฉพาะของโหนด
workflowExecutionId	String	รหัสการทำงานของ Workflow
parentId	String	รหัสโหนดแม่

การตอบกลับผิดพลาด

ฟิลด์	ประเภท	คำอธิบาย
code	Integer	รหัสข้อผิดพลาด
message	String	รายละเอียดข้อผิดพลาด