Fogalomtár › Fejlesztői alapszavak
YAML
A YAML egyszerű, emberi szemmel is jól olvasható szöveges formátum, amelyben programok beállításait és adatait írják le, behúzásokkal tagolva.
Érthetően
A YAML olyan, mint egy gondosan kitöltött űrlap vagy bevásárlólista: bal oldalon áll, miről van szó, jobb oldalon az érték. Például „nyelv: magyar” vagy „max_lépések: 10”. Nincs benne programkód, csak adat és beállítás.
Arra jó, hogy egy programnak elmondd, hogyan viselkedjen, anélkül hogy magához a programhoz hozzányúlnál. Hasonlít a mosógép programválasztó tárcsájához: a gép ugyanaz, csak a beállítás más.
A többi hasonló formátumtól az különbözteti meg, hogy alig vannak benne zárójelek és idézőjelek. A szerkezetet a sorok behúzása adja, ahogy egy vázlatban az alpontokat is beljebb írod. Emiatt könnyű olvasni, de egy elcsúszott szóköz is hibát okozhat.
Az AI világában azért találkozol vele sokat, mert az agentek, az automatizált munkafolyamatok és a felhős rendszerek beállításait nagyon gyakran YAML-fájlban tárolják.
Hogyan működik
- Az alapegység a kulcs–érték pár: a kulcs neve után kettőspont és szóköz áll, majd az érték, például „modell: gyors”.
- Az összetartozó adatokat behúzással csoportosítod: ami beljebb kezdődik, az a fölötte álló sorhoz tartozik. Tabulátort nem használhatsz, csak szóközt.
- A felsorolás elemei kötőjellel kezdődnek, a kettőskereszt (#) utáni szöveg pedig megjegyzés, amelyet a program figyelmen kívül hagy.
- A program induláskor beolvassa a fájlt, és a szövegből saját belső adatszerkezetet épít: listákat, számokat, igen/nem értékeket.
- Ha a behúzás vagy az írásmód hibás, a beolvasás jó esetben hibaüzenettel megáll. Rosszabb esetben a program mást ért a fájlból, mint amit te gondoltál.
Példa a mindennapokból
Letöltesz egy nyílt forráskódú AI-eszközt, és a leírás azt kéri, hogy a „config.yaml” fájlba írd be a saját API-kulcsodat (a szolgáltatótól kapott hozzáférési kódot) és a választott modell nevét. Megnyitod egy sima szövegszerkesztővel, átírsz két sort, elmented, és az eszköz már a te beállításaiddal indul.
Kit érint
Gyakori félreértés
Korlátok és kockázatok
- A behúzás számít: egyetlen hiányzó vagy fölösleges szóköz megváltoztathatja a jelentést, vagy használhatatlanná teheti a fájlt.
- Egyes értékeket a program máshogy értelmezhet, mint gondolnád: a régebbi, de sok programban ma is használt szabvány (YAML 1.1) szerint például a „no” szó hamis értéket jelent, a verziószámból pedig tizedes tört lehet (az 1.10-ből 1.1), ha nem teszed idézőjelbe.
- A YAML-fájlokba gyakran kerülnek jelszavak és hozzáférési kulcsok, ezért soha ne oszd meg vagy töltsd fel őket nyilvános helyre ellenőrzés nélkül.
- Ismeretlen forrásból származó YAML-fájl betöltése biztonsági kockázat lehet, ha a program nem a biztonságos beolvasási módot használja.
Hasonló, de nem ugyanaz
- JSON – A JSON ugyanilyen adatokat ír le kapcsos zárójelekkel és idézőjelekkel, gépnek könnyebb, embernek nehezebb olvasni, és nem lehet benne megjegyzés.
- XML – Az XML nyitó- és zárócímkék közé teszi az adatot, ezért sokkal terjengősebb, viszont szigorúbban ellenőrizhető.
- Markdown – A Markdown embernek szánt szöveget formáz (címsor, kiemelés, lista), a YAML viszont gépnek szánt, szerkezetbe rendezett adatot ír le.
Kapcsolódó fogalmak
Adatformátum, Konfigurációs fájl, Adatszerializáció
Front matter, Docker Compose-fájl, Kubernetes-manifeszt
Röviden a története
A YAML-t 2001-ben mutatta be Clark Evans, aki Ingy döt Nettel és Oren Ben-Kikivel közösen dolgozta ki. A név eredetileg a „Yet Another Markup Language” (még egy jelölőnyelv) rövidítése volt, később a tréfás, önmagára utaló „YAML Ain't Markup Language” (a YAML nem jelölőnyelv) feloldást kapta. A ma érvényes 1.2-es szabvány 2009-ben jelent meg, legutóbbi pontosított kiadása (1.2.2) 2021-es.
Hol tart most
2026 végén a YAML a szoftverfejlesztés és a felhős üzemeltetés egyik alapformátuma, a telepítési folyamatok és a konténeres rendszerek jellemzően ebben írják le a beállításaikat. Az AI-eszközökben is megszokott: agentek, készségek és munkafolyamatok leírásában, valamint a Markdown-fájlok fejlécében egyaránt gyakori.
Más nevei
YAML · yaml · .yaml · .yml · YAML-fájl · YAML fájl · YAML Ain't Markup Language · Yet Another Markup Language
Források
A szócikk gépi szerkesztéssel készült és gépi szakmai lektoráláson ment át; a „hírekben” rész az Agent Age sztorijaiból automatikusan frissül.