AI сериясы сұхбат 7: Дағдыны қалай стандартты түрде анықтауға болады

1. Дағдының негізгі тұжырымдамасы

Дағды – Агент немесе AI жүйесінде жинақталған орындалатын мүмкіндіктер бірлігі. Ол әдетте мыналарды қамтиды:

• Іске қосу шарты: Қашан шақырылады (мысалы, пайдаланушы нұсқауы, жүйе оқиғасы).
• Кіріс параметрлері: Қабылдауға қажетті деректер немесе контекст.
• Орындау логикасы: Нақты өңдеу қадамдары (мысалы, API шақыру, кодты іске қосу, білім қорын сұрау).
• Шығыс нәтижесі: Шақырушыға қайтарылатын жауап немесе әрекет.

2. Дағдыны стандартты анықтау қадамдары

1. Дағдының атауы мен сипаттамасын нақтылау

• Атауы: Қысқа, бірегей, мағыналы (мысалы, search_web, send_email).
• Сипаттамасы: Бір сөйлеммен дағдының функциясын түсіндіру, Агенттің автоматты түрде сәйкестендіруіне ыңғайлы.

2. Кіріс параметрлерін анықтау (Input Schema)

JSON Schema немесе ұқсас пішімді қолданып, әр параметрдің түрін, міндеттілігін, әдепкі мәнін және шектеулерін нақтылаңыз.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Іздеу сөзі",
      "required": true
    },
    "max_results": {
      "type": "integer",
      "description": "Қайтарылатын нәтижелердің максималды саны",
      "default": 10
    }
  }
}

3. Орындау логикасын жазу (Execution Logic)

• Детерминирленген логика: Функцияны, API немесе дерекқорды тікелей шақыру.
• Детерминирленбеген логика: LLM көмегімен жауап генерациялау (prompt үлгісін қамтамасыз ету).
• Қателерді өңдеу: Уақыт аяқталу, қайталау, төмендету стратегияларын анықтау.

4. Шығыс пішімін анықтау (Output Schema)

Сол сияқты JSON Schema қолданып, қайтарылатын деректер құрылымын сипаттаңыз.

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

5. Қосымша метадеректер (Metadata)

• Нұсқа нөмірі: Итерациялық басқаруға ыңғайлы.
• Автор/жауапты тұлға: Жауапкершілік.
• Тәуелділіктер: Қажетті сыртқы қызметтер немесе кітапханалар.
• Пайдалану шектеулері: Жиілік шектеулері, рұқсат талаптары.

3. Мысал: Толық дағды анықтамасы

name: "weather_query"
description: "Қала атауы бойынша ағымдағы ауа райын сұрау"
version: "1.0.0"
author: "AI Team"

input:
  type: object
  properties:
    city:
      type: string
      description: "Қала атауы, мысалы 'Алматы'"
      required: true
    unit:
      type: string
      enum: ["celsius", "fahrenheit"]
      default: "celsius"

execute:
  - step: "Ауа райы API шақыру"
    api: "https://api.weather.com/v1/current"
    method: "GET"
    params:
      city: "{input.city}"
      unit: "{input.unit}"
  - step: "Нәтижені пішімдеу"
    format: "Қазіргі {city} температурасы {temperature}°{unit}"

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

4. Үздік тәжірибелер

• Бірыңғай жауапкершілік: Әр дағды тек бір нәрсені істеуі керек, шамадан тыс байланыстан аулақ болыңыз.
• Өзін-өзі қамту: Сыртқы жаһандық күйге тәуелді болмауға тырысыңыз, кіріс – шығыс.
• Тестілеуге жарамды: Бірлік тестілеу үшін mock деректер немесе құмсалғыш ортаны қамтамасыз етіңіз.
• Құжаттандыру: Әр дағды үшін пайдалану нұсқаулығы мен мысалдар жазыңыз.

Жоғарыдағы әдістермен анықталған дағдыны AI Агент динамикалық түрде жоспарлай алады, сонымен қатар әзірлеушілер жүйеге тікелей біріктіріп, "бір рет жазып, барлық жерде қолдану" қайта пайдалану әсеріне қол жеткізе алады.