AI-serie Interview 7: Hoe definieer je een Skill op een gestandaardiseerde manier

1. Kernconcept van een Skill

Een Skill is een verzameling uitvoerbare capaciteitseenheden die zijn ingekapseld in een Agent (intelligente entiteit) of AI-systeem. Het bevat doorgaans:

• Triggercondities: Wanneer wordt het aangeroepen (bijv. gebruikersinstructies, systeemgebeurtenissen).
• Invoerparameters: Gegevens of context die moeten worden ontvangen.
• Uitvoeringslogica: Specifieke verwerkingsstappen (bijv. API aanroepen, code uitvoeren, kennisbank raadplegen).
• Uitvoerresultaten: Reactie of actie die wordt teruggegeven aan de aanroeper.

2. Stappen voor het gestandaardiseerd definiëren van een Skill

1. Bepaal de naam en beschrijving van de Skill

• Naam: Kort, uniek, semantisch (bijv. search_web, send_email).
• Beschrijving: Beschrijf in één zin de functie van de Skill, zodat de Agent deze automatisch kan matchen.

2. Definieer invoerparameters (Input Schema)

Gebruik JSON Schema of een vergelijkbaar formaat om het type, verplichting, standaardwaarde en beperkingen van elke parameter aan te geven.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Zoekterm",
      "required": true
    },
    "max_results": {
      "type": "integer",
      "description": "Maximaal aantal resultaten",
      "default": 10
    }
  }
}

3. Schrijf de uitvoeringslogica (Execution Logic)

• Deterministische logica: Directe aanroep van functies, API's of databases.
• Niet-deterministische logica: Gebruik LLM om reacties te genereren (voorzie een prompt-sjabloon).
• Foutafhandeling: Definieer time-out, herhaling en degradatiestrategieën.

4. Definieer uitvoerformaat (Output Schema)

Gebruik ook JSON Schema om de retourgegevensstructuur te beschrijven.

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

5. Voeg metadata toe (Metadata)

• Versienummer: Voor iteratief beheer.
• Auteur/beheerder: Verantwoordelijkheid.
• Afhankelijkheden: Externe services of bibliotheken die nodig zijn.
• Gebruiksbeperkingen: Bijv. frequentielimieten, machtigingsvereisten.

3. Voorbeeld: een volledige Skill-definitie

name: "weather_query"
description: "Vraag het huidige weer op basis van stadsnaam"
version: "1.0.0"
author: "AI Team"

input:
  type: object
  properties:
    city:
      type: string
      description: "Stadsnaam, bijv. 'Amsterdam'"
      required: true
    unit:
      type: string
      enum: ["celsius", "fahrenheit"]
      default: "celsius"

execute:
  - step: "Roep weer-API aan"
    api: "https://api.weather.com/v1/current"
    method: "GET"
    params:
      city: "{input.city}"
      unit: "{input.unit}"
  - step: "Formateer resultaat"
    format: "De temperatuur in {city} is {temperature}°{unit}"

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

4. Best practices

• Enkele verantwoordelijkheid: Elke Skill doet slechts één ding, vermijd overmatige koppeling.
• Zelfstandig: Vermijd afhankelijkheid van externe globale toestand; invoer is uitvoer.
• Testbaar: Bied mockgegevens of een sandboxomgeving voor unittesten.
• Gedocumenteerd: Schrijf gebruiksaanwijzingen en voorbeelden voor elke Skill.

Door bovenstaande methoden gedefinieerde Skills kunnen zowel dynamisch worden ingezet door AI Agents als direct worden geïntegreerd door ontwikkelaars, wat het hergebruikseffect van "eenmalig schrijven, overal gebruiken" realiseert.