AI seriýa söhbetdeşlik 7: Bir Skill-i nädip kadalaşdyryp kesgitlemeli

Bir, Skill-iň esasy düşünjesi

Skill, Agent (akylly agent) ýa-da AI ulgamynda bir topar ýerine ýetirip boljak ukyplary öz içine alýan birlikdir. Ol adatça:

• Işjeňleşdirme şerti: Haçan çagyrylýar (meselem, ulanyjy buýrugy, ulgam wakasy).
• Giriş parametrleri: Kabul etmeli maglumatlar ýa-da kontekst.
• Ýerine ýetiriş logikasy: Anyk işlenme ädimleri (meselem, API çagyrmak, kod işletmek, bilim bazasyndan sorag etmek).
• Çykyş netijesi: Çagyrana jogap ýa-da hereket.

Iki, Skill-i kadalaşdyryp kesgitlemek ädimleri

1. Skill-iň adyny we beýanyny anyklaň

• Ady: Gysga, üýtgeşik, manyly (meselem search_web, send_email).
• Beýany: Bir sözlem bilen Skill-iň funksiýasyny düşündiriň, Agent awtomatik gabat getirsin.

2. Giriş parametrlerini kesgitlemek (Input Schema)

JSON Schema ýa-da şuňa meňzeş format ulanyp, her parametriň görnüşini, hökmanylygyny, başlangyç bahasyny we çäklendirmelerini anyklaň.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Gözleg sözi",
      "required": true
    },
    "max_results": {
      "type": "integer",
      "description": "Iň köp gaýtaryljak netije sany",
      "default": 10
    }
  }
}

3. Ýerine ýetiriş logikasyny ýazyň (Execution Logic)

• Anyk logika: Funksiýa, API ýa-da maglumat bazasyna gönüden-göni çagyryş.
• Anyk däl logika: Jogap döretmek üçin LLM ulanyň (prompt şablonyny üpjün ediň).
• Ýalňyşlyklary işlemek: Wagty gutarmak, gaýtadan synanyşmak, peseltme strategiýalaryny kesgitleň.

4. Çykyş formatyny kesgitlemek (Output Schema)

Şeýle hem JSON Schema ulanyp, gaýtarylýan maglumat gurluşyny suratlandyryň.

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

5. Goşmaça metadatalar (Metadata)

• Wersiýa belgisi: Dolandyrmagy ýeňilleşdirýär.
• Awtor/goraýjy: Jogapkärçilik degişliligi.
• Baglylyklar: Gerekli daşarky hyzmatlar ýa-da kitaphanalar.
• Ulanyş çäklendirmeleri: Meselem, ýygylyk çäklendirmeleri, rugsat talaplary.

Üç, Mysal: Doly Skill kesgitlemesi

name: "weather_query"
description: "Şäher ady boýunça häzirki howany sorag et"
version: "1.0.0"
author: "AI Topary"

input:
  type: object
  properties:
    city:
      type: string
      description: "Şäher ady, mysal üçin 'Aşgabat'"
      required: true
    unit:
      type: string
      enum: ["celsius", "fahrenheit"]
      default: "celsius"

execute:
  - step: "Howa API-ny çagyr"
    api: "https://api.weather.com/v1/current"
    method: "GET"
    params:
      city: "{input.city}"
      unit: "{input.unit}"
  - step: "Netijäni formatla"
    format: "Häzirki {city} temperaturada {temperature}°{unit}"

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

Dört, Iň gowy amallar

• Ýeke-täk jogapkärçilik: Her Skill diňe bir iş edýär, aşa baglylykdan gaça duruň.
• Öz-özüni saklaýan: Daşarky global ýagdaýa bagly bolmazlyga çalyşyň, giriş çykyşy kesgitleýär.
• Synag edip bolýan: Unit synaglar üçin mock maglumatlar ýa-da peseldilen gurşaw üpjün ediň.
• Dokumentleşdirilen: Her Skill üçin ulanyş görkezmesi we mysallar ýazyň.

Ýokardaky usullar bilen kesgitlenen Skill, AI Agent tarapyndan dinamiki ýerleşdirilip bilner, şeýle hem döredijiler tarapyndan gönüden-göni ulgama birleşdirilip, "bir gezek ýaz, hemme ýerde ulan" gaýtadan ulanyş täsirini gazanyp bolar.