Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Podporované formáty súborov

Lekcia 2 z 16 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Jediné kritérium, na ktorom záleží
  2. Štyri podporované kategórie
  3. Bežné úskalia
  4. Vyber vždy čo najštruktúrovanejší formát
  5. Kľúčové poznatky

Jediné kritérium, na ktorom záleží

Skôr než sa opýtaš, či konkrétny formát funguje, polož si jednoduchšiu otázku: obsahuje súbor text, ktorý sa dá extrahovať? Rozhranie Files API od xAI spracováva textové súbory. Ak ktorýkoľvek nástroj dokáže vytiahnuť znaky bez použitia optického rozpoznávania znakov (OCR), dokument bude pravdepodobne akceptovaný. Čisto binárne súbory – obrázky, audio, video – sem nepatria; pre obrázok je správnym prístupom použitie input_image v Responses API, nie vo Files API.

Toto jediné kritérium vysvetľuje väčšinu zamietnutí, s ktorými sa stretneš. Vysvetľuje aj to, prečo PDF finančnej správy funguje perfektne, zatiaľ čo PDF z desktopového skenera zlyhá: prvý obsahuje textovú vrstvu, druhý je len sériou fotografií stránok.

Štyri podporované kategórie

Podporované formáty spadajú do štyroch kategórií, pričom každá má svoje preferované využitie.

KategóriaFormátyČo Grok extrahuje
Kancelárske dokumentyPDF, DOCX, ODT, EPUB, RTFText, tabuľky, štruktúra sekcií
Zdrojový kód.py, .js, .ts, .java, .go, .rs, .cpp, HTML, CSS, XML a viac ako 80 jazykovImporty, závislosti, štruktúra súborov
Štruktúrované dátaCSV, TSV, JSON, JSON-LD, vCardHierarchia polí, štatistiky, trendy
Čistý textTXT, MDLineárny obsah, nadpisy a zoznamy v Markdowne

Pokiaľ ide o kancelárske dokumenty, PDF zostáva najbežnejším formátom a Grok z neho extrahuje text, tabuľky a rozdelenie na sekcie. Word DOCX si pri extrakcii zachováva formátovanie – tučné písmo, kurzívu, zoznamy – rovnako ako jeho open-source ekvivalent ODT. EPUB sa stáva zaujímavým hneď, keď pracuješ s dlhými publikáciami, white paperom alebo celým manuálom, a RTF, hoci je starší, je stále dostatočne rozšírený na to, aby bol podporovaný.

Zdrojový kód je oblasťou, kde sa Files API najvýraznejšie líši od obyčajného kopírovania a vkladania. Odoslanie celého súboru payment.py namiesto izolovanej funkcie mení povahu analýzy: Grok vidí importy, závislosti a organizáciu súborov, a preto dokáže odhaliť, že výnimka je zachytená o tridsať riadkov vyššie, alebo že konštanta definovaná na začiatku je v rozpore s komentárom na konci. Podporovaných je viac ako 80 jazykov so syntaxou založenou na texte.

Formáty dát slúžia primárne na kvantitatívnu analýzu. CSV s mesačnými predajmi umožňuje Groku vypočítať rozdiely, odhaliť sezónnosť a zhrnúť dataset s niekoľkými tisícami riadkov; konfigurácia JSON alebo odpoveď API mu poskytuje prístup k hierarchii a vzťahom medzi poľami, čo by sploštená tabuľka neukázala. JSON-LD pridáva k prepojeným dátam sémantický kontext a vCard pokrýva vizitky kontaktov. Nakoniec, TXT a MD fungujú podľa očakávania, pričom Markdown ponúka výhodu prenosu ľahkej štruktúry nadpisov a zoznamov.

Bežné úskalia

V produkcii sa neustále objavujú štyri obmedzenia. Prvým je veľkosť: 48 MB na súbor, po prekročení ktorej musíš dokument rozdeliť. Druhým je kódovanie: tvoje súbory musia byť v kódovaní UTF-8 a export v ISO-8859 alebo Windows-1252 spôsobí poškodenie diakritiky, niekedy nenápadné – keď sa `é` zmení na `é` uprostred zmluvy, zostane to bez povšimnutia, kým vyhľadávanie nič nenájde. Tretím je chýbajúce spracovanie obrázkov: PNG, JPG alebo GIF sem nepatria, musíš použiť input_image. Štvrtým je prípad skenovaného PDF bez textovej vrstvy OCR, ktoré bude pri nahrávaní akceptované, ale pri dotaze vráti nulové výsledky.

Táto posledná situácia si vyžaduje jednoduchý návyk: pred nahraním dávky PDF súborov neistého pôvodu otvor jeden z nich a pokús sa myšou označiť odstavec. Ak sa nič neoznačí, tvoje dokumenty musia predtým prejsť procesom OCR.

Vyber vždy čo najštruktúrovanejší formát

Keď existujú tie isté informácie vo viacerých formách, vždy vyber tú najštruktúrovanejšiu. Pri analýze správ uprednostni pôvodné PDF alebo DOCX, ktoré zachovávajú hierarchiu, namiesto plochého textového exportu. Pri analýze dát poskytne CSV pre tabuľky a JSON pre hierarchické dáta lepšie výsledky než export z tabuľkového procesora transformovaný na čistý text. Pri recenzii kódu pošli pôvodný zdrojový súbor s jeho pôvodnou príponou. Pre dokumentáciu funguje Markdown alebo PDF podľa toho, čo máš k dispozícii pri zdroji. Pravidlo sa dá zhrnúť do jednej vety: každá úroveň štruktúry, ktorú zachováš, je úroveň kontextu, ktorú model nemusí rekonštruovať.

Kľúčové poznatky

  • Files API podporuje dokumenty (PDF, DOCX, EPUB), kód (viac ako 80 jazykov), dáta (CSV, JSON) a čistý text
  • Limit je 48 MB na súbor v kódovaní UTF-8
  • Obrázky a binárne súbory nie sú podporované – pre obrázky použi input_image
  • Uprednostni čo najštruktúrovanejší formát pre lepšiu analýzu