Přílohy v ColdHost AI – jak efektivně pracovat s PDF, ZIP a kódem

Kopírovat stovky řádků kódu nebo celý dokument do zprávy je nepohodlné a nepřehledné. ColdHost AI umí přímo číst přílohy – zdrojový kód, textové soubory, PDF a ZIP archivy. V tomto návodu ukážeme, jak je připravit a jak se ptát, abyste dostali přesnou odpověď a zbytečně neplýtvali limitem.

Podporované typy

Typ	Příklady	Typické použití
Kód	.py, .js, .ts, .php, .go, .sql	revize, oprava chyby, vysvětlení
Text a konfigurace	.txt, .md, .json, .yaml, .conf, .log	analýza logů, kontrola konfigurace
PDF	smlouvy, manuály, zadání, faktury	shrnutí, vyhledání informací
ZIP	celý projekt nebo složka	pochopení struktury, hledání chyby napříč soubory

Obsah příloh se započítává do spotřeby tokenů stejně jako text zprávy. Velká příloha = velká spotřeba.

PDF: jak se ptát

AI čte textový obsah PDF. Nejlépe funguje s dokumenty, které mají skutečný text (exportované z Wordu, generované systémem). U naskenovaných dokumentů – tedy obrázků stránek bez textové vrstvy – nemusí být obsah čitelný. Jestli PDF obsahuje text, ověříte jednoduše: zkuste v prohlížeči PDF označit a zkopírovat větu. Na Linuxu i příkazem:

pdftotext dokument.pdf - | head -n 20

(pdftotext je součástí balíčku poppler-utils.) Pokud výstup je prázdný, jde o sken bez textu.

Dobré dotazy na PDF:

• „Shrň tuhle smlouvu do 10 bodů a zvýrazni výpovědní lhůty a sankce.“
• „Najdi v manuálu, jak resetovat zařízení do továrního nastavení, a uveď číslo strany.“
• „Porovnej technické parametry v příloze s požadavky, které vkládám níže.“

U dlouhých dokumentů pomáhá zúžit rozsah: „Zaměř se na kapitolu 4 – Platební podmínky.“

U právních a finančních dokumentů berte shrnutí jako pomůcku, ne jako náhradu odborníka.

ZIP: připravte čistý archiv

ZIP je ideální, když chcete AI ukázat víc souborů najednou. Do archivu ale nedávejte balast:

zip -r projekt.zip src/ package.json tsconfig.json README.md

Nebo celý adresář s vyloučením zbytečností:

zip -r projekt.zip . -x "node_modules/*" ".git/*" "dist/*" "*.log" ".env"

Co do ZIPu nepatří:

• node_modules/, vendor/, venv/ – závislosti se dají dohledat z manifestu,
• .git/ – historie je pro analýzu kódu zbytečná,
• buildy a minifikované soubory,
• .env a cokoli s hesly či klíči.

Velikost archivu před odesláním zkontrolujete:

unzip -l projekt.zip | tail -n 1

ZIP: jak se ptát

Řekněte AI, kde začít:

V příloze je Express aplikace. Přihlášení vrací 500.
Relevantní soubory: src/routes/auth.js, src/middleware/session.js.
Najdi příčinu a navrhni opravu.

Pokud chcete pracovat s archivem dlouhodobě a nechat AI soubory přímo upravovat, nahrajte ho raději do projektu – tam můžete změny exportovat zpět jako ZIP nebo je poslat na GitHub.

Logy: méně je víc

Logy bývají obrovské a plné opakujících se řádků. Před přiložením je ořízněte:

# jen chyby a varování
grep -E "ERROR|WARN" app.log > chyby.log

# posledních 200 řádků
tail -n 200 app.log > posledni.log

# unikátní chyby s počtem výskytů
grep ERROR app.log | sort | uniq -c | sort -rn | head -n 30 > souhrn.log

Poslední příkaz funguje dobře u logů bez časových razítek na začátku řádku; jinak razítka odstraňte, např. pomocí cut nebo sed.

Kód: jeden soubor, nebo víc?

• Chyba v jedné funkci – stačí přiložit jeden soubor, případně vložit jen funkci do zprávy.
• Chyba na rozhraní dvou modulů – přiložte oba soubory.
• „Proč to celé nefunguje“ – ZIP s popisem, kde začít.

Bezpečnost

Než cokoli přiložíte, zkontrolujte, zda soubor neobsahuje tajné údaje. Rychlá kontrola:

grep -rniE "password|secret|api_key|token" src/ | head

Hesla nahraďte zástupnými hodnotami. Osobní údaje zákazníků v exportech a logech anonymizujte.

Shrnutí

Připravte čistou přílohu, řekněte AI, na co se zaměřit, a u velkých dat pošlete jen relevantní část. Dostanete přesnější odpověď a ušetříte tokeny.