AI Series Interview 7: Paano Maayos na Tukuyin ang isang Skill

Una: Pangunahing Konsepto ng Skill

Ang Skill ay isang hanay ng mga kakayahang maipapatupad na nakapaloob sa isang Agent o AI system. Karaniwan itong naglalaman ng:

• Trigger condition: Kailan ito tatawagin (hal. utos ng user, system event).
• Input parameters: Data o konteksto na kailangang matanggap.
• Execution logic: Mga tiyak na hakbang sa pagproseso (hal. pagtawag ng API, pagpapatakbo ng code, pag-query sa knowledge base).
• Output result: Tugon o aksyon na ibabalik sa tumawag.

Ikalawa: Mga Hakbang sa Maayos na Pagtukoy ng Skill

1. Tukuyin ang Pangalan at Paglalarawan ng Skill

• Pangalan: Maikli, natatangi, semantiko (hal. search_web, send_email).
• Paglalarawan: Isang pangungusap na nagpapaliwanag ng function ng Skill, para madaling matugma ng Agent.

2. Tukuyin ang Input Parameters (Input Schema)

Gamitin ang JSON Schema o katulad na format, tukuyin ang uri ng bawat parameter, kung kinakailangan, default value, at mga hadlang.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search keyword",
      "required": true
    },
    "max_results": {
      "type": "integer",
      "description": "Maximum number of results",
      "default": 10
    }
  }
}

3. Isulat ang Execution Logic

• Deterministic logic: Direktang tumawag ng function, API, o database.
• Non-deterministic logic: Gumamit ng LLM para bumuo ng tugon (kailangan magbigay ng prompt template).
• Error handling: Tukuyin ang timeout, retry, at degradation strategies.

4. Tukuyin ang Output Format (Output Schema)

Gamitin din ang JSON Schema para ilarawan ang istruktura ng ibinabalik na data.

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

5. Magdagdag ng Metadata

• Version number: Para sa madaling pamamahala ng pag-ulit.
• Author/maintainer: Pananagutan.
• Dependencies: Mga panlabas na serbisyo o library na kailangan.
• Usage restrictions: Hal. rate limit, permission requirements.

Ikatlo: Halimbawa ng Kumpletong Depinisyon ng Skill

name: "weather_query"
description: "Kunin ang kasalukuyang panahon batay sa pangalan ng lungsod"
version: "1.0.0"
author: "AI Team"

input:
  type: object
  properties:
    city:
      type: string
      description: "Pangalan ng lungsod, hal. 'Manila'"
      required: true
    unit:
      type: string
      enum: ["celsius", "fahrenheit"]
      default: "celsius"

execute:
  - step: "Tawagan ang weather API"
    api: "https://api.weather.com/v1/current"
    method: "GET"
    params:
      city: "{input.city}"
      unit: "{input.unit}"
  - step: "I-format ang resulta"
    format: "Ang temperatura sa {city} ay {temperature}°{unit}"

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

Ikaapat: Pinakamahusay na Kasanayan

• Single responsibility: Bawat Skill ay gumagawa lamang ng isang bagay, iwasan ang sobrang coupling.
• Self-contained: Hangga't maaari, huwag umasa sa panlabas na global state; input ay output.
• Testable: Magbigay ng mock data o sandbox environment para sa unit testing.
• Documented: Sumulat ng mga tagubilin at halimbawa para sa bawat Skill.

Sa pamamagitan ng mga pamamaraang ito, ang Skill ay maaaring dynamic na i-iskedyul ng AI Agent, at direktang isama ng mga developer sa system, na nagreresulta sa reusability na "write once, use everywhere".