Siri Temuduga AI 7: Cara Mentakrifkan Skill Secara Standard

Satu: Konsep Teras Skill

Skill ialah unit keupayaan boleh laksana yang dibungkus dalam Agent (agen pintar) atau sistem AI. Ia biasanya mengandungi:

• Keadaan pencetus: Bila ia dipanggil (contohnya arahan pengguna, peristiwa sistem).
• Parameter input: Data atau konteks yang perlu diterima.
• Logik pelaksanaan: Langkah pemprosesan khusus (contohnya panggilan API, menjalankan kod, pertanyaan pangkalan pengetahuan).
• Output hasil: Respons atau tindakan yang dikembalikan kepada pemanggil.

Dua: Langkah Mentakrifkan Skill Secara Standard

1. Nyatakan Nama dan Penerangan Skill

• Nama: Ringkas, unik, semantik (contohnya search_web, send_email).
• Penerangan: Satu ayat menerangkan fungsi Skill ini, memudahkan padanan automatik oleh Agent.

2. Takrifkan Parameter Input (Input Schema)

Gunakan JSON Schema atau format serupa, nyatakan jenis setiap parameter, sama ada wajib, nilai lalai, dan kekangan.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Kata kunci carian",
      "required": true
    },
    "max_results": {
      "type": "integer",
      "description": "Bilangan hasil maksimum",
      "default": 10
    }
  }
}

3. Tulis Logik Pelaksanaan (Execution Logic)

• Logik pasti: Panggil fungsi, API atau pangkalan data secara langsung.
• Logik tidak pasti: Gunakan LLM untuk menjana respons (perlu sediakan templat prompt).
• Pengendalian ralat: Takrifkan tamat masa, percubaan semula, strategi penurunan.

4. Takrifkan Format Output (Output Schema)

Gunakan JSON Schema untuk menerangkan struktur data yang dikembalikan.

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

5. Metadata Tambahan (Metadata)

• Nombor versi: Memudahkan pengurusan lelaran.
• Pengarang/penyelenggara: Tanggungjawab pemilikan.
• Kebergantungan: Perkhidmatan atau pustaka luaran yang diperlukan.
• Had penggunaan: Seperti had kekerapan, keperluan kebenaran.

Tiga: Contoh: Definisi Skill Lengkap

name: "weather_query"
description: "Dapatkan cuaca semasa berdasarkan nama bandar"
version: "1.0.0"
author: "Pasukan AI"

input:
  type: object
  properties:
    city:
      type: string
      description: "Nama bandar, seperti 'Beijing'"
      required: true
    unit:
      type: string
      enum: ["celsius", "fahrenheit"]
      default: "celsius"

execute:
  - step: "Panggil API cuaca"
    api: "https://api.weather.com/v1/current"
    method: "GET"
    params:
      city: "{input.city}"
      unit: "{input.unit}"
  - step: "Format hasil"
    format: "Suhu semasa di {city} ialah {temperature}°{unit}"

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

Empat: Amalan Terbaik

• Tanggungjawab tunggal: Setiap Skill hanya melakukan satu perkara, elakkan gandingan berlebihan.
• Berdiri sendiri: Cuba jangan bergantung pada keadaan global luaran, input menghasilkan output.
• Boleh diuji: Sediakan data mock atau persekitaran kotak pasir untuk ujian unit.
• Dokumentasi: Tulis panduan penggunaan dan contoh untuk setiap Skill.

Skill yang ditakrifkan melalui kaedah di atas boleh dijadualkan secara dinamik oleh AI Agent, dan juga boleh diintegrasikan terus oleh pembangun ke dalam sistem, mencapai kesan guna semula "tulis sekali, guna di mana-mana".