สร้าง Skill

รองรับการสร้าง Skill ระดับองค์กร หรือ Skill ส่วนตัวของ Agent ที่ระบุ ภายใต้องค์กรที่ระบุ

คุณสามารถใช้อินเทอร์เฟซนี้เพื่อสร้าง Skill ระดับองค์กรภายใต้องค์กรที่ระบุ หรือสร้าง Skill ส่วนตัวของ Agent ที่ระบุ

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

POST

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

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

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

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

การร้องขอ

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

curl -X POST 'https://api.${endpoint}/v1/org/skill/create' \ -H 'Authorization: Basic ${BASIC_TOKEN}' \ -H 'Content-Type: application/json' \ -d '{ "org_id": "p-xxxx", "name": "refund-policy", "display_name": "退款政策", "description": { "en_US": "Handling customer refund requests", "zh_CN": "处理客户退款请求" }, "owner_agent_id": "bot-xxxx" }'

                      
                      curl -X POST 'https://api.${endpoint}/v1/org/skill/create' \
  -H 'Authorization: Basic ${BASIC_TOKEN}' \
  -H 'Content-Type: application/json' \
  -d '{
    "org_id": "p-xxxx",
    "name": "refund-policy",
    "display_name": "退款政策",
    "description": {
      "en_US": "Handling customer refund requests",
      "zh_CN": "处理客户退款请求"
    },
    "owner_agent_id": "bot-xxxx"
  }'

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

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

พารามิเตอร์การร้องขอ (Body Parameters)

พารามิเตอร์	ประเภท	คำอธิบาย	required
org_id	String	ID ขององค์กร	true
name	String	ชื่อ Skill สูงสุด 50 อักขระ	true
display_name	String	ชื่อที่แสดงของ Skill สูงสุด 50 อักขระ	false
description	Object	คำอธิบาย Skill แบบหลายภาษา ต้องมี `en_US`	true
owner_agent_id	String	ID ของ Agent ที่เป็นเจ้าของ Skill ส่วนตัว หากไม่ระบุจะสร้างเป็น Skill ระดับองค์กร	false

การตอบกลับ

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

{ "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"
  }
}