รับข้อมูลเอกสารที่เกี่ยวข้อง

ดึงข้อมูลเอกสารอ้างอิงที่ AI Agent ใช้ในการตอบข้อความ โดยอ้างอิงจาก message_id ที่ส่งเข้ามา ผลลัพธ์จะประกอบด้วยข้อมูล เช่น รหัสเอกสาร ชื่อเอกสาร และ URL แหล่งที่มาของเอกสารที่ถูกอ้างอิง

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

POST

URL สำหรับร้องขอ

https://api-${endpoint}.gptbots.ai/v1/bot/data/references

การยืนยันตัวตนในการร้องขอ

โปรดดูรายละเอียดการยืนยันตัวตนในหัวข้อ Overview

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

curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/bot/data/references' \ -H 'Authorization: Bearer ${API Key}' \ -H 'Content-Type: application/json' \ -d '{ "message_id": "xxxxx" }'

                      
                      curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/bot/data/references' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
    "message_id": "xxxxx"
}'

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

Request Headers

ชื่อฟิลด์	ประเภท	คำอธิบาย
Authorization	Bearer ${token}	ใช้`Authorization: Bearer ${token}`เพื่อยืนยันตัวตน รับคีย์ได้จากหน้า API Keys เพื่อใช้เป็น token
Content-Type	application/json	ประเภทข้อมูล ให้ใช้ค่า application/json

Request Body

ชื่อฟิลด์	ประเภท	จำเป็น	คำอธิบาย
message_id	string	ใช่	รหัสข้อความที่ AI Agent ตอบกลับ

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

{ "code": 0, "msg": "success", "data": { "conversationId": "65dc320df07244300b25b993", "questionId": "65dc323ef07244300b25b9c5", "answerId": "65dc323ef07244300b25b9c6", "refDoc": [ { "dataId": "65dc3234f07244300b25b9b9", "dataName": "中国的历史", "sourceUrl": "https://www.example.com/chinese-history" } ] } }

                      
                      {
    "code": 0,
    "msg": "success",
    "data": {
        "conversationId": "65dc320df07244300b25b993",
        "questionId": "65dc323ef07244300b25b9c5",
        "answerId": "65dc323ef07244300b25b9c6",
        "refDoc": [
            {
                "dataId": "65dc3234f07244300b25b9b9",
                "dataName": "中国的历史",
                "sourceUrl": "https://www.example.com/chinese-history"
            }
        ]
    }
}

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

คำอธิบายการตอบกลับสำเร็จ

ฟิลด์	ประเภท	คำอธิบาย
conversationId	string	รหัสการสนทนา
questionId	string	รหัสข้อความคำถามของผู้ใช้
answerId	string	รหัสข้อความตอบกลับของ AI Agent
refDoc	JSON Array	ข้อมูลเอกสารที่อ้างอิง
dataId	string	รหัสเอกสาร
dataName	string	ชื่อเอกสาร
sourceUrl	string	URL แหล่งที่มาของเอกสาร

การตอบกลับกรณีล้มเหลว

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

รหัสข้อผิดพลาด

รหัส	ข้อความ
40000	พารามิเตอร์ไม่ถูกต้อง
40379	เครดิตไม่เพียงพอ
40378	ลบ AI Agent แล้ว
20055	ไม่อนุญาตให้ใช้ API
40127	การยืนยันตัวตนของนักพัฒนาไม่สำเร็จ