Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Palaikomi failų formatai

Paskaita 2 iš 16 Atnaujinta 2026 m. liepos 29 d. Kūrėjas
Šiame puslapyje
  1. Vienintelis svarbus kriterijus
  2. Keturios palaikomos kategorijos
  3. Dažnos klaidos
  4. Pasirink kuo struktūrizuotesnį formatą
  5. Svarbiausi punktai

Vienintelis svarbus kriterijus

Prieš klausdamas, ar konkretus formatas veikia, užduok sau paprastesnį klausimą: ar faile yra išgaunamo teksto? xAI Files API apdoroja tekstinius failus. Jei bet kuris įrankis gali iš jo ištraukti simbolius nenaudodamas optinio simbolių atpažinimo (OCR), dokumentas greičiausiai bus priimtas. Gryni binariniai failai – vaizdai, garso įrašai, vaizdo įrašai – čia netinka; vaizdui teisingas būdas yra naudoti input_image Responses API, o ne Files API.

Šis vienas kriterijus paaiškina daugumą atmetimų, su kuriais susidursi. Jis taip pat paaiškina, kodėl finansinės ataskaitos PDF veikia puikiai, o PDF iš darbalaukio skaitytuvo neveikia: pirmasis turi teksto sluoksnį, antrasis yra tiesiog nuotraukų seka.

Keturios palaikomos kategorijos

Palaikomi formatai skirstomi į keturias kategorijas, kurių kiekviena turi savo pageidaujamą naudojimo būdą.

KategorijaFormataiKą Grok išgauna
Biuro dokumentaiPDF, DOCX, ODT, EPUB, RTFTekstas, lentelės, skirsnių struktūra
Šaltinio kodas.py, .js, .ts, .java, .go, .rs, .cpp, HTML, CSS, XML ir 80+ kalbųImportai, priklausomybės, failų struktūra
Struktūrizuoti duomenysCSV, TSV, JSON, JSON-LD, vCardLaukų hierarchija, statistika, tendencijos
Paprastas tekstasTXT, MDLinijinis turinys, Markdown antraštės ir sąrašai

Biuro dokumentų pusėje PDF išlieka populiariausiu formatu, o Grok iš jo išgauna tekstą, lenteles ir skirsnių suskirstymą. Word DOCX išlaiko savo formatavimą – paryškinimą, kursyvą, sąrašus – ekstrakcijos metu, taip pat kaip ir jo atviro kodo atitikmuo ODT. EPUB tampa įdomus, kai dirbi su ilgais leidiniais, baltąja knyga arba visa instrukcija, o RTF, nors ir senesnis, vis dar yra pakankamai paplitęs, kad būtų palaikomas.

Šaltinio kodas yra sritis, kurioje Files API labiausiai išsiskiria iš kopijavimo ir įklijavimo. Siunčiant visą payment.py, o ne izoliuotą funkciją, pasikeičia analizės pobūdis: Grok mato importus, priklausomybes ir failų organizaciją, todėl gali pastebėti, kad išimtis sugaunama trisdešimt eilučių aukščiau arba kad konstanta, apibrėžta viršuje, prieštarauja komentarams apačioje. Padengta daugiau nei 80 kalbų su tekstine sintakse.

Duomenų formatai pirmiausia skirti kiekybinei analizei. Mėnesinių pardavimų CSV leidžia Grok apskaičiuoti nuokrypius, pastebėti sezoniškumą ir apibendrinti kelių tūkstančių eilučių duomenų rinkinį; JSON konfigūracija arba API atsakas suteikia prieigą prie laukų hierarchijos ir ryšių, ko nepateiktų suplokštinta lentelė. JSON-LD prideda semantinį kontekstą susietiems duomenims, o vCard apima kontaktines korteles. Galiausiai, TXT ir MD veikia kaip tikėtasi, o Markdown suteikia pranašumą perduodant lengvą antraščių ir sąrašų struktūrą.

Dažnos klaidos

Gamyboje nuolat iškyla keturi apribojimai. Pirmasis yra dydis: 48 MB vienam failui; viršijus šią ribą, dokumentą reikia padalinti. Antrasis yra kodavimas: tavo failai turi būti UTF-8 koduotės, o eksportavimas į ISO-8859 arba Windows-1252 sugadins diakritinius ženklus, kartais nepastebimai – `é` pavirtimas `é` sutarties viduryje lieka nepastebėtas, kol paieška nieko neranda. Trečiasis yra vaizdų apdorojimo nebuvimas: PNG, JPG arba GIF čia netinka, turi naudoti input_image. Ketvirtasis atvejis – nuskaitytas PDF be OCR teksto sluoksnio, kuris bus priimtas įkeliant, bet užklausus negrąžins jokių rezultatų.

Ši paskutinė situacija reikalauja paprasto įpročio: prieš įkeliant abejotinos kilmės PDF failų partiją, atidaryk vieną ir pabandyk pelės žymekliu pažymėti pastraipą. Jei niekas nepažymima, tavo dokumentai prieš tai turi būti apdoroti OCR.

Pasirink kuo struktūrizuotesnį formatą

Kai ta pati informacija egzistuoja keliomis formomis, visada rinkis kuo struktūrizuotesnę. Ataskaitų analizei teik pirmenybę originaliam PDF arba DOCX, kurie išlaiko hierarchiją, o ne paprastam teksto eksportui. Duomenų analizei lentelėms skirtas CSV, o hierarchiniams duomenims – JSON duos geresnių rezultatų nei į paprastą tekstą paversta skaičiuoklės eksporto kopija. Kodo peržiūrai siųsk originalų šaltinio failą su jo pradine plėtiniu. Dokumentacijai tinka Markdown arba PDF, priklausomai nuo to, ką turi šaltinyje. Taisyklė gali būti suformuluota vienu sakiniu: kiekvienas išlaikytas struktūros lygmuo yra konteksto lygmuo, kurio modeliui nereikės atkurti iš naujo.

Svarbiausi punktai

  • Files API palaiko dokumentus (PDF, DOCX, EPUB), kodą (80+ kalbų), duomenis (CSV, JSON) ir paprastą tekstą
  • Ribą sudaro 48 MB vienam failui su UTF-8 koduote
  • Vaizdai ir binariniai failai nepalaikomi – vaizdams naudok input_image
  • Analizei gauti geriausius rezultatus rinkis kuo struktūrizuotesnį formatą