Serje ta' Intervisti AI 7: Kif Tiddefinixxi Skill b'mod Standard

1. Kunċett Ewlieni ta' Skill

Skill hija sett ta' unitajiet ta' kapaċità eżekutibbli inkapsulati f'Agent jew Sistema AI. Tipikament tinkludi:

• Kundizzjoni ta' Attivazzjoni: Meta tiġi msejħa (eż., kmand tal-utent, avveniment tas-sistema).
• Parametri ta' Input: Data jew kuntest li għandhom jiġu riċevuti.
• Loġika ta' Eżekuzzjoni: Passi speċifiċi ta' proċessar (eż., sejħa API, tmexxija ta' kodiċi, mistoqsija ta' bażi ta' għarfien).
• Riżultat ta' Output: Risposta jew azzjoni li tintbagħat lura lill-kallier.

2. Passi biex Tiddefinixxi Skill b'mod Standard

1. Speċifika l-Isem u d-Deskrizzjoni tal-Skill

• Isem: Qasir, uniku, semantiku (eż., search_web, send_email).
• Deskrizzjoni: Sentenza waħda li tispjega l-funzjoni tal-Skill, biex tgħin lill-Agent jaqbel awtomatikament.

2. Iddefinixxi l-Parametri ta' Input (Input Schema)

Uża JSON Schema jew format simili, speċifika t-tip ta' kull parametru, jekk huwiex obbligatorju, valur default u restrizzjonijiet.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Kliem ewlieni tat-tfittxija",
      "required": true
    },
    "max_results": {
      "type": "integer",
      "description": "Numru massimu ta' riżultati li jridu jintbagħtu lura",
      "default": 10
    }
  }
}

3. Ikteb il-Loġika ta' Eżekuzzjoni (Execution Logic)

• Loġika Determinata: Sejħa diretta ta' funzjoni, API jew database.
• Loġika Mhux Determinata: Uża LLM biex tiġġenera risposta (ipprovdi template ta' prompt).
• Immaniġġjar ta' Żbalji: Iddefinixxi timeout, retry, strateġiji ta' degradazzjoni.

4. Iddefinixxi l-Format tal-Output (Output Schema)

Uża wkoll JSON Schema biex tiddeskrivi l-istruttura tad-data li tintbagħat lura.

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

5. Metadata Addizzjonali (Metadata)

• Numru tal-Verżjoni: Għall-ġestjoni tal-iterazzjonijiet.
• Awtur/Mantenitur: Responsabbiltà.
• Dipendenza: Servizzi jew libreriji esterni meħtieġa.
• Limitazzjonijiet ta' Użu: Eż., limiti ta' frekwenza, rekwiżiti ta' permessi.

3. Eżempju: Definizzjoni Kompleta ta' Skill

name: "weather_query"
description: "Staqsi t-temp kurrenti skont l-isem tal-belt"
version: "1.0.0"
author: "Tim AI"

input:
  type: object
  properties:
    city:
      type: string
      description: "Isem tal-belt, eż. 'Beijing'"
      required: true
    unit:
      type: string
      enum: ["celsius", "fahrenheit"]
      default: "celsius"

execute:
  - step: "Sejħa API tat-temp"
    api: "https://api.weather.com/v1/current"
    method: "GET"
    params:
      city: "{input.city}"
      unit: "{input.unit}"
  - step: "Ifformatta r-riżultat"
    format: "It-temperatura kurrenti f'{city}' hija {temperature}°{unit}"

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

4. L-Aħjar Prattiki

• Responsabbiltà Unika: Kull Skill tagħmel ħaġa waħda biss, evita akkoppjar eċċessiv.
• Awto-Kontenut: Kemm jista' jkun, tiddependix fuq stat globali estern; input jagħti output.
• Testabbli: Ipprovdi data mock jew ambjent sandbox għal testijiet tal-unità.
• Dokumentat: Ikteb struzzjonijiet ta' użu u eżempji għal kull Skill.

Billi ssegwi l-metodi ta' hawn fuq, Skill definita tista' tiġi skedata b'mod dinamiku minn AI Agent, kif ukoll integrata direttament minn żviluppaturi fis-sistema, biex jinkiseb effett ta' użu mill-ġdid "ikteb darba, uża kullimkien".