AI röð viðtöl 7: Hvernig á að skilgreina Skill á stöðluðan hátt

1. Kjarnahugmynd Skill

Skill er safn framkvæmanlegra eininga sem er pakkað í Agent eða AI kerfi. Það inniheldur venjulega:

• Kveikjuskilyrði: Hvenær það er kallað (t.d. notandaskipun, kerfisatburður).
• Inntaksbreytur: Gögn eða samhengi sem þarf að taka á móti.
• Framkvæmdarökfræði: Nákvæm vinnsluskref (t.d. kalla á API, keyra kóða, fletta upp í þekkingargrunni).
• Úttaksniðurstaða: Svar eða aðgerð sem skilað er til kallara.

2. Skref til að skilgreina Skill á stöðluðan hátt

1. Skilgreindu nafn og lýsingu Skills

• Nafn: Stutt, einkvæmt, merkingarbært (t.d. search_web, send_email).
• Lýsing: Ein setning sem útskýrir virkni Skills, til að auðvelda Agent að passa sjálfkrafa.

2. Skilgreindu inntaksbreytur (Inntaksskema)

Notaðu JSON Schema eða svipað snið, tilgreindu tegund hverrar breytu, hvort hún sé nauðsynleg, sjálfgefið gildi og skorður.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Leitarorð",
      "required": true
    },
    "max_results": {
      "type": "integer",
      "description": "Hámarksfjöldi niðurstaðna",
      "default": 10
    }
  }
}

3. Skrifaðu framkvæmdarökfræði (Framkvæmdarökfræði)

• Ákveðin rökfræði: Kalla beint á föll, API eða gagnagrunna.
• Óákveðin rökfræði: Notaðu LLM til að búa til svar (þarf að gefa upp sniðmát fyrir prompt).
• Villumeðferð: Skilgreindu tímaút, endurtekningar og niðurfærslustefnu.

4. Skilgreindu úttakssnið (Úttaksskema)

Notaðu einnig JSON Schema til að lýsa gagnaskipan sem skilað er.

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

5. Viðbótarlýsigögn (Lýsigögn)

• Útgáfunúmer: Auðveldar endurtekningastjórnun.
• Höfundur/umsjónarmaður: Ábyrgðartengsl.
• Háð: Ytri þjónusta eða bókasöfn sem þarf.
• Notkunartakmarkanir: T.d. tíðnitakmarkanir, heimildakröfur.

3. Dæmi: Heildstæð skilgreining á Skill

name: "weather_query"
description: "Sækja núverandi veður eftir borgarnafni"
version: "1.0.0"
author: "AI Team"

input:
  type: object
  properties:
    city:
      type: string
      description: "Borgarnafn, t.d. 'Reykjavík'"
      required: true
    unit:
      type: string
      enum: ["celsius", "fahrenheit"]
      default: "celsius"

execute:
  - step: "Kalla á veður API"
    api: "https://api.weather.com/v1/current"
    method: "GET"
    params:
      city: "{input.city}"
      unit: "{input.unit}"
  - step: "Sniða niðurstöðu"
    format: "Núverandi hitastig í {city} er {temperature}°{unit}"

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

4. Bestu venjur

• Eitt hlutverk: Hvert Skill gerir aðeins eitt, forðastu of mikla tengingu.
• Sjálfstætt: Reyndu að treysta ekki á ytra ástand, inntak skilar úttaki.
• Prófanlegt: Gefðu upp hermi gögn eða sandkassaumhverfi fyrir einingaprófanir.
• Skjalfest: Skrifaðu notkunarleiðbeiningar og dæmi fyrir hvert Skill.

Með ofangreindum aðferðum skilgreint Skill getur bæði verið notað af AI Agent í kraftmikilli skipulagningu og af þróunaraðilum beint inn í kerfið, sem nær endurnýtingaráhrifum "skrifaðu einu sinni, notaðu alls staðar".