อัปเดตเอกสารประเภทสเปรดชีต
อัปเดตเอกสารประเภทสเปรดชีต
อัปเดตเอกสาร ประเภทสเปรดชีต แบบกลุ่ม (Batch update) ระบบจะดำเนินการแบ่งเนื้อหา (chunking/slicing), สร้าง embedding/vectorization และแทนที่เนื้อหาเอกสารเดิมด้วยเนื้อหาใหม่ โดยจะคงค่า ID เอกสารเดิมไว้
หมายเหตุ:
โมเดล embedding จะใช้โมเดลเริ่มต้นและไม่สามารถกำหนดเองผ่าน API ได้
ผลลัพธ์ที่ตอบกลับจะเป็นเพียงผลการอัปโหลด ไม่ใช่ผลลัพธ์ embedding สุดท้าย สามารถตรวจสอบผลลัพธ์สุดท้ายได้ผ่าน API "Query Document Status"
วิธีการเรียกใช้งาน
PUT
URL สำหรับเรียกใช้งาน
https://api-${endpoint}.gptbots.ai/v1/bot/doc/spreadsheet/update
การตรวจสอบสิทธิ์
โปรดดูรายละเอียดการตรวจสอบสิทธิ์ในหัวข้อ Overview
ตัวอย่างการเรียกใช้งาน
curl -X PUT 'https://api-${endpoint}.gptbots.ai/v1/bot/doc/spreadsheet/update' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
"knowledge_base_id": "67457fea6f658672d6482542",
"chunk_token": 700,
"header_row": 5,
"files": [
{
"file_url": "https://www.gptbots.ai/doc/spreadsheet.xlsx",
"source_url": "https://www.gptbots.ai/doc/spreadsheet.xlsx",
"file_name": "spreadsheet_1.xlsx"
}
]
}'
curl -X PUT 'https://api-${endpoint}.gptbots.ai/v1/bot/doc/spreadsheet/update' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
"knowledge_base_id": "67457fea6f658672d6482542",
"chunk_token": 700,
"header_row": 5,
"files": [
{
"file_url": "https://www.gptbots.ai/doc/spreadsheet.xlsx",
"source_url": "https://www.gptbots.ai/doc/spreadsheet.xlsx",
"file_name": "spreadsheet_1.xlsx"
}
]
}'
บล็อกโค้ดนี้ในหน้าต่างลอย
Header ของคำขอ
| ฟิลด์ | ประเภท | รายละเอียด |
|---|---|---|
| Authorization | Bearer ${API Key} | ใช้ Authorization: Bearer ${API Key} สำหรับการตรวจสอบสิทธิ์ รับ API Key ได้จากหน้า API Key |
| Content-Type | application/json | ประเภทข้อมูล ให้ตั้งเป็น application/json |
พารามิเตอร์ของคำขอ
| ฟิลด์ | ประเภท | จำเป็น | รายละเอียด |
|---|---|---|---|
| files | Array<Object> | ใช่ | รายการเอกสารที่ต้องการอัปเดต รองรับอัปเดตสูงสุด 20 เอกสารต่อครั้ง |
| doc_id | String | ใช่ | ID ของเอกสารที่ต้องการอัปเดต |
| file_url | String | ไม่จำเป็น | URL ของเอกสารที่ต้องการอัปเดต รองรับไฟล์ csv/xls/xlsx ขนาดสูงสุด 10MB ต่อไฟล์ หมายเหตุ: ต้องระบุ URL หรือ base64 อย่างใดอย่างหนึ่ง หากระบุทั้งสอง base64 จะถูกใช้งานก่อน |
| file_base64 | String | ไม่จำเป็น | base64 ของเอกสารที่ต้องการอัปเดต รองรับไฟล์ csv/xls/xlsx ขนาดสูงสุด 10MB ต่อไฟล์ หมายเหตุ: ต้องระบุ URL หรือ base64 อย่างใดอย่างหนึ่ง หากระบุทั้งสอง base64 จะถูกใช้งานก่อน |
| source_url | String | ไม่จำเป็น | URL แหล่งที่มาของเอกสารที่ต้องการอัปเดต ต้องเป็นไปตามรูปแบบ URL หากปล่อยว่าง ระบบจะไม่อัปเดตค่านี้ หากต้องการตั้งค่าให้ว่าง ให้กรอก NULL |
| chunk_token | Integer | ไม่จำเป็น | จำนวนโทเคนสูงสุดต่อ 1 ชิ้นความรู้ขณะแบ่งเนื้อหา ค่าเริ่มต้นคือ 600 ช่วงที่รองรับ: 1-1000 |
| header_row | Integer | ไม่จำเป็น | จำนวนแถว header สูงสุด เอกสารตารางจะถูกแบ่ง chunk ตาม "header + data rows" ค่าเริ่มต้นคือ 1 ช่วงที่รองรับ: 1-5 |
การตอบกลับ
ตัวอย่างการตอบกลับ
{
"doc": [
{
"doc_id": "xxxxxx",
"doc_name": "test_1.csv"
},
{
"doc_id": "xxxxxx",
"doc_name": "test_2.xlsx"
}
],
"failed": [
"xxxxxx",
"xxxxxx"
]
}
{
"doc": [
{
"doc_id": "xxxxxx",
"doc_name": "test_1.csv"
},
{
"doc_id": "xxxxxx",
"doc_name": "test_2.xlsx"
}
],
"failed": [
"xxxxxx",
"xxxxxx"
]
}
บล็อกโค้ดนี้ในหน้าต่างลอย
การตอบกลับเมื่อสำเร็จ
| ฟิลด์ | ประเภท | รายละเอียด |
|---|---|---|
| doc | Array<Object> | รายการเอกสารที่อัปเดตสำเร็จ |
| doc_id | String | ID ของเอกสารที่อัปเดตสำเร็จ |
| doc_name | String | ชื่อของเอกสารที่อัปเดตสำเร็จ |
| failed | Array<Object> | รายการ ID เอกสารที่อัปเดตไม่สำเร็จ |
การตอบกลับเมื่อไม่สำเร็จ
| ฟิลด์ | ประเภท | รายละเอียด |
|---|---|---|
| code | Int | รหัสข้อผิดพลาด |
| message | String | รายละเอียดข้อผิดพลาด |
