ตรวจสอบไฟล์นำเข้า Agent ล่วงหน้า

รองรับการตรวจสอบไฟล์ .bot ล่วงหน้าว่าสามารถนำเข้าได้หรือไม่ โดยไม่เขียนทรัพยากรทางธุรกิจ

คุณสามารถใช้อินเทอร์เฟซนี้เพื่อตรวจสอบล่วงหน้าว่าไฟล์ .bot สามารถนำเข้าได้หรือไม่ การตรวจสอบล่วงหน้าจะทำเพียงการแยกวิเคราะห์และสแกนความปลอดภัยของไฟล์เท่านั้น โดยไม่เขียน Agent, API Key, Skill, กลุ่มข้อมูล หรือความสัมพันธ์ของปลั๊กอิน

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

POST

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

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

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

ใช้การยืนยันตัวตนแบบ Basic ด้วย DevKey / DevSecret ระดับบัญชี และกำหนดให้บัญชีที่เรียกใช้ต้องมีสิทธิ์สร้าง Agent ขององค์กร

การร้องขอ

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

curl -X POST 'https://api.${endpoint}/v1/org/agent/import/precheck' \ -H 'Authorization: Basic ${BASIC_TOKEN}' \ -F 'file=@/path/to/agent.bot' \ -F 'org_id=p-xxxx'

                      
                      curl -X POST 'https://api.${endpoint}/v1/org/agent/import/precheck' \
  -H 'Authorization: Basic ${BASIC_TOKEN}' \
  -F 'file=@/path/to/agent.bot' \
  -F 'org_id=p-xxxx'

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

ฟิลด์	ประเภท	คำอธิบาย
Authorization	Basic ${BASIC_TOKEN}	Basic Token ที่ได้จากการเข้ารหัส Base64 ของ `DevKey:DevSecret`
Content-Type	multipart/form-data	ฟอร์มสำหรับอัปโหลดไฟล์

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

พารามิเตอร์	ประเภท	คำอธิบาย	required
file	File	ไฟล์ `.bot`	true
org_id	String	ID ขององค์กร	true

การตอบกลับ

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

{ "code": 0, "message": "OK", "data": { "valid": true, "error_message": null, "export_type": "BOT", "bot_type": "Agent", "name": "Imported Agent", "logo": "https://cdn.example.com/agent.png", "introduction": "Agent introduction", "format_version": "1.0" } }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "valid": true,
    "error_message": null,
    "export_type": "BOT",
    "bot_type": "Agent",
    "name": "Imported Agent",
    "logo": "https://cdn.example.com/agent.png",
    "introduction": "Agent introduction",
    "format_version": "1.0"
  }
}