e1_ai_documentsprocessing – spracovávajte obrázky a PDF dokumenty pomocou AI
Plugin umožňuje odosielať obrázky a PDF súbory na spracovanie pomocou AI modelov cez OpenAI-kompatibilné API.
Stiahnutie pluginu
Inštalácia pluginu
Možnosti
Plugin ponúka tri spôsoby spracovania:
| Provider | Popis |
|---|---|
| AIImageProcessing | Spracovanie obrázkov (JPG, PNG, GIF, WebP, BMP) |
| AIPDFProcessing | Spracovanie PDF dokumentov – všetky strany PDF sa automaticky skonvertujú do jedného obrázka a ten sa odošle AI |
| AIChat | Iba textová komunikácia s AI bez obrázka alebo dokumentu |
Všetky možnosti môžu byť aj cieľom akcie typu DataRepeater – pumpa.
Čo potrebujete
- API endpoint – OpenAI-kompatibilný (napr. https://openrouter.ai/api/v1/chat/completions alebo vlastný)
- API kľúč – pre prístup k API
- Model – model podporujúci obrázky (Vision)
Všetky tieto údaje môžete nastaviť buď v konfiguračnom súbore, alebo priamo v parametroch volania.
Konfigurácia
Ak chcete, aby sa rovnaké nastavenia používali vždy, vytvorte súbor ai_config.json v priečinku pluginu:
{
"Url": "https://openrouter.ai/api/v1/chat/completions",
"Model": "nvidia/nemotron-3-super-120b-a12b:free",
"ApiKey": "sk-..."
}
Hodnoty zadané v parametroch volania majú vždy prednosť pred konfiguračným súborom.
Parametre
| Parameter | Typ | Povinný | Popis |
|---|---|---|---|
| @aiIpUrl | Text | Nie* | API endpoint URL |
| @aiIpModel | Text | Nie* | Identifikátor modelu |
| @aiIpApiKey | Text | Nie* | API kľúč |
| @aiIpImage | Bytes / Text | Áno | Obrázok (pre AIImageProcessing) alebo PDF súbor (pre AIPDFProcessing) – ako byte[], base64, data URI alebo cesta k súboru |
| @aiIpPrompt | Text | Áno | Text výzvy pre AI (napr. “Popíš, čo vidíš na obrázku”) |
| @aiIpTemperature | Číslo | Nie | Kreativita odpovede (0.0 až 2.0, predvolene 0.1) |
| @aiIpReturnImage | Pravda/Nepravda | Nie | Ak true, vráti pôvodný obrázok v stĺpci Image (predvolene false) |
| @aiIpStopWhenDocumentIsEmpty | Pravda/Nepravda | Nie | Ak true a obrázok/PDF nie je zadaný, vráti prázdnu tabuľku namiesto chyby (predvolene false) |
| @aiIpPdfDpi | Číslo | Nie | Rozlíšenie pri konverzii PDF na obrázok (predvolene 150) – len pre AIPDFProcessing |
| @aiIpResultCmd | Text | Nie | SQL príkaz, ktorý sa vykoná po odpovedi AI. V príkaze môžete použiť parametre @Result (text odpovede) a @Response (plný JSON). Pri chybe sa @Result nastaví na chybovú správu |
* Nie je povinný, ak je hodnota nastavená v konfiguračnom súbore.
Výstup
Pre každé volanie plugin vráti DataTable s týmito stĺpcami:
| Stĺpec | Typ | Popis |
|---|---|---|
| Result | Text | Odpoveď AI modelu |
| Response | Text | Kompletná JSON odpoveď z API |
| Image | Bytes | Pôvodný obrázok (len ak @aiIpReturnImage = true) |
Príklady použitia
1. Jednoduché spracovanie obrázka
Odošlite obrázok (napr. ako byte[]) a prompt. Plugin vráti textovú odpoveď AI. Model: AIImageProcessing @aiIpImage: [byte[] obrázka] @aiIpPrompt: “Popíš, čo vidíš na tejto fotografii”
2. Spracovanie PDF dokumentu
Odošlite PDF (byte[], base64 alebo cesta k súboru). Plugin konvertuje všetky strany PDF do jedného obrázka a odošle ho AI. Model: AIPDFProcessing @aiIpImage: “C:\dokumenty\faktura.pdf” @aiIpPrompt: “Prečítaj text z tohto dokumentu” @aiIpPdfDpi: 200
3. Dávkové spracovanie (SetLargeDataTable)
Každý riadok vstupnej tabuľky sa spracuje samostatne. Názvy stĺpcov sa mapujú na názvy parametrov, prípadne využite Caption stĺpca.
Minimálne stĺpce vstupnej tabuľky: @aiIpImage, @aiIpPrompt
Výsledok sa doplní do stĺpcov: Result, Response, Image, ErrorMessage.
4. Potlačenie chýb pri prázdnom dokumente
Ak sa môže stať, že obrázok nebude k dispozícii a chcete sa vyhnúť chybe: @aiIpStopWhenDocumentIsEmpty: true
V takom prípade plugin vráti prázdny DataTable (0 riadkov).
5. Vykonanie SQL príkazu po spracovaní
Po odpovedi AI môžete automaticky vykonať SQL príkaz (napr. zápis výsledku do tabuľky): @aiIpResultCmd: “INSERT INTO ai_log (result, created) VALUES (@Result, GETDATE())”
Parameter @Result sa nahradí textom odpovede AI, @Response plným JSON. Pri chybe volania API sa do @Result dosadí chybová správa a príkaz sa aj tak vykoná.
6. Iba textový chat
Bez obrázka alebo PDF, len odoslanie promptu AI modelu: Model: AIChat @aiIpPrompt: “Napíš román o programátorovi v stredoveku” @aiIpTemperature: 0.8
Formát obrázkov
Plugin automaticky rozpozná formát obrázka podľa prípony súboru, hlavičiek alebo MIME typu v data URI. Podporované formáty: JPG, PNG, GIF, WebP, BMP.
Pre PDF sa používa formát PNG (všetky strany sa zložia do jedného obrázka).
Upozornenia
- Maximálna veľkosť obrázka závisí od API, ktoré používate (OpenAI má limit cca 20 MB)
- Pri veľkých PDF súboroch zvoľte nižšie DPI (napr. 100-150) pre rýchlejšie spracovanie