นำเข้าเวอร์ชัน Agent

นำเข้าเวอร์ชัน Agent

รองรับการอัปโหลดไฟล์ .bot เพื่อแทนที่การตั้งค่า Agent ปัจจุบัน และบันทึกเป็นเวอร์ชันใหม่

อินเทอร์เฟซนี้ใช้ API Key ของ Agent เป้าหมายในการยืนยันตัวตน และอนุญาตให้เรียกใช้ได้เฉพาะ Agent ที่เปิดสิทธิ์การจัดการเวอร์ชันเท่านั้น

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

POST

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

https://api.${endpoint}/v1/agent/version/import

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

ดูรายละเอียดได้ที่คำอธิบายวิธีการยืนยันตัวตนใน API Overview โปรดใช้ API Key ของ Agent เป้าหมายเป็น token

การร้องขอ

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

curl -X POST 'https://api.${endpoint}/v1/agent/version/import' \ -H 'Authorization: Bearer ${token}' \ -F 'file=@/path/to/agent.bot' \ -F 'versionDesc=Update prompt and tools'
                      
                      curl -X POST 'https://api.${endpoint}/v1/agent/version/import' \
  -H 'Authorization: Bearer ${token}' \
  -F 'file=@/path/to/agent.bot' \
  -F 'versionDesc=Update prompt and tools'

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

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

ฟิลด์ ประเภท คำอธิบาย
Authorization Bearer ${token} ใช้ API Key ของ Agent เป้าหมายในการยืนยันตัวตนของการเรียกใช้
Content-Type multipart/form-data ฟอร์มสำหรับอัปโหลดไฟล์

พารามิเตอร์การร้องขอ (Form Data)

พารามิเตอร์ ประเภท คำอธิบาย required
file File ไฟล์ .bot true
versionDesc String คำอธิบายเวอร์ชัน false

การตอบกลับ

เนื้อหาการตอบกลับ

{ "code": 0, "message": "OK", "data": { "botId": "bot-xxxx", "botType": "Agent", "version": "v2", "warning": null } }
                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "botId": "bot-xxxx",
    "botType": "Agent",
    "version": "v2",
    "warning": null
  }
}

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

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

ฟิลด์ ประเภท คำอธิบาย
botId String ID ของ Agent เป้าหมาย
bot_type String ประเภท Agent: Agent, FlowAgent, LoopAgent, Audio
version String หมายเลขเวอร์ชันที่บันทึก และกลายเป็นเวอร์ชันปัจจุบันในเวลาเดียวกัน
warning String ข้อความเตือนในการนำเข้า หากไม่มีจะเป็น null

การตอบกลับเมื่อผิดพลาด

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

รหัสสถานะ

รหัสสถานะ คำอธิบาย
200 สำเร็จ
400 พารามิเตอร์ไม่ถูกต้อง
401 ไม่ได้รับอนุญาต
403 สิทธิ์ไม่เพียงพอ หรือ API Key ยังไม่ได้เปิดสิทธิ์การจัดการเวอร์ชัน
429 คำขอถี่เกินไป
500 ข้อผิดพลาดของเซิร์ฟเวอร์