Mahojiano ya Mfululizo wa AI 7: Jinsi ya Kufafanua Ustadi kwa Kawaida

1. Dhana za Msingi za Ustadi

Ustadi ni kifungu cha vitengo vya utekelezaji vilivyofungwa ndani ya Wakala (Agent) au Mfumo wa AI. Kwa kawaida hujumuisha:

• Masharti ya Kuanzisha: Wakati unapoitwa (kama vile amri za mtumiaji, matukio ya mfumo).
• Vigezo vya Kuingiza: Data au muktadha unaohitaji kupokelewa.
• Mantiki ya Utekelezaji: Hatua maalum za usindikaji (kama vile kuita API, kuendesha msimbo, kuuliza hifadhi ya maarifa).
• Matokeo ya Pato: Jibu au kitendo kinachorejeshwa kwa mwita.

2. Hatua za Kufafanua Ustadi kwa Kawaida

1. Bainisha Jina na Maelezo ya Ustadi

• Jina: Fupi, la kipekee, lenye maana (k.m. search_web, send_email).
• Maelezo: Eleza kwa sentensi moja kazi ya Ustadi, ili kurahisisha ulinganifu wa kiotomatiki wa Wakala.

2. Fafanua Vigezo vya Kuingiza (Input Schema)

Tumia JSON Schema au umbizo sawa, bainisha aina ya kila kigezo, ikiwa ni lazima, thamani chaguo-msingi na vikwazo.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Neno la utafutaji",
      "required": true
    },
    "max_results": {
      "type": "integer",
      "description": "Idadi ya juu ya matokeo kurudishwa",
      "default": 10
    }
  }
}

3. Andika Mantiki ya Utekelezaji (Execution Logic)

• Mantiki ya Hakika: Ita moja kwa moja kazi, API au hifadhidata.
• Mantiki Isiyo ya Hakika: Tumia LLM kuzalisha majibu (toa kiolezo cha prompt).
• Ushughulikiaji wa Makosa: Fafanua muda wa kuisha, jaribio tena, mkakati wa kushusha daraja.

4. Fafanua Umbizo la Pato (Output Schema)

Vivyo hivyo tumia JSON Schema kuelezea muundo wa data inayorejeshwa.

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

5. Metadata ya Ziada (Metadata)

• Nambari ya Toleo: Kurahisisha usimamizi wa matoleo.
• Mwandishi/Mtunzaji: Wajibu wa kumiliki.
• Vitegemezi: Huduma za nje au maktaba zinazohitajika.
• Vikwazo vya Matumizi: Kama vile kikomo cha mara kwa mara, mahitaji ya ruhusa.

3. Mfano: Ufafanuzi Kamili wa Ustadi

jina: "weather_query"
maelezo: "Tafuta hali ya hewa ya sasa kwa jina la mji"
toleo: "1.0.0"
mwandishi: "Timu ya AI"

pembejeo:
  aina: kitu
  sifa:
    mji:
      aina: kamba
      maelezo: "Jina la mji, kama 'Beijing'"
      inahitajika: ndiyo
    kitengo:
      aina: kamba
      enum: ["celsius", "fahrenheit"]
      chaguo-msingi: "celsius"

tekeleza:
  - hatua: "Ita API ya hali ya hewa"
    api: "https://api.weather.com/v1/current"
    mbinu: "GET"
    vigezo:
      mji: "{input.mji}"
      kitengo: "{input.kitengo}"
  - hatua: "Fomati matokeo"
    umbizo: "Hali ya hewa ya sasa ya {mji} ni {temperature}°{kitengo}"

pato:
  aina: kitu
  sifa:
    joto:
      aina: namba
    hali:
      aina: kamba
    unyevu:
      aina: namba

4. Mbinu Bora

• Wajibu Mmoja: Kila Ustadi fanya jambo moja tu, epuka kuunganisha kupita kiasi.
• Jitegemee: Usitegemee hali ya kimataifa ya nje, ingizo ni pato.
• Inayojaribika: Toa data bandia au mazingira ya sandbox kwa majaribio ya kitengo.
• Hati: Andika maelezo ya matumizi na mifano kwa kila Ustadi.

Kwa kutumia njia zilizo hapo juu kufafanua Ustadi, unaweza kuratibiwa kwa nguvu na Wakala wa AI, na pia kuunganishwa moja kwa moja na watengenezaji kwenye mfumo, kufikia athari ya kutumika tena ya "andika mara moja, tumia kila mahali".