AI انٹرویو سیریز 7: ایک مہارت کو معیاری طریقے سے کیسے بیان کریں

ایک: مہارت کا بنیادی تصور

مہارت ایجنٹ یا AI نظام میں قابل عمل صلاحیتوں کا ایک مجموعہ ہے جو کہ پیک کیا جاتا ہے۔ اس میں عام طور پر شامل ہوتے ہیں:

• محرک شرائط: کب بلایا جائے (جیسے صارف کی ہدایت، نظام کے واقعات)۔
• ان پٹ پیرامیٹرز: وہ ڈیٹا یا سیاق و سباق جو حاصل کرنے کی ضرورت ہے۔
• عمل درآمد کی منطق: مخصوص پروسیسنگ مراحل (جیسے API کال، کوڈ چلانا، علم کی بنیاد سے استفسار)۔
• آؤٹ پٹ نتائج: کال کرنے والے کو جواب یا عمل واپس کرنا۔

دو: مہارت کی معیاری تعریف کے مراحل

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)

• ورژن نمبر: تکراری انتظام کے لیے۔
• مصنف/نگہبان: ذمہ داری کی تفویض۔
• انحصاریاں: بیرونی خدمات یا لائبریریاں درکار ہیں۔
• استعمال کی پابندیاں: جیسے تعدد کی حد، اجازت کے تقاضے۔

تین: مثال: ایک مکمل مہارت کی تعریف

name: "weather_query"
description: "شہر کے نام کے مطابق موجودہ موسم پوچھیں"
version: "1.0.0"
author: "AI ٹیم"

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

چار: بہترین طریقہ کار

• واحد ذمہ داری: ہر مہارت صرف ایک کام کرے، زیادہ انضمام سے بچیں۔
• خود مکمل: جہاں ممکن ہو عالمی حالت پر انحصار نہ کریں، ان پٹ ہی آؤٹ پٹ۔
• قابل آزمائش: یونٹ ٹیسٹ کے لیے فرضی ڈیٹا یا سینڈ باکس ماحول فراہم کریں۔
• دستاویزی: ہر مہارت کے لیے استعمال کے رہنما اصول اور مثالیں لکھیں۔

مندرجہ بالا طریقوں سے بیان کردہ مہارت کو AI ایجنٹ متحرک طور پر طلب کر سکتا ہے اور ڈویلپر براہ راست نظام میں ضم کر سکتے ہیں، جس سے "ایک بار لکھیں، ہر جگہ استعمال کریں" کا دوبارہ استعمال ممکن ہوتا ہے۔