LAPIS: Lightweight API Specification for Intelligent Systems
Il paper presenta LAPIS, un formato di specifica API leggero e ottimizzato per il consumo da parte dei Large Language Models che, pur preservando le informazioni semantiche necessarie, riduce il consumo di token del 85,5% rispetto allo standard OpenAPI grazie a innovazioni strutturali specifiche e a un convertitore automatico.
Articolo originale sotto licenza CC BY 4.0 (http://creativecommons.org/licenses/by/4.0/). Questa è una spiegazione generata dall'IA dell'articolo qui sotto. Non è stata scritta né approvata dagli autori. Per precisione tecnica, consulta l'articolo originale. Leggi il disclaimer completo
🚀 LAPIS: La "Carta d'Identità" Semplificata per l'Intelligenza Artificiale
Immagina che le API (i servizi che permettono ai software di parlarsi) siano come dei ristoranti.
Per far sì che un cliente (in questo caso, un'intelligenza artificiale o un "robot") sappia cosa può ordinare, il ristorante deve avere un menu.
Attualmente, il menu standard del settore si chiama OpenAPI. È un documento enorme, scritto per essere letto da umani (programmatori) e da macchine (generatori di codice). È come un menu da 500 pagine che include:
- La storia del proprietario del ristorante.
- La licenza di utilizzo del locale.
- Foto di ogni singolo piatto con le calorie esatte.
- Istruzioni su come cucinare il piatto se il cliente è a sinistra o a destra del tavolo.
Il problema? Quando un'Intelligenza Artificiale (LLM) vuole leggere questo menu per capire cosa può fare, si trova sommersa da informazioni inutili. È come se un robot che deve solo ordinare una pizza si trovasse a dover leggere anche la biografia del cuoco e le leggi municipali. Questo spreca spazio nella "memoria" del robot (chiamata context window) e costa soldi.
💡 La Soluzione: LAPIS
L'autore del paper, Daniel García García, ha creato LAPIS.
Pensa a LAPIS come a un menu "Express" per robot. È lo stesso menu, ma ripulito, riassunto e scritto in modo che un'intelligenza artificiale possa leggerlo in un battito di ciglia.
Ecco come funziona, spiegato con metafore:
1. Il Problema: Il "Rumore" di Fondo
Nel menu standard (OpenAPI), se il ristorante ha 1.000 piatti diversi, e 500 di loro possono andare male per lo stesso motivo (es. "Ingrediente non disponibile"), il menu standard ripete la stessa frase "Ingrediente non disponibile" 500 volte.
- Per un umano: È utile per trovare velocemente la riga specifica.
- Per un robot: È uno spreco enorme di spazio. È come scrivere 500 volte la stessa parola su un foglio di carta invece di scriverla una volta e dire "vale per tutti".
2. La Magia di LAPIS: "Centrale degli Errori"
LAPIS risolve questo problema con una regola semplice: "Diciamo le cose una volta sola, e basta".
- Invece di ripetere l'errore 500 volte, LAPIS crea una sezione speciale chiamata "Errori" dove elenca i 10 tipi di errori possibili. Poi, nei 1.000 piatti, si limita a dire: "Se qualcosa va storto, guarda la lista Errori".
- Risultato: Il menu diventa piccolissimo. Nel caso dell'API di GitHub (uno dei più grandi al mondo), il menu standard occupa quasi 2 milioni di "token" (unità di misura per la memoria dei robot), mentre LAPIS ne usa solo 313.000.
- Il risparmio: Circa l'85-90%. È come passare da un camion pieno di paglia a una scatola di fiammiferi contenente lo stesso messaggio.
3. Un Linguaggio Naturale per i Robot
I robot moderni (come quelli che scrivono codice o rispondono a chat) sono bravi a leggere frasi simili a quelle umane, ma odiano i documenti pieni di parentesi quadre, graffe e strutture annidate (come i file JSON o YAML complessi).
- OpenAPI: È come un documento legale scritto in codice binario.
- LAPIS: È come se un programmatore ti spiegasse il menu su una lavagna bianca con pennarello:
"Crea fattura: Inviami il cliente e gli articoli. Ti restituirò la fattura. Se manca il cliente, ti dirò 'Errore 401'."
È immediato, diretto e non richiede al robot di fare calcoli matematici per capire cosa sta succedendo.
4. Cosa Aggiunge (Non Solo Toglie)
LAPIS non si limita a tagliare, ma aggiunge cose che il menu vecchio non aveva mai detto chiaramente:
- I "Tram" (Rate Limits): Dice al robot: "Attenzione, puoi fare solo 60 richieste al minuto, altrimenti ti fermiamo".
- Le "Catene di Eventi" (Flows): Spiega che per fare una cosa devi prima farne un'altra. "Prima devi creare l'ordine, poi pagarlo, e solo allora arriva la fattura".
- I "Campanelli" (Webhooks): Spiega quando il ristorante chiamerà il robot da solo. "Se il pagamento arriva, ti avvisiamo noi".
5. Perché è Importante? (I Soldi)
Ogni volta che un'azienda usa un'intelligenza artificiale per leggere un documento, paga per ogni parola (token) che il robot legge.
- Se un'azienda usa il menu vecchio (OpenAPI) per 1.000 richieste al giorno, spende circa 5.400 dollari.
- Se usa il menu LAPIS, spende circa 940 dollari.
- Risparmio: Quasi 4.500 dollari al giorno solo perché il menu è più corto e intelligente.
In Sintesi
LAPIS è un nuovo modo di scrivere le istruzioni per i software, pensato specificamente per le intelligenze artificiali.
- Non sostituisce il vecchio menu (OpenAPI) che serve agli umani per programmare.
- È una traduzione ottimizzata che gli umani possono creare automaticamente e che i robot possono leggere velocemente, spendendo meno soldi e sbagliando meno cose.
È come passare da un'enciclopedia di 20 volumi a una sintesi intelligente di una pagina: contiene tutto ciò che serve per agire, ma senza il peso inutile della storia e delle note a piè di pagina.
Sommerso dagli articoli nel tuo campo?
Ricevi digest giornalieri degli articoli più recenti corrispondenti alle tue parole chiave di ricerca — con riassunti tecnici, nella tua lingua.