AI Agent Pro — Dokumentacija

01 — Pregled

Što je AI Agent Pro?

AI Agent Pro je WordPress plugin koji vašoj stranici dodaje pametnog chat asistenta pogonjenog Anthropic Claude modelom. Agent se automatski prilagođava sadržaju vaše stranice i posjetiteljima odgovara kao da poznaje svaki detalj vašeg poslovanja.

Kako funkcionira?

Kada posjetitelj postavi pitanje, plugin automatski sastavlja kontekst koji uključuje navigaciju, ključne stranice, nedavne objave i kategorije s vaše stranice. Taj kontekst se šalje Anthropic Claude API-ju zajedno s pitanjem posjetitelja — rezultat je precizan, relevantan odgovor s klikabilnim linkovima na vaše stranice.

Administratori mogu u potpunosti prilagoditi ponašanje agenta: ime, boje widgeta, poruku dobrodošlice, sistemski prompt i model koji se koristi. Svi razgovori bilježe se u bazu podataka (uz GDPR kontrole), a optionalnim lead formom možete prikupljati kontakte zainteresiranih posjetitelja.

ℹ️

Plugin koristi vaš vlastiti Anthropic API ključ — troškovi API poziva idu izravno na vaš Anthropic račun. Plugin ne posreduje niti ne naplaćuje API korištenje.

02 — Zahtjevi sustava

Što je potrebno?

Provjerite ispunjava li vaš hosting okruženje minimalne zahtjeve prije instalacije.

WordPress

5.8+

Preporučeno: najnovija verzija

PHP

7.4+

Preporučeno: PHP 8.1 ili noviji

MySQL

5.6+

Ili MariaDB 10.1+

Anthropic API

Obavezan

Vlastiti API ključ s console.anthropic.com

HTTPS

Preporučen

Za sigurnu komunikaciju s API-jem

Licencni ključ

Obavezan

Format: AAGT-XXXX-XXXX-XXXX-XXXX

⚠️

Bez aktivnog licencnog ključa chat widget neće biti vidljiv posjetiteljima na frontendu, bez obzira na ostale postavke.

03 — Instalacija

Instalacija korak po korak

Plugin se instalira standardnim WordPress postupkom putem ZIP datoteke. Cijeli postupak traje manje od dvije minute.

1

Preuzmite plugin ZIP
Nakon kupnje primit ćete email s download linkom. Preuzmite ai-agent-pro.zip na svoje računalo.
2

Uploadajte u WordPress
U WordPress adminu idite na Dodaci → Dodaj novi → Prenesi dodatak, odaberite ZIP datoteku i kliknite Instaliraj sada.
3

Aktivirajte plugin
Nakon uspješne instalacije kliknite Aktiviraj dodatak. Plugin automatski kreira potrebnu tablicu u bazi podataka.
4

Unesite licencni ključ
Idite na AI Agent → Postavke → Licenca i unesite licencni ključ koji ste dobili uz kupnju. Kliknite Aktiviraj licencu.
5

Unesite Anthropic API ključ
Idite na AI Agent → Postavke → API i unesite vaš API ključ s console.anthropic.com. Ključ počinje s sk-ant-.
6

Widget je aktivan
Posjetite frontend vaše stranice — chat widget će se pojaviti u donjem desnom kutu (ili lijevom, prema postavci). Testirajte s pitanjem o sadržaju vaše stranice.

✅

Plugin nema build koraka — nema npm-a, webpacka ni Composera. Sve radi odmah nakon aktivacije.

04 — Konfiguracija

Postavke i konfiguracija

Sve postavke dostupne su pod AI Agent → Postavke u WordPress adminu. Grupirne su u logičke cjeline za lakše snalaženje.

API postavke

Postavka	Opis	Zadana vrijednost
`API ključ`	Vaš Anthropic API ključ (počinje s `sk-ant-`). Obavezan za rad agenta.	—
`Model`	Claude model koji se koristi za odgovore.	claude-haiku (brz, ekonomičan)
`Maks. tokeni`	Maksimalna duljina odgovora u tokenima (1 token ≈ 0,75 riječi).	1024

Izgled widgeta

Postavka	Opis	Zadana vrijednost
`Ime agenta`	Prikazano ime chatbota u headeru widgeta.	AI Asistent
`Boja widgeta`	Primarna boja gumba i headera (HEX format).	#2563eb
`Pozicija`	Položaj widgeta na ekranu: desno dolje ili lijevo dolje.	Desno
`Poruka dobrodošlice`	Prva poruka koju agent šalje kada posjetitelj otvori chat.	Bok! Kako vam mogu pomoći?

Ponašanje agenta

Postavka	Opis	Zadana vrijednost
`Sistemski prompt`	Dodatne upute za agenta (ton, ograničenja, specijalizacija). Dodaju se uz automatski kontekst stranice.	—
`Widget aktivan`	Globalni prekidač za prikaz widgeta na frontendu.	Uključeno
`Prikupi leadove`	Prikazuje obrazac za email/ime nakon razgovora.	Isključeno

GDPR postavke

Postavka	Opis	Zadana vrijednost
`Obavijest o privatnosti`	Prikazuje kratku GDPR obavijest u widgetu s linkom na politiku privatnosti.	Uključeno
`URL politike privatnosti`	Link na stranicu s politikom privatnosti.	—
`Zadržavanje podataka`	Nakon koliko dana se automatski brišu zapisnici razgovora.	90 dana

ℹ️

Sve postavke se čuvaju kao WordPress opcije s prefiksom aagt_. Možete ih dohvatiti programski s get_option('aagt_api_key') i sličnim pozivima.

05 — Značajke

Sve funkcije plugina

AI Agent Pro donosi kompletan set alata za inteligentni chat na vašoj WordPress stranici — od automatskog čitanja sadržaja do GDPR sukladnog upravljanja podacima.

🧠

Automatski kontekst stranice

Agent automatski čita navigaciju, stranice, objave i kategorije. Posjetiteljima odgovara u kontekstu vašeg sadržaja.

🔗

Klikabilni linkovi u odgovorima

Odgovori uključuju Markdown linkove na relevantne stranice vašeg weba. Posjetitelji mogu direktno kliknuti.

🎨

Potpuno prilagodljiv izgled

Promijenite boju, poziciju, ime agenta i poruku dobrodošlice. Widget se uklapa u vaš branding.

🤖

Izbor Claude modela

Odaberite između Claude Haiku (brz i ekonomičan) i Claude Sonnet (napredniji odgovori) prema potrebama.

📋

Zapisnik razgovora

Svi razgovori bilježe se u lokalnu bazu podataka. Pregledajte ih u admin sučelju s filterima po datumu i URL-u.

📧

Lead capture obrazac

Optionalni obrazac za prikupljanje emailova i imena zainteresiranih posjetitelja nakon razgovora.

🛡️

Rate limiting

Automatsko ograničenje na 40 poruka po sesiji po satu štiti od zlonamjernog korištenja i kontrolira API troškove.

🔐

Licencni sustav

Aktivacija licencnog ključa. Svakodnevna provjera licencnog statusa. Bez aktivne licence widget se skriva.

🗑️

Automatsko brisanje podataka

Tjedni cron automatski briše stare zapisnike razgovora prema konfiguriranom roku zadržavanja (90–730 dana).

✍️

Sistemski prompt

Definirajte ton, ograničenja i specijalizaciju agenta. Vlastite upute se dodaju uz automatski kontekst stranice.

📍

Kontekst po stranici

Agent zna na kojoj se stranici posjetitelj trenutno nalazi i prilagođava odgovore toj lokaciji.

🌐

REST API endpoints

Sve funkcije dostupne su putem WordPress REST API-ja za naprednu integraciju s drugim sustavima.

Chat widget

Widget se prikazuje kao lebdeći gumb u donjem kutu svake stranice. Klikom se otvara chat sučelje u koje posjetitelj može unijeti pitanje. Agent odgovara u roku nekoliko sekundi, a razgovor se čuva za cijelu sesiju — posjetitelj može nastaviti razgovor pri prelasku na drugu stranicu.

Widget se automatski sadrži: jQuery kôd koji pokreće sučelje učitava se samo kad je plugin aktivan i licenca validna. CSS stilovi su izolirani i ne utječu na ostatak stranice.

Prikupljanje leadova

Kada je opcija Prikupi leadove uključena u postavkama, posjetitelju se nakon razgovora prikazuje kratki obrazac za unos imena i emaila. Prikupljeni podaci bilježe se u bazu i vidljivi su u admin sučelju pod AI Agent → Leadovi.

⚠️

Ako prikupljate emailove, obavezno navedite svrhu obrade u politici privatnosti i osigurajte pravnu osnovu za obradu osobnih podataka (suglasnost, legitimni interes).

Zapisnik razgovora

Svaka poruka (pitanje posjetitelja i odgovor agenta) bilježi se u tablicu {prefix}aagt_log s podatcima: session ID, uloga (user/assistant), sadržaj poruke, URL stranice i vremenski žig.

IP adrese se nikada ne bilježe. Zapisi se automatski brišu prema postavljenom roku zadržavanja.

06 — Kratki kod

Postavljanje widgeta na stranicu

AI Agent Pro widget prikazuje se automatski na svim stranicama. Ako želite ručno kontrolirati gdje se widget pojavljuje, možete koristiti kratki kod ili PHP funkciju.

Automatski prikaz (zadano)

Po zadanim postavkama widget se ubacuje u wp_footer hook i prikazuje na svim stranicama sjedišta. Ovo je preporučeni način rada — ne treba ništa posebno postavljati.

Ručno isključiti automatski prikaz

Ako želite prikazati widget samo na određenim stranicama, isključite globalnu opciju Widget aktivan u postavkama, a zatim dodajte kratki kod na željene stranice:

[ai_agent_widget] Dodajte u sadržaj stranice ili widgeta

PHP poziv u predlošku

Ako preferirate PHP integraciju direktno u temu:

<?php do_shortcode('[ai_agent_widget]'); ?> U template datoteci teme

ℹ️

Kratki kod prikazuje widget samo ako je licenca aktivna i opcija widgeta uključena u postavkama. Ako je jedno od toga neaktivno, kratki kod ne ispisuje ništa.

07 — GDPR i privatnost

Zaštita podataka i GDPR sukladnost

AI Agent Pro projektiran je uz GDPR u prvom planu. Minimalno prikupljanje podataka, jasne obavijesti posjetiteljima i alati za brisanje podataka na zahtjev.

Što se prikuplja?

Podatak	Svrha	Čuva se?
Sadržaj razgovora (poruke)	Prikazivanje razgovora u zapisniku, analiza kvalitete	Da — do isteka roka zadržavanja
Session ID (anoniman)	Grupiranje poruka iste sesije	Da — uz svaku poruku
URL stranice	Kontekst razgovora, analytics	Da — uz svaku poruku
IP adresa	Rate limiting (u memoriji)	Ne — nikada se ne zapisuje u bazu
Email i ime (lead capture)	Prikupljanje zainteresiranih posjetitelja	Samo ako je opcija uključena i posjetitelj dobrovoljno unese

Prava posjetitelja

Pravo na informiranost — GDPR obavijest prikazuje se u widgetu s linkom na politiku privatnosti.
Pravo na brisanje — Gumb "Izbriši moje podatke" u widgetu šalje zahtjev na REST endpoint koji obavještava administratora. SLA za brisanje: 72 sata.
Automatsko brisanje — Tjedni cron automatski briše zapise starije od konfiguriranog roka.

Vaše obveze kao vlasnika stranice

Navesti korištenje AI chata u politici privatnosti vaše stranice.
Informirati posjetitelje da se razgovori šalju Anthropic API-ju (third-party procesor).
Ako koristite lead capture, navesti pravnu osnovu za obradu emailova.
Odgovoriti na zahtjeve za brisanje podataka u zakonskom roku (30 dana).

ℹ️

Anthropic obrađuje podatke prema vlastitim uvjetima korištenja i GDPR politici. Preporučujemo dodati Anthropic kao "procesora podataka" u vaš GDPR registar aktivnosti.

08 — Licenciranje

Aktivacija licencnog ključa

AI Agent Pro koristi licencni sustav za zaštitu od neovlaštenog korištenja. Svaki licencni ključ vezan je za jednu domenu.

Format licencnog ključa

AAGT-XXXX-XXXX-XXXX-XXXX Format ključa koji ste dobili kupnjom

1

Kopirajte ključ

Iz emaila koji ste dobili nakon kupnje.

2

Otvorite postavke

AI Agent → Postavke → Licenca

3

Unesite i aktivirajte

Zalijepite ključ i kliknite "Aktiviraj licencu".

4

Provjerite status

Status "Aktivna" znači da je sve ispravno.

Statusi licence

Status	Opis	Widget vidljiv?
Neaktivna	Ključ još nije aktiviran na ovoj domeni	Ne
Aktivna	Licenca validna, domena potvrđena	Da
Istekla	Rok licenciranja je prošao	Ne
Opozvana	Licenca je ručno opozvana	Ne

⚠️

Licenca se automatski provjerava jednom dnevno (cron job). Ako dođe do promjene domene ili problema s mrežnom vezom, provjera može privremeno prikazati grešku — ručno deaktivirajte i reaktivirajte licencu da biste riješili problem.

09 — Česta pitanja

Odgovori na česta pitanja

Pronašli smo najčešća pitanja korisnika AI Agent Pro plugina.

Tko plaća Anthropic API troškove?

Vi — kao vlasnik stranice. Plugin koristi vaš vlastiti Anthropic API ključ koji upišete u postavke. Troškovi idu izravno na vaš Anthropic račun. Plugin ne posreduje niti ne naplaćuje API korištenje. Anthropic nudi besplatni kredit za početak; detaljne cijene nalaze se na anthropic.com/pricing.

Mogu li koristiti plugin na više stranica s jednom licencom?

Ne — jedna licenca vrijedi za jednu domenu. Svaka stranica zahtijeva vlastiti licencni ključ. Kupnjom više licenci dobivate popust — kontaktirajte nas za višestruke licence.

Koji Claude model je preporučen?

Za većinu stranica preporučujemo claude-haiku — brz je, ekonomičan i daje odlične odgovore za tipična pitanja posjetitelja. Ako vaša stranica zahtijeva složenije analize ili duže odgovore (npr. tehnička dokumentacija, kompleksni proizvodi), preporučujemo claude-sonnet.

Hoće li widget usporiti moju stranicu?

Minimalno. Widget JavaScript (jQuery) učitava se odgođeno (defer) i ne blokira renderiranje stranice. Sama stranica API ne kontaktira dok posjetitelj ne postavi pitanje. Na Core Web Vitals (LCP, CLS) utjecaj je zanemariv.

Agent daje netočne odgovore — što učiniti?

Koristite Sistemski prompt u postavkama za preciziranje ponašanja agenta. Primjer: "Odgovaraj samo na pitanja vezana uz naše usluge. Ako nisi siguran, predloži posjetitelju da kontaktira podršku." Osim toga, provjerite jesu li ključne stranice objavljene i javno dostupne — agent čita samo javni sadržaj.

Mogu li isključiti widget na određenim stranicama?

U trenutnoj verziji widget se prikazuje ili na svim stranicama (kad je globalna opcija uključena) ili samo tamo gdje ste dodali kratki kod [ai_agent_widget] (kad je globalna opcija isključena). Filtriranje po kategorijama stranica planirano je u nadolazećoj verziji 1.1.

Što se događa s razgovorima nakon deinstalacije?

Deaktivacija plugina ne briše podatke. Potpuna deinstalacija (uklanjanje iz WordPressa) briše WordPress opcije plugina, ali tablica {prefix}aagt_log ostaje u bazi radi sigurnosti. Ako želite potpuno brisanje, ručno izbrišite tablicu putem phpMyAdmin-a ili koristite opciju "Izbriši sve podatke" u naprednim postavkama prije deinstalacije.

Podržava li plugin višejezične stranice (WPML, Polylang)?

Da, uz određena ograničenja. Agent automatski čita sadržaj stranice na kojoj se posjetitelj nalazi — ako je stranica na hrvatskom, odgovarati će na hrvatskom. Za potpunu višejezičnu podršku preporučujemo u Sistemski prompt dodati: "Uvijek odgovaraj na jeziku na kojem posjetitelj piše." Formalna integracija s WPML API-jem planirana je za verziju 1.2.

10 — Zapisnik promjena

Changelog

Pregled svih verzija, novih funkcija, poboljšanja i ispravaka grešaka.

v1.0.0

Svibanj 2026

Novo Inicijalno izdanje AI Agent Pro plugina
Novo Chat widget s prilagodljivim izgledom (boja, pozicija, ime)
Novo Automatsko čitanje sadržaja WordPress stranice za kontekst
Novo Integracija s Anthropic Claude API-jem (Haiku i Sonnet modeli)
Novo Klikabilni Markdown linkovi u odgovorima agenta
Novo Admin zapisnik razgovora s filterima
Novo Prikupljanje leadova (opt-in)
Novo Rate limiting (40 poruka/sesija/sat)
Novo Licencni sustav s verifikacijom domene
Novo GDPR obavijest i REST endpoint za brisanje podataka
Novo Automatsko brisanje starih zapisa (cron)
Novo Sistemski prompt za prilagodbu ponašanja agenta