อัปเดต Skill องค์กร

การระบุ skill_id สามารถใช้เพื่ออัปเดต Skill ขององค์กรที่ระบุได้ เมื่ออัปเดตเสร็จสิ้นจะเผยแพร่โดยอัตโนมัติทันที

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

POST

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

https://api.${endpoint}/v1/org/skill/update

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

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

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

curl -X POST 'https://api.${endpoint}/v1/org/skill/update' \ -H 'Authorization: Basic ${BASIC_TOKEN}' \ -F 'org_id=org-xxxx' \ -F 'skill_id=skill-xxxx' \ -F 'file=@/path/to/refund-policy-v2.skill' \ -F 'category_id=category-xxxx'

                      
                      curl -X POST 'https://api.${endpoint}/v1/org/skill/update' \
  -H 'Authorization: Basic ${BASIC_TOKEN}' \
  -F 'org_id=org-xxxx' \
  -F 'skill_id=skill-xxxx' \
  -F 'file=@/path/to/refund-policy-v2.skill' \
  -F 'category_id=category-xxxx'

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

พารามิเตอร์ Form Data

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

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

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

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

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

ฟิลด์	คำอธิบาย
`skill_id`	ID ของ Skill แบบแชร์ขององค์กรที่อัปเดตแล้ว
`name`	`name` ใน frontmatter ของ `SKILL.md` ในแพ็กเกจครั้งนี้
`owner_type`	คงที่เป็น `ORGANIZATION`

ขอบเขตการเรียกใช้

อัปเดตเฉพาะ Skill แบบแชร์ที่ owner_type=ORGANIZATION และยังไม่ได้ผูกกับ Agent เท่านั้น
Skill ส่วนตัวของ Agent, ระเบียนส่วนตัวในอดีตที่มี bot_id และ SYSTEM Skill จะถูกปฏิเสธทั้งหมด
รองรับเฉพาะ .skill, .zip เท่านั้น ขนาดแพ็กเกจสูงสุด 20 MiB ต้องมี SKILL.md และ frontmatter ต้องมี name
POST /v1/org/skill/import ใช้สำหรับสร้าง Skill ขององค์กรเท่านั้น ไม่รองรับความหมายของการอัปเดต