เพิ่มเอกสารประเภทสเปรดชีต

อัปโหลดเอกสาร ประเภทสเปรดชีต แบบกลุ่ม (Batch Upload) ระบบจะประมวลผลทีละไฟล์โดยแบ่งชิ้นส่วน (chunking/slicing), ฝังข้อมูล (embedding/vectorization) และจัดเก็บ เพื่อสร้างรหัสเอกสารใหม่

หมายเหตุ:
โมเดลฝังข้อมูล (embedding model) จะใช้โมเดลเริ่มต้นเท่านั้น ไม่สามารถกำหนดเองผ่าน API ได้
ผลลัพธ์ที่ได้จะเป็นเพียงผลการอัปโหลด ไม่ใช่ผลลัพธ์การฝังข้อมูลสุดท้าย ท่านสามารถตรวจสอบผลลัพธ์สุดท้ายได้ผ่าน API "Query Document Status"

วิธีการเรียกใช้งาน

POST

URL สำหรับเรียกใช้งาน

https://api-${endpoint}.gptbots.ai/v1/bot/doc/spreadsheet/add

การตรวจสอบสิทธิ์

โปรดดูรายละเอียดการตรวจสอบสิทธิ์ในหัวข้อ Overview

ตัวอย่างการเรียกใช้งาน

curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/bot/doc/spreadsheet/add' \ -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_1.xlsx", "file_base64": "SGVsbG8sIEJhc2U2NCBFbmNvZGluZyE=", "source_url": "https://www.gptbots.ai/doc/spreadsheet_1.xlsx", "file_name": "spreadsheet_1.xlsx" } ] }'

                      
                      curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/bot/doc/spreadsheet/add' \
-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_1.xlsx",
            "file_base64": "SGVsbG8sIEJhc2U2NCBFbmNvZGluZyE=",
            "source_url": "https://www.gptbots.ai/doc/spreadsheet_1.xlsx",
            "file_name": "spreadsheet_1.xlsx"
        }
    ]
}'

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

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

พารามิเตอร์ของคำขอ

ชื่อฟิลด์	ประเภท	จำเป็น	รายละเอียด
knowledge_base_id	String	ไม่จำเป็น	ฐานความรู้เป้าหมายที่ต้องการเพิ่มเอกสาร หากไม่ระบุจะใช้ฐานความรู้ "Default" โดยอัตโนมัติ
files	Array<Object>	จำเป็น	รายการเอกสารที่ต้องการเพิ่ม รองรับสูงสุด 20 ไฟล์ต่อครั้ง
file_url	String	ไม่จำเป็น	URL ของเอกสารที่ต้องการเพิ่ม รองรับไฟล์ csv/xls/xlsx ขนาดสูงสุด 10MB ต่อไฟล์ หมายเหตุ: ต้องระบุอย่างน้อย URL หรือ base64 หากระบุทั้งสอง base64 จะถูกใช้งานเป็นหลัก
file_base64	String	ไม่จำเป็น	base64 ของเอกสารที่ต้องการเพิ่ม รองรับไฟล์ csv/xls/xlsx ขนาดสูงสุด 10MB ต่อไฟล์ หมายเหตุ: ต้องระบุอย่างน้อย URL หรือ base64 หากระบุทั้งสอง base64 จะถูกใช้งานเป็นหลัก
file_name	String	จำเป็น	ชื่อของเอกสารที่ต้องการเพิ่ม ความยาว 1-200 ตัวอักษร
source_url	String	ไม่จำเป็น	URL ต้นทางของเอกสารที่ต้องการเพิ่ม ต้องเป็นไปตามรูปแบบ URL ที่กำหนด
chunk_token	Integer	ไม่จำเป็น	จำนวนโทเคนสูงสุดต่อชิ้นส่วนความรู้ขณะแบ่งข้อมูล ค่าเริ่มต้น 600 ช่วง 1-1000
header_row	Integer	ไม่จำเป็น	จำนวนแถว header สูงสุด เอกสารตารางจะถูกแบ่งตาม "header + data rows" ค่าเริ่มต้น 1 ช่วง 1-5

การตอบกลับ

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

{ "doc": [ { "doc_id": "xxxxxx", "doc_name": "test_1.csv" }, { "doc_id": "xxxxxx", "doc_name": "test_2.xlsx" } ], "failed": [ "file_1", "file_2" ] }

                      
                      {
    "doc": [
        {
            "doc_id": "xxxxxx",
            "doc_name": "test_1.csv"
        },
        {
            "doc_id": "xxxxxx",
            "doc_name": "test_2.xlsx"
        }
    ],
    "failed": [
        "file_1",
        "file_2"
    ]
}