LAPIS: Lightweight API Specification for Intelligent Systems
Dit paper introduceert LAPIS, een lichtgewicht API-specificatieformaat dat is geoptimaliseerd voor Large Language Models en een gemiddelde tokenreductie van 85,5% bereikt ten opzichte van OpenAPI, terwijl het essentiële semantische informatie behoudt en specifieke structurele innovaties biedt.
Oorspronkelijk artikel gelicentieerd onder CC BY 4.0 (http://creativecommons.org/licenses/by/4.0/). Dit is een AI-gegenereerde uitleg van het onderstaande artikel. Het is niet geschreven of goedgekeurd door de auteurs. Raadpleeg het oorspronkelijke artikel voor technische nauwkeurigheid. Lees de volledige disclaimer
Stel je voor dat je een enorme, ingewikkelde receptenboek hebt (de API-specificatie) dat je wilt geven aan een superintelligente kok (een Large Language Model of LLM).
Het huidige standaardreceptenboek heet OpenAPI. Het is prachtig ontworpen voor mensen en voor machines die code schrijven. Maar het is ook volgepropt met details die de kok helemaal niet nodig heeft:
- "Dit recept is geschreven door Jan uit Amsterdam." (De kok wil niet weten wie de schrijver is).
- "Als je de pan laat vallen, krijg je een 404-foutmelding." (Dit staat 500 keer in het boek, elke keer met dezelfde tekst).
- "De pan moet van roestvrij staal zijn, gemaakt in 2010." (De kok wil gewoon weten wat hij moet doen).
Dit maakt het boek extreem dik en zwaar. Als je dit hele dikke boek aan de kok geeft, kost het veel tijd (en geld) om het te lezen, en er is weinig ruimte over voor de daadwerkelijke instructies.
Hier komt LAPIS in beeld.
Wat is LAPIS?
LAPIS is als een snelle, handgeschreven schets op een servet, gemaakt speciaal voor de kok. Het is een nieuwe manier om te beschrijven wat een computerprogramma (een API) kan doen, maar dan extreem beknopt.
De auteur van dit artikel, Daniel García García, zegt: "Waarom geven we de kok het hele dure, zware boek, als we hem gewoon kunnen vertellen wat hij moet doen in één zin?"
De 3 Grote Verbeteringen (Met Analogen)
1. Het "Eén-keer-gezegd"-Principe (Fouten)
In het oude boek (OpenAPI) staat de zin "Als de sleutel verkeerd is, krijg je een 401-fout" 1.594 keer terug, omdat het voor elk van de 1.080 recepten apart is opgeschreven.
- LAPIS doet dit zo: Het schrijft de zin "401 = Slechte sleutel" één keer in een apart lijstje. De kok hoeft alleen maar te weten: "Kijk in het lijstje als er iets misgaat."
- Resultaat: Je haalt 1.593 zinnen weg die alleen maar ruimte innemen.
2. De "Servet-Schets" (Structuur)
Het oude boek gebruikt ingewikkelde lijsten en sub-lijsten (zoals een boomstructuur) om te zeggen: "Dit ingrediënt hoort bij dit gerecht, dat hoort bij de hoofdschotel."
- LAPIS doet dit zo: Het gebruikt een simpele, menselijke schrijfstijl, zoals je zou doen op een whiteboard:
Maak_recept -> Gebruik_eieren, Melk -> Resultaat: Omelet - De kok (de AI) leest dit veel sneller en begrijpt het direct, zonder de "boom" te hoeven doorzoeken.
3. Extra Slimme Tips (Wat het oude boek mist)
Het oude boek vertelt de kok soms niet alles wat hij nodig heeft om slim te werken. Bijvoorbeeld: "Je mag maar 60 keer per minuut bellen" of "Als de klant betaalt, krijg je een melding."
- LAPIS doet dit zo: Het voegt deze regels expliciet en gestructureerd toe. De AI kan hier beter mee plannen. Het is alsof je de kok niet alleen het recept geeft, maar ook zegt: "Pas op, je mag maar 60 keer per uur koken, en als de oven piept, is het klaar."
Waarom is dit belangrijk? (De "Geld" en "Snelheid" factor)
AI-modellen werken met tokens (stukjes tekst). Hoe meer tekst je hun geeft, hoe meer ze moeten betalen en hoe langzamer ze worden.
- Het oude boek (OpenAPI): Voor de GitHub-API (een heel groot systeem) is dit boek 1,8 miljoen tokens groot.
- Het nieuwe LAPIS: Dit is slechts 313.000 tokens.
Dat is een besparing van 85%.
Stel je voor dat je een taxi neemt. Met het oude boek betaal je voor een hele bus vol met onnodige bagage. Met LAPIS neem je alleen de koffer mee die je echt nodig hebt. Voor bedrijven die veel AI gebruiken, betekent dit dat ze duizenden euro's per maand kunnen besparen op hun rekeningen, en dat de AI sneller antwoorden geeft.
Samenvatting in één zin
LAPIS is een slimme, lichte vertaling van de zware, officiële handleidingen van software, zodat AI-modellen ze sneller, goedkoper en slimmer kunnen lezen zonder verstrikt te raken in onnodige details.
Het vervangt het oude boek niet (mensen hebben dat nog steeds nodig), maar het is de perfecte "samenvatting" voor de robot-kok.
Verdrinkt u in papers in uw vakgebied?
Ontvang dagelijkse digests van de nieuwste papers die bij uw onderzoekswoorden passen — met technische samenvattingen, in uw taal.