AI Agenti (spoljašnji pristup)
Poveži ChatGPT, Claude Desktop ili custom skriptu sa KoloConnect API-jem preko Personal Access Tokena.
Otvori AI Agente1AI Agenti vs AI Asistent
Agenti su spoljašnji AI alati (ChatGPT, Claude Desktop, Python skripte) koji preko REST API-ja pristupaju tvojim KoloConnect podacima. Asistent je chat panel ugrađen UNUTAR aplikacije. Agenti = automatizacija sa spoljnim AI-jem. Asistent = pomoć dok koristiš aplikaciju.
2Kreiraj Personal Access Token
- 1Otvori AI Agenti → tabTokeni
- 2Klikni+ Novi token
- 3Daj mu opisno ime (npr. "Claude Desktop", "Python skripta za fakture").
- 4Izaberi scope-ove: token nasleđuje TVOJE dozvole — ne može više od tebe.
- 5KlikniGeneriši
- 6KOPIRAJ TOKEN ODMAH — prikazuje se samo jednom.
Pravilo: jedan token po alatu. Ako ti Claude i ChatGPT istovremeno trebaju, pravi dva tokena — možeš pojedinačno da ih opozoveš ako neki procuri.
Česti problemi
Izgubio sam token▾
Ne može se povratiti. Opozovi stari (Tokeni → 3 tačke → Opozovi) i generiši novi.
3Granularne dozvole
Svaki capability ima oznaku READ ili WRITE. WRITE akcije (kreiranje fakture, slanje otpremnice…) uvek zahtevaju potvrdu kroz /actions/prepare → /actions/confirm flow sa 5-min expiry-jem. Token koji nema permission za neki modul ne može da koristi tools tog modula.
4Test poziv (curl)
Provera da token radi:
- 1curl -H "Authorization: Bearer kc_pat_…" https://api.koloconnect.com/ai-agent/me
- 2Odgovor sadrži tenantId, userId i listu capabilities.
Endpoint katalog i primere pogledaj u tabovima "Endpointi" i "Primeri" na AI Agenti strani.
5Šta agent može da uradi
- 1READ: pretraga kupaca, dobavljača, faktura, wiki, zaliha…
- 2WRITE: nacrt fakture, kreiranje zadatka, otpremnice, post u chat…
- 3Action confirmation: prepare vraća actionId, ti kao korisnik potvrđuješ kroz UI ili token tvojih dozvola.
- 4Audit: svaki agent poziv se loguje u Revizorski dnevnik (filter: PAT origin).