อัปเดตเอกสารประเภทสเปรดชีต

อัปเดตเอกสารประเภทสเปรดชีต

อัปเดตเอกสาร ประเภทสเปรดชีต แบบกลุ่ม (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 รายละเอียดข้อผิดพลาด