AI စီးရီးအင်တာဗျူး ၇: Skill တစ်ခုကို စံချိန်စံညွှန်းသတ်မှတ်နည်း

၁။ Skill ၏ အဓိက သဘောတရား

Skill ဆိုသည်မှာ Agent (အေးဂျင့်) သို့မဟုတ် AI စနစ် တွင် ထည့်သွင်းထားသော လုပ်ဆောင်နိုင်သည့် ယူနစ်တစ်ခုဖြစ်သည်။ ၎င်းတွင် ပုံမှန်အားဖြင့် ပါဝင်သည်-

• အစပျိုးအခြေအနေ : မည်သည့်အချိန်တွင် ခေါ်ယူမည် (ဥပမာ အသုံးပြုသူညွှန်ကြားချက်၊ စနစ်ဖြစ်ရပ်)။
• ထည့်သွင်းဘောင်များ : လက်ခံရယူရန် လိုအပ်သော ဒေတာ သို့မဟုတ် ဆက်စပ်အကြောင်းအရာ။
• လုပ်ဆောင်မှုယုတ္တိ : တိကျသော လုပ်ဆောင်ခြင်းအဆင့်များ (ဥပမာ API ခေါ်ဆိုခြင်း၊ ကုဒ်လည်ပတ်ခြင်း၊ အသိပညာဒေတာဘေ့စ်ကို မေးမြန်းခြင်း)။
• ထုတ်ပေးရလဒ် : ခေါ်ဆိုသူထံ ပြန်လည်ပေးပို့သော တုံ့ပြန်မှု သို့မဟုတ် လုပ်ဆောင်ချက်။

၂။ Skill ကို စံချိန်စံညွှန်းသတ်မှတ်ရန် အဆင့်များ

၁။ Skill ၏ အမည်နှင့် ဖော်ပြချက်ကို ရှင်းလင်းစွာသတ်မှတ်ပါ

• အမည် : အတိုချုံး၊ တစ်ခုတည်းသော၊ အဓိပ္ပါယ်ရှိသော (ဥပမာ search_web၊ send_email)။
• ဖော်ပြချက် : Skill ၏ လုပ်ဆောင်ချက်ကို ဝါကျတစ်ကြောင်းဖြင့် ဖော်ပြပါ။ Agent က အလိုအလျောက် ကိုက်ညီမှုရှာရန် အထောက်အကူဖြစ်စေသည်။

၂။ ထည့်သွင်းဘောင်များကို သတ်မှတ်ပါ (Input Schema)

JSON Schema သို့မဟုတ် အလားတူပုံစံကို သုံး၍ ဘောင်တစ်ခုချင်းစီ၏ အမျိုးအစား၊ မဖြစ်မနေလိုအပ်မှု၊ မူလတန်ဖိုးနှင့် ကန့်သတ်ချက်များကို ရှင်းလင်းစွာသတ်မှတ်ပါ။

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "ရှာဖွေရန် သော့ချက်စာလုံး",
      "required": true
    },
    "max_results": {
      "type": "integer",
      "description": "အများဆုံးပြန်ပို့ရမည့် ရလဒ်အရေအတွက်",
      "default": 10
    }
  }
}

၃။ လုပ်ဆောင်မှုယုတ္တိကို ရေးသားပါ (Execution Logic)

• သေချာသော ယုတ္တိ : လုပ်ဆောင်ချက်၊ API သို့မဟုတ် ဒေတာဘေ့စ်ကို တိုက်ရိုက်ခေါ်ယူပါ။
• မသေချာသော ယုတ္တိ : LLM ကို သုံး၍ တုံ့ပြန်မှုထုတ်လုပ်ရန် (prompt template ပေးရန် လိုအပ်သည်)။
• အမှားကိုင်တွယ်ခြင်း : အချိန်ကုန်ခြင်း၊ ပြန်လည်ကြိုးစားခြင်း၊ အဆင့်လျှော့ချခြင်းမဟာဗျူဟာများကို သတ်မှတ်ပါ။

၄။ ထုတ်ပေးပုံစံကို သတ်မှတ်ပါ (Output Schema)

JSON Schema ကို သုံး၍ ပြန်ပို့သည့် ဒေတာဖွဲ့စည်းပုံကို ဖော်ပြပါ။

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": { "type": "string" },
          "url": { "type": "string", "format": "uri" }
        }
      }
    }
  }
}

၅။ ထပ်ဆောင်း metadata ထည့်ပါ (Metadata)

• ဗားရှင်းနံပါတ် : ပြန်လည်ပြင်ဆင်ခြင်းကို စီမံရန်။
• ရေးသူ/ထိန်းသိမ်းသူ : တာဝန်ခံမှု။
• မှီခိုမှုများ : လိုအပ်သော ပြင်ပဝန်ဆောင်မှုများ သို့မဟုတ် library များ။
• အသုံးပြုကန့်သတ်ချက်များ : ကြိမ်နှုန်းကန့်သတ်ချက်၊ ခွင့်ပြုချက်လိုအပ်ချက်များကဲ့သို့သော။

၃။ ဥပမာ : Skill တစ်ခု၏ ပြည့်စုံသော အဓိပ္ပါယ်ဖွင့်ဆိုချက်

name: "weather_query"
description: "မြို့အမည်အလိုက် လက်ရှိရာသီဥတုကို မေးမြန်းပါ"
version: "1.0.0"
author: "AI အဖွဲ့"

input:
  type: object
  properties:
    city:
      type: string
      description: "မြို့အမည်၊ ဥပမာ 'ရန်ကုန်'"
      required: true
    unit:
      type: string
      enum: ["celsius", "fahrenheit"]
      default: "celsius"

execute:
  - step: "ရာသီဥတု API ကို ခေါ်ယူပါ"
    api: "https://api.weather.com/v1/current"
    method: "GET"
    params:
      city: "{input.city}"
      unit: "{input.unit}"
  - step: "ရလဒ်ကို ပုံစံချပါ"
    format: "လက်ရှိ {city} ၏ အပူချိန်မှာ {temperature}°{unit} ဖြစ်သည်"

output:
  type: object
  properties:
    temperature:
      type: number
    condition:
      type: string
    humidity:
      type: number

၄။ အကောင်းဆုံးအလေ့အကျင့်များ

• တစ်ခုတည်းသော တာဝန် : Skill တစ်ခုသည် အလုပ်တစ်ခုသာ လုပ်ဆောင်ပါ။ အလွန်အကျွံ ချိတ်ဆက်မှုကို ရှောင်ကြဉ်ပါ။
• မိမိဘာသာ ပါဝင်ခြင်း : ပြင်ပ global state ကို အတတ်နိုင်ဆုံး မမှီခိုပါနှင့်။ ထည့်သွင်းမှုမှ ထုတ်ပေးမှုသို့ ဖြစ်ပါစေ။
• စမ်းသပ်နိုင်ခြင်း : Unit test အတွက် mock data သို့မဟုတ် sandbox ပတ်ဝန်းကျင် ပေးပါ။
• စာရွက်စာတမ်းပြုစုခြင်း : Skill တစ်ခုချင်းစီအတွက် အသုံးပြုနည်းနှင့် ဥပမာများကို ရေးသားပါ။

အထက်ပါနည်းလမ်းများဖြင့် သတ်မှတ်ထားသော Skill သည် AI Agent မှ ဒိုင်းနမစ်ဖြင့် စီစဉ်နိုင်ရုံသာမက developer များက တိုက်ရိုက် စနစ်ထဲသို့ ပေါင်းစည်းနိုင်ပြီး "တစ်ကြိမ်ရေးပါ၊ နေရာတိုင်းသုံးပါ" ဟူသော ပြန်လည်အသုံးပြုနိုင်မှုကို ရရှိစေပါသည်။