Dokumentacija · v2.3.2
AI Agent za WordPress
AI asistent pokretan Anthropic Claudeom koji odgovara posjetiteljima iz sadržaja vaše stranice — 24/7, na vašem brandu i jeziku. Koristite vlastiti Anthropic API ključ i upravljate podacima.
1. Uvod
AI Agent je chat asistent za WordPress koji pokreće Anthropic Claude. Odgovara posjetiteljima na temelju onoga što mu zadate u system promptu — o vašim uslugama, cijenama, radnom vremenu i kontaktima — 24 sata dnevno, na jeziku posjetitelja.
Model plaćate izravno Anthropicu preko vlastitog API ključa (vi kontrolirate trošak i podatke). media-met naplaćuje samo licencu za dodatak, ne korištenje AI-ja.
2. Instalacija
- U WordPress adminu otvorite Dodaci → Dodaj novi → Učitaj dodatak i učitajte ZIP.
- Aktivirajte dodatak. U izborniku se pojavi AI Agent.
- Otvorite AI Agent → Postavke za daljnju konfiguraciju.
3. Aktivacija licence
- Otvorite AI Agent → Postavke.
- Zalijepite licencni ključ koji ste dobili e-mailom i kliknite Aktiviraj.
Format ključa: AAGT-XXXX-XXXX-XXXX-XXXX
Uvjeti licence:
- Licenca vrijedi 12 mjeseci od aktivacije i provjerava se preko media-met licencnog servera.
- Broj domena ovisi o planu: Starter (1 domena), Business (3 domene), Agency (neograničeno).
- Licencu možete deaktivirati i premjestiti na drugu domenu (Postavke → Deaktiviraj → Aktiviraj na novoj).
4. Anthropic API ključ
Svaki korisnik koristi vlastiti Anthropic API ključ.
- Registrirajte se na console.anthropic.com i otvorite Settings → API Keys.
- Kreirajte ključ i kopirajte ga.
- Zalijepite ga u AI Agent → Postavke i spremite.
- Dodajte kredit u Billing na Anthropic konzoli.
Trošak: Preporučeni model je Claude Haiku — brz i ekonomičan. Za stranicu s ~50 posjeta dnevno tipičan trošak je svega nekoliko eura mjesečno, plaćeno izravno Anthropicu po korištenju.
5. System prompt
System prompt je najvažnija postavka — njime opisujete što stranica nudi, ton komunikacije i kontakt podatke. Što je bogatiji, to su odgovori točniji.
Primjer za agenciju:
„Ti si asistent digitalne agencije [naziv]. Informiraš potencijalne klijente o uslugama (izrada web stranica, SEO, brendiranje), cijenama i procesu suradnje. Kontakt: info@agencija.hr.“
Napomena: Agent odgovara isključivo na temelju onoga što mu zadate. Ako daje nepotpune ili netočne odgovore, proširite system prompt s više detalja.
6. Widget i izgled
- Uključite opciju Widget aktivan u postavkama da se chat prikaže posjetiteljima.
- Widget možete prikazati automatski na cijeloj stranici ili ga ubaciti shortcodeom odnosno blokom na željeno mjesto.
- Prilagodite boje, ime i avatar asistenta da odgovaraju vašem brandu.
7. Jezik
Agent automatski odgovara na jeziku posjetitelja. Ako želite da uvijek odgovara na hrvatskom, dodajte u system prompt: „Uvijek odgovaraj na hrvatskom jeziku, bez obzira na jezik pitanja.“
8. GDPR i privatnost
Postajete voditelj obrade: Instalacijom dodatka postajete voditelj obrade osobnih podataka posjetitelja koji koriste chat. Obavezno uskladite privatnost.
- Ažurirajte Pravila privatnosti na svojoj stranici i unesite njihov URL u AI Agent → Postavke → GDPR.
- Ostavite uključenu Obavijest o privatnosti u chatu.
- IP adresa se ne sprema. Razgovori se automatski brišu prema zadanom roku (zadano 12 mjeseci).
- Razgovorima upravljate u AI Agent → Razgovori — „Obriši sve” ili pojedinu sesiju „Obriši sesiju (GDPR)“.
9. Rješavanje problema
„Problem s mrežom” — chat ne radi
| Mogući uzrok | Rješenje |
|---|---|
| API ključ nije unesen ili je neispravan | AI Agent → Postavke → provjerite API ključ |
| Nema kredita na Anthropic računu | console.anthropic.com → Billing → dodajte kredit |
| Licenca nije aktivna | AI Agent → Postavke → aktivirajte licencni ključ |
| Hosting blokira REST API | Zatražite od hostinga dozvolu pristupa /wp-json/aagt/v1/ |
| ModSecurity / WAF blokira zahtjeve | Isključite ModSecurity za svoju domenu u cPanelu |
Widget se ne prikazuje
- Provjerite je li „Widget aktivan” uključen i je li licenca aktivna (zeleni status).
- Osvježite stranicu tvrdim osvježavanjem (
Ctrl/Cmd + Shift + R). - Privremeno isključite ostale dodatke da provjerite postoji li sukob.
Agent odgovara na engleskom ili netočno
Dopunite system prompt — za jezik dodajte uputu da uvijek odgovara na hrvatskom, a za točnost dodajte više detalja o uslugama, cijenama i kontaktima.
10. Obnova licence
Licenca vrijedi 12 mjeseci od aktivacije. Datum isteka vidite u AI Agent → Postavke; dodatak stanje licence provjerava jednom dnevno.
Po isteku: chat widget i dalje radi za posjetitelje, a postavke i razgovori ostaju netaknuti. Prestaju samo automatske nadogradnje i podrška — u adminu se prikazuje obavijest „Licenca je istekla”. Widget se ne prikazuje samo ako licenca nije aktivirana ili ju je licencni poslužitelj odbio (npr. opozvana licenca ili kriva domena).
Obnova: javite nam se na info@media-met.hr s naznakom „Obnova AI Agent licence”, platite obnovu i u Postavkama deaktivirajte stari pa aktivirajte novi ključ.
11. Tehnički zahtjevi
- 5.8+ WordPress (6.x testiran)
- 7.4+ PHP (8.x preporučeno)
- Claude Anthropic API ključ
- HR / EN + višejezični razgovor
- po domeni licenca + provjera
12. Česta pitanja
Trebam li vlastiti Anthropic API ključ?
Da. Svaki korisnik koristi vlastiti ključ i plaća Anthropicu izravno po korištenju. media-met naplaćuje samo licencu za dodatak.
Koliko košta korištenje AI-ja?
Ovisi o prometu i modelu. Uz Claude Haiku, za stranicu s ~50 posjeta dnevno trošak je obično svega nekoliko eura mjesečno.
Na koliko domena vrijedi licenca?
Ovisi o planu: Starter 1 domena, Business 3 domene, Agency neograničeno. Licencu možete deaktivirati i premjestiti na drugu domenu.
Odgovara li samo o mom sadržaju?
Da — agent odgovara na temelju system prompta koji mu zadate. Što ga detaljnije opišete, to su odgovori precizniji.
Koje podatke prikuplja?
Sadržaj razgovora, URL stranice i po želji e-mail posjetitelja. IP adresa se ne sprema, a razgovori se automatski brišu prema zadanom roku.
Radi li na hrvatskom?
Da. Agent odgovara na jeziku posjetitelja, a uputom u system promptu možete ga prisiliti da uvijek odgovara na hrvatskom.
13. Kontakt i podrška
Za pitanja i pomoć javite nam se na info@media-met.hr (uključite URL stranice, opis problema i snimku zaslona greške). Više o proizvodima i uslugama na media-met.hr.