AI serieko elkarrizketa 7: Nola definitu Skill bat modu arautuan

一、Skill-aren kontzeptu nagusia

Skill Agente edo AI sistema batean bildutako exekutagarriak diren gaitasun-unitateen multzoa da. Normalean honako hauek biltzen ditu:

• Abiarazte-baldintza: Noiz deitzen den (adibidez, erabiltzailearen agindua, sistemaren gertaera).
• Sarrerako parametroak: Jaso beharreko datuak edo testuingurua.
• Exekuzio-logika: Prozesamenduaren urrats zehatzak (adibidez, APIa deitzea, kodea exekutatzea, ezagutza-basea galdetzea).
• Irteerako emaitza: Deitzaileari itzultzen zaion erantzuna edo ekintza.

二、Skill bat modu arautuan definitzeko urratsak

1. Skill-aren izena eta deskribapena zehaztu

• Izena: Laburra, bakarra, semantikoa (adibidez, search_web, send_email).
• Deskribapena: Esaldi batean Skill-aren funtzioa azaldu, Agenteak automatikoki parekatzeko.

2. Sarrerako parametroak definitu (Input Schema)

Erabili JSON Schema edo antzeko formatua, parametro bakoitzaren mota, beharrezkoa den, lehenetsitako balioa eta murrizketak zehazteko.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Bilaketa-hitza",
      "required": true
    },
    "max_results": {
      "type": "integer",
      "description": "Gehienezko emaitza kopurua",
      "default": 10
    }
  }
}

3. Exekuzio-logika idatzi (Execution Logic)

• Logika determinista: Zuzenean funtzioak, APIak edo datu-baseak deitu.
• Logika ez-determinista: Erabili LLM erantzunak sortzeko (prompt txantiloia eman behar da).
• Errore-kudeaketa: Denbora-muga, berreskurapen eta degradazio estrategiak definitu.

4. Irteerako formatua definitu (Output Schema)

Era berean, erabili JSON Schema itzultzen den datu-egitura deskribatzeko.

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

5. Metadatuak gehitu (Metadata)

• Bertsio-zenbakia: Iterazioen kudeaketa errazteko.
• Egilea/mantentzailea: Erantzukizunaren esleipena.
• Mendekotasunak: Kanpoko zerbitzu edo liburutegi beharrezkoak.
• Erabilera-murrizketak: Adibidez, maiztasun-muga, baimen-eskakizunak.

三、Adibidea: Skill definizio oso bat

name: "weather_query"
description: "Hiriaren izenaren arabera egungo eguraldia kontsultatu"
version: "1.0.0"
author: "AI Team"

input:
  type: object
  properties:
    city:
      type: string
      description: "Hiriaren izena, adibidez 'Beijing'"
      required: true
    unit:
      type: string
      enum: ["celsius", "fahrenheit"]
      default: "celsius"

execute:
  - step: "Eguraldi APIa deitu"
    api: "https://api.weather.com/v1/current"
    method: "GET"
    params:
      city: "{input.city}"
      unit: "{input.unit}"
  - step: "Emaitza formateatu"
    format: "Orain {city} hirian tenperatura {temperature}°{unit} da"

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

四、Praktika onenak

• Erantzukizun bakarra: Skill bakoitzak gauza bakarra egin behar du, gehiegizko akoplamendua saihestuz.
• Autonomoa: Ahal den neurrian, ez kanpoko egoera orokorretan oinarritu; sarrera = irteera.
• Probagarria: Eman mock datuak edo harea-kutxa ingurunea unitate-probetarako.
• Dokumentatua: Skill bakoitzarentzat erabilera-argibideak eta adibideak idatzi.

Goiko metodoen bidez definitutako Skill-ak AI Agenteak dinamikoki programatu ditzake, eta garatzaileek ere zuzenean sisteman integra ditzakete, "behin idatzi, nonahi erabili" berrerabilpen efektua lortuz.