🔌

AI Agenti (spoljašnji pristup)

Poveži ChatGPT, Claude Desktop ili custom skriptu sa KoloConnect API-jem preko Personal Access Tokena.

Otvori AI Agente

1AI 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

  1. 1
    Otvori AI Agenti → tabTokeni
  2. 2
    Klikni+ Novi token
  3. 3
    Daj mu opisno ime (npr. "Claude Desktop", "Python skripta za fakture").
  4. 4
    Izaberi scope-ove: token nasleđuje TVOJE dozvole — ne može više od tebe.
  5. 5
    KlikniGeneriši
  6. 6
    KOPIRAJ 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:

  1. 1
    curl -H "Authorization: Bearer kc_pat_…" https://api.koloconnect.com/ai-agent/me
  2. 2
    Odgovor 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

  1. 1
    READ: pretraga kupaca, dobavljača, faktura, wiki, zaliha…
  2. 2
    WRITE: nacrt fakture, kreiranje zadatka, otpremnice, post u chat…
  3. 3
    Action confirmation: prepare vraća actionId, ti kao korisnik potvrđuješ kroz UI ili token tvojih dozvola.
  4. 4
    Audit: svaki agent poziv se loguje u Revizorski dnevnik (filter: PAT origin).