Macros ili AI Functions? Razumevanje ONLYOFFICE alata

4 February 2026By Natalija Blagojevic

ONLYOFFICE vam pruža moćne načine da automatizujete rad sa dokumentima pomoću makroa i AI funkcija — pomažući vam da uštedite vreme, smanjite manuelni rad i radite efikasnije.

Oba alata vam pomažu da radite brže i pametnije, ali funkcionišu na različite načine i odgovaraju različitim potrebama. Bilo da ste programer koji gradi prilagođena rešenja ili neko ko želi da radi efikasnije, ovaj vodič će vam pomoći da izaberete pravi alat za svoje potrebe

Macros or AI Functions? Understanding ONLYOFFICE Tools

Razumevanje osnova

Šta su ONLYOFFICE makroi?

ONLYOFFICE makroi su male skripte koje automatizuju ponavljajuće zadatke u dokumentima, tabelama i prezentacijama. Koriste JavaScript i Office API, omogućavajući vam da formatirate sadržaj, ažurirate podatke i gradite prilagođene tokove rada direktno u editoru.

Kako koristiti makroe:

Otvorite karticu View i kliknite na Macros
Napišite JavaScript kod koristeći Office API
Kliknite na Run da biste pokrenuli makro
Skripta direktno manipuliše dokumentom

Napomena! Od verzije 7.1, makroi se izvršavaju u strict režimu. To znači da morate deklarisati sve promenljive pomoću let ili constpre nego što ih koristite. Ne možete koristiti window, document ili alert funkcije. Primer: Bojenje redova tabele

(function () {
  let worksheet = Api.GetActiveSheet();
  for (let i = 1; i < 200; i += 2) {
    let rowOdd = i,
      rowEven = i + 1;
    worksheet.GetRange(
      "A" + rowOdd + ":S" + rowOdd).SetFillColor(Api.CreateColorFromRGB(138, 181, 155)
      );
    worksheet.GetRange(
      "A" + rowEven + ":S" + rowEven).SetFillColor(Api.CreateColorFromRGB(216, 227, 220)
      );
  }
})();

Ovaj makro boji 200 redova naizmenično za manje od jedne sekunde — zadatak koji bi ručno zahtevao znatno više vremena.

Šta su ONLYOFFICE AI funkcije?

AI funkcije povezuju ONLYOFFICE sa AI modelima kao što je ChatGPT. Omogućavaju vam da pokrećete AI-pokretane radnje nad dokumentima koristeći promptove, tako da editor može automatski izvršavati operacije na osnovu vaših zahteva. AI funkcije su deo AI dodatka (trenutno u beta fazi), uvedenog u verziji 2.4.2.

Podešavanje

Klonirajte onlyoffice.github.io repozitorijum na svoj lokalni računar.
Napišite AI funkciju u helpers folderu (sdkjs-plugins/content/ai/.dev/helpers).
U zavisnosti od tipa editora, postavite je u cell, slide, ili word folder.
Ažurirajte trenutnu verziju AI dodatka u config.js kako biste izbegli probleme sa keširanjem
(na primer, 3.0.3 → 3.0.4).
Pokrenite helpers.py fajl.
Izaberite sve fajlove dodatka u ai folderu (sdkjs-plugins/content/ai), zipujte ih i preimenujte arhivu u ai.plugin.
Postavite fajl nazad u sdkjs-plugins/content/ai/deploy.
Pošaljite izmene.
Napravite svoju lokaciju GitHub Pages iz ovog repozitorijuma (pogledajte dokumentaciju GitHub Pages).
Pripremite vezu ka svojoj prilagođenoj prodavnici dodavanjem /store/index.html na URL vaše GitHub stranice:
https://YOUR-USERNAME.github.io/onlyoffice.github.io/store/index.html
Idite na Plugins → Plugin Manager.
Kliknite na ikonu Store (</>) u gornjem desnom uglu Plugin Manager-a i unesite svoju prilagođenu URL adresu prodavnice.
Ažurirajte AI dodatak

Napomena! Za detaljnija uputstva pogledajte ovaj članak.

Kako koristiti AI funkcije

Konfigurišite AI provajdera i API ključ ako je potrebno.
Pritisnite Ctrl + / da otvorite AI chat.
Ukucajte ono što želite (na primer “Explain this text”)
AI bira odgovarajuću funkciju i izvršava zadatak.
Rezultat se pojavljuje direktno u vašem dokumentu.

AI funkcije pamte vašu konverzaciju. Možete postavljati dodatna pitanja ili unapređivati rezultate. Za novi razgovor pritisnite Ctrl + Alt + /.

Primer: Dodavanje AI komentara

Funkcija commentText dodaje pametne komentare izabranom tekstu:

Izaberite neki tekst u vašem dokumentu.
Pritisnite Ctrl + / da otvorite AI čet.
Ukucajte: “Explain this text”.
Pritisnite Enter.

AI čita vaš tekst, generiše objašnjenje i dodaje ga kao komentar u vaš dokument.

Evo kako to funkcioniše iza scene:

// Simplified structure of an AI Function
func.call = async function (params) {
  // 1. Get the selected text
  let text = await Asc.Editor.callCommand(function () {
    let doc = Api.GetDocument();
    let range = doc.GetRangeBySelect();
    return range ? range.GetText() : "";
  });
  // 2. Ask the AI model
  let requestEngine = AI.Request.create(AI.ActionType.Chat);
  let argPrompt = params.prompt + ":\n" + text;
  // 3. Add the AI's answer as a comment
  await requestEngine.chatRequest(argPrompt, false, async function (data) {
    await Asc.Editor.callCommand(function () {
      let doc = Api.GetDocument();
      let range = doc.GetRangeBySelect();
      range.AddComment(data, model, "uid" + model);
    });
  });
};

Možete videti kompletan kod funkcije commentText ovde.

Zašto su AI funkcije fleksibilnije

AI funkcije pozivaju CallCommand odvojeno (pogledajte linije u kodu iznad), što vam omogućava da izvršavate prilagođenu logiku pre i posle operacija nad dokumentom. To ih čini idealnim za AI integraciju – možete slati zahteve AI modelu, obrađivati odgovor i zatim ažurirati dokument. Aplikacija za makroe obavija sve unutar jednog CallCommand poziva, što je jednostavnije, ali manje fleksibilno.

Glavne razlike

Makroi su namenjeni direktnoj, offline manipulaciji dokumentima. AI funkcije su namenjene integraciji AI modela sa ONLYOFFICE-om.

Evo kako se porede:

Aspekt	Makroi	AI Funkcije
Podešavanje	Lako – već ugrađeno	Složenije – podešavanje AI provajdera + prilagođene funkcije
Cena	Besplatno	Plaćeno (AI provajder naplaćuje)
Internet	Radi offline	Zahteva vezu sa AI uslugom
Preduslovi	JavaScript + Office API	JavaScript + Office API + AI agent izmene
Kriva učenja	Strma za neprogramere	Strma za neprogramere
Doslednost rezultata	Uvek isti izlaz	Može varirati
Fleksibilnost	Ograničeno – umotano u `CallCommand`	Fleksibilnije – pozovite `CallCommand` zasebno
Performanse	Brzo – direktno izvršavanje	Varijabilno – zavisi od AI vremena odgovora
Podrška verzija	Dostupno od ranih verzija	Beta (od v2.4.2)
Najbolje za	Programeri, precizna kontrola, offline automatizacija	Zadaci uz AI pomoć, operacije sa dokumentima i obrada
Privatnost	Samo lokalno izvršavanje	Podaci se šalju eksternom AI servisu

Kada se koristi koji alat

Makroi

Izaberite makroe kada vam je potrebna direktna manipulacija dokumentima:

Offline rad – nije potrebna internet konekcija.
Bez troškova – automatizujte koliko god želite besplatno.
Direktne operacije nad dokumentima – formatiranje, obrada podataka, proračuni.
Precizni rezultati – isti ulaz uvek daje isti izlaz.
Brzo prototipiranje – pišite kod i odmah ga testirajte u editoru.
Produkcioni rad – finansijski izveštaji, dokumenti za usklađenost (compliance), automatizovani tokovi rada.

AI funkcije

Izaberite AI funkcije kada vašoj automatizaciji trebaju AI mogućnosti:

Integracija AI modela – povezivanje sa AI servisima i korišćenje njihovih rezultata.
Automatizacija dokumenata – direktna primena AI rezultata u dokumentu.
Obrada konteksta – rad sa sadržajem uz razumevanje selekcije ili strukture dokumenta.
Napredna logika – potreba za fleksibilnošću pri izvršavanju prilagođenog koda pre i posle operacija nad dokumentom.

Zaključak

ONLYOFFICE makroi i AI funkcije služe različitim svrhama. Ključna razlika je jednostavna:

Makroi su namenjeni direktnoj manipulaciji dokumentima. Besplatni su, rade offline i savršeni su za svaku automatizaciju kojoj nije potrebna veštačka inteligencija. Koristite ih za formatiranje, proračune, obradu podataka i prilagođene formule.

AI funkcije su namenjene integraciji AI modela sa ONLYOFFICE-om. Složenije su za razvoj od makroa, zahtevaju internet konekciju i troškove AI provajdera, ali su pravi izbor kada su potrebne AI mogućnosti. Koristite ih za generisanje sadržaja, obradu dokumenata i automatizaciju zadataka pomoću AI.

ONLYOFFICE kontinuirano unapređuje oba alata. Makroi dobijaju nove funkcije poput asinhronih (async) funkcija. AI funkcije izlaze iz beta faze uz bolju pouzdanost i više mogućnosti. Razumevanje oba alata daje vam punu snagu ONLYOFFICE automatizacije.