สร้าง 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 | ข้อผิดพลาดของเซิร์ฟเวอร์ |
