Intervistë seri AI 7: Si të përcaktohet një Skill në mënyrë standarde

Një: Konceptet kryesore të Skill

Skill është një grup njësish të ekzekutueshme të kapsuluara në një Agent ose sistem AI. Zakonisht përfshin:

• Kushtet e nxitjes: Kur thirret (p.sh. komanda e përdoruesit, ngjarje sistemi).
• Parametrat hyrës: Të dhënat ose konteksti që duhet të marrë.
• Logjika e ekzekutimit: Hapat e përpunimit specifik (p.sh. thirrje API, ekzekutim kodi, kërkim në bazën e njohurive).
• Rezultati dalës: Përgjigja ose veprimi i kthyer te thirrësi.

Dy: Hapat për përcaktimin standard të një Skill

1. Përcakto emrin dhe përshkrimin e Skill

• Emri: I shkurtër, unik, semantik (p.sh. search_web, send_email).
• Përshkrimi: Një fjali që shpjegon funksionin e Skill, për të lehtësuar përputhjen automatike nga Agent.

2. Përcakto parametrat hyrës (Input Schema)

Përdor JSON Schema ose format të ngjashëm, duke specifikuar llojin e secilit parametër, nëse është i detyrueshëm, vlerën default dhe kufizimet.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Fjalë kyçe për kërkim",
      "required": true
    },
    "max_results": {
      "type": "integer",
      "description": "Numri maksimal i rezultateve të kthyera",
      "default": 10
    }
  }
}

3. Shkruaj logjikën e ekzekutimit (Execution Logic)

• Logjikë e përcaktuar: Thirrje direkte të funksioneve, API ose bazave të të dhënave.
• Logjikë e papërcaktuar: Përdor LLM për të gjeneruar përgjigje (duhet të ofrojë template prompt).
• Trajtimi i gabimeve: Përcakto strategji për timeout, ripërpjekje, ulje të nivelit.

4. Përcakto formatin dalës (Output Schema)

Po ashtu përdor JSON Schema për të përshkruar strukturën e të dhënave të kthyera.

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

5. Metadata shtesë (Metadata)

• Numri i versionit: Për menaxhim të përsëritjeve.
• Autori/mirëmbajtësi: Përgjegjësia.
• Varësitë: Shërbime ose biblioteka të jashtme të nevojshme.
• Kufizimet e përdorimit: P.sh. kufizime frekuence, kërkesa për leje.

Tre: Shembull i një përkufizimi të plotë të Skill

name: "weather_query"
description: "Kërko motin aktual sipas emrit të qytetit"
version: "1.0.0"
author: "Ekipi AI"

input:
  type: object
  properties:
    city:
      type: string
      description: "Emri i qytetit, p.sh. 'Pekini'"
      required: true
    unit:
      type: string
      enum: ["celsius", "fahrenheit"]
      default: "celsius"

execute:
  - step: "Thirr API-në e motit"
    api: "https://api.weather.com/v1/current"
    method: "GET"
    params:
      city: "{input.city}"
      unit: "{input.unit}"
  - step: "Formato rezultatin"
    format: "Aktualisht temperatura në {city} është {temperature}°{unit}"

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

Katër: Praktikat më të mira

• Përgjegjësi e vetme: Secili Skill bën vetëm një gjë, shmang bashkimin e tepërt.
• Vetëpërmbajtje: Të mos varet nga gjendja globale e jashtme, hyrja është dalja.
• Testueshmëri: Ofro të dhëna mock ose mjedis sandbox për testim njësi.
• Dokumentim: Shkruaj udhëzime përdorimi dhe shembuj për secilin Skill.

Me metodat e mësipërme, Skill i përcaktuar mund të orkestrohet dinamikisht nga AI Agent dhe gjithashtu të integrohet drejtpërdrejt nga zhvilluesit në sistem, duke arritur ripërdorimin “shkruaj një herë, përdor kudo”.