สร้าง Skill ส่วนตัวของ Agent

สร้าง Skill ส่วนตัวของ Agent

คุณสามารถใช้อินเทอร์เฟซนี้เพื่อสร้าง Skill ส่วนตัวของ LoopAgent ที่ Agent API Key ปัจจุบันสังกัดอยู่

  • รองรับเฉพาะ LoopAgent เท่านั้น ส่วน Agent ทั่วไป, Flow Agent และ Workflow ไม่รองรับ
  • สร้างได้เฉพาะ Skill ส่วนตัวของ Agent ที่ Agent API Key ปัจจุบันสังกัดอยู่เท่านั้น
  • รองรับเฉพาะ .skill, .zip เท่านั้น ขนาดแพ็กเกจสูงสุด 20 MiB, มีไฟล์ที่ใช้ได้สูงสุด 200 ไฟล์, ไฟล์เดียวหลังแตกไฟล์สูงสุด 5 MiB และทั้งแพ็กเกจหลังแตกไฟล์สูงสุด 64 MiB
  • ในไดเรกทอรีรากของแพ็กเกจ หรือภายใต้ไดเรกทอรีระดับบนสุดเพียงหนึ่งเดียว ต้องมี SKILL.md และ frontmatter ต้องมี name
  • การสร้างจะไม่ผูก Skill เข้ากับ Agent โดยอัตโนมัติ และจะไม่บันทึกหรือเผยแพร่เวอร์ชันของ Agent โดยอัตโนมัติ

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

POST

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

https://api.${endpoint}/v1/agent/skill/create

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

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

การร้องขอ

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

curl -X POST 'https://api.${endpoint}/v1/agent/skill/create' \ -H 'Authorization: Bearer ${API Key}' \ -F 'file=@/path/to/refund-policy.skill'
                      
                      curl -X POST 'https://api.${endpoint}/v1/agent/skill/create' \
  -H 'Authorization: Bearer ${API Key}' \
  -F 'file=@/path/to/refund-policy.skill'

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

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

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

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

พารามิเตอร์ ประเภท บังคับ คำอธิบาย
file File ใช่ แพ็กเกจ Skill แบบ .skill หรือ .zip
category_id String ไม่ ID หมวดหมู่ Skill หากไม่ส่งจะสร้างเป็นหมวดหมู่ว่าง

การตอบกลับ

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

{ "code": 0, "message": "OK", "data": { "skill_id": "skill-xxxx", "name": "refund_policy", "version": "1.0.0" } }
                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "skill_id": "skill-xxxx",
    "name": "refund_policy",
    "version": "1.0.0"
  }
}

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

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

ฟิลด์ ประเภท คำอธิบาย
skill_id String ID ของ Skill ที่สร้างใหม่
name String ชื่อ Skill
version String หมายเลขเวอร์ชันของ Skill

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

ฟิลด์ ประเภท คำอธิบาย
code Integer รหัสข้อผิดพลาด
message String รายละเอียดข้อผิดพลาด

รหัสสถานะ

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