Tok rada: ArvisAI — AI asistent i transkripcija zvuka

Uključeni moduli: ArvisAI (Čet · Generator slika · Transkripcija zvuka · Prevod zvuka · Motor šablona) · Tiketi
Ko ga koristi: Bilo koji zaposleni sa aktiviranim pristupom · Podrška (automatski odgovor na tiket)
AI provajder: Isključivo OpenAI (GPT, DALL-E, Whisper)

Pregled

ArvisAI je čvorište AI alata zasnovano isključivo na OpenAI-u. Pruža 5 različitih funkcionalnosti dostupnih iz bočnog menija, plus jednu automatizovanu CRM integraciju: automatski odgovor pri otvaranju tiketa.

5 alata:

Podaci su privatni po korisniku. Sve istorije (čet, slike, transkripcije, dokumenti) se filtriraju po user_id = current_staff. Ne postoji vidljivost između korisnika niti veza sa CRM zapisima (lid, klijent, projekat) — osim za automatski odgovor na tiket.

Transkripcija i prevod: samo otpremanje fajlova. Ne postoji snimanje u realnom vremenu niti unos URL-a. Prihvaćeni formati: .mp3, .m4a. Konfigurabilan limit veličine (arvisai_audio_transcription_max_size).

Dijagram toka

[PODEŠAVANJE — admin, jednom]
  │
  ├── ArvisAI → Podešavanja (samo admin):
  │     ├── arvisai_openai_secret_key (OpenAI API ključ)
  │     ├── Model četa: GPT-3.5-turbo / GPT-4 / GPT-4o / GPT-5, itd.
  │     ├── Model slike: default / DALL-E-2 / DALL-E-3
  │     ├── arvisai_audio_transcription_max_size (bajti, podrazumevano ~100KB)
  │     ├── arvisai_audio_transcription_allowed_extensions (.mp3,.m4a)
  │     └── Automatski odgovor na tiket: arvisai_ai_autoreply_on_opening_ticket (0/1)
  │           arvisai_ai_reply_agent_name · agent_title · agent_staff_id
  │
  ↓
════════════════════════════════════
ALAT 1: ČET
════════════════════════════════════
  │
  ├── ArvisAI → Čet → unesite poruku
  ├── POST /v1/chat/completions (streaming)
  ├── Odgovor sačuvan u arvisai_chat: human_message + ai_response
  └── Istorija vidljiva samo tekućem zaposlenom (filtrirano po user_id)
  │
════════════════════════════════════
ALAT 2: GENERATOR SLIKA
════════════════════════════════════
  │
  ├── ArvisAI → Generator slika → opišite sliku
  ├── POST /v1/images/generations (DALL-E)
  ├── Slika preuzeta sa OpenAI URL-a → sačuvana lokalno
  │     (modules/arvisai/uploads/generated_images/{id}/)
  └── Sačuvana u arvisai_images (user_id + lokalni image_url)
  │
════════════════════════════════════
ALAT 3: TRANSKRIPCIJA ZVUKA
════════════════════════════════════
  │
  ├── ArvisAI → Transkripcija zvuka → Otpremi fajl (.mp3/.m4a)
  ├── Provera: dozvoljena ekstenzija + veličina ≤ konfigurisani limit
  ├── Fajl sačuvan lokalno: uploads/audio_transcription/{id}/
  ├── POST /v1/audio/transcriptions (Whisper-1)
  │     → izlaz: tekst na ISTOM jeziku kao originalni zvuk
  └── Sačuvano u arvisai_audio_transcription: audio_file_path + transcription_text
  │
════════════════════════════════════
ALAT 4: PREVOD ZVUKA
════════════════════════════════════
  │
  ├── ArvisAI → Prevod zvuka → Otpremi fajl (.mp3/.m4a)
  ├── POST /v1/audio/translations (Whisper-1)
  │     → izlaz: UVEK na engleskom, bez obzira na izvorni jezik
  └── Sačuvano u arvisai_translated_audio: audio_file_path + translated_text
  │
════════════════════════════════════
ALAT 5: MOTOR ŠABLONA
════════════════════════════════════
  │
  ├── ArvisAI → Šabloni → odaberi šablon
  ├── Šablon ima polja promenljivih ({{variable_name}}) definisanih u custom_inputs JSON-u
  ├── Popunite polja + odaberite Ton glasa + Jezik
  ├── POST /v1/chat/completions sa promptom = custom_prompt + vrednosti promenljivih + ton + jezik
  ├── Izlaz se pojavljuje u TinyMCE editoru
  └── Opciono: Sačuvaj kao dokument → arvisai_documents (document_name + HTML sadržaj)
  │
════════════════════════════════════
CRM INTEGRACIJA: AUTO ODGOVOR NA TIKETE
════════════════════════════════════
  │
  ├── Uslov: arvisai_ai_autoreply_on_opening_ticket = 1
  ├── Hook: ticket_created → arvisai_ticket_created_automated_reply()
  ├── Dodatni uslov: ticket.admin NIJE NULL (tiket mora imati dodeljenog zaposlenog)
  ├── Prompt izgrađen: "Radim kao {agent_title} i zovem se {agent_name}...
  │     Napiši odgovor na tiket o '{ticket_message}'... odgovori na istom jeziku..."
  ├── POST /v1/chat/completions
  └── Odgovor dodat kao odgovor na tiket, pripisuje se arvisai_ai_reply_agent_staff_id
        adminread = 0 (označeno kao nepročitano)

[AI KORIŠĆEN ✓ · TIKET AUTO-ODGOVOREN ✓]

Korak po korak

1. Podešavanje (admin)

Gde: /admin/arvisai → Podešavanja (zahteva is_admin())

Obavezna konfiguracija:

Opciona konfiguracija:

Konfiguracija automatskog odgovora na tiket:

Upozorenje: Sa omogućenim automatskim odgovorom, svaki novi kreiran tiket (sa dodeljenim zaposlenim) će automatski dobiti AI generisan odgovor. Testirajte sa test tiketom pre omogućavanja u produkciji.

2. Motor šablona — upotreba i kreiranje šablona

Gde: /admin/arvisai/templates

Šabloni unapred sačuvani pri instalaciji: Napiši predlog · Facebook oglasi · Napiši ugovor · Hladni email · Dobrodošlica email · Praćenje email · Generator članaka · Preradi sadržaj · Rezimi tekst · Opis proizvoda

Kreiranje prilagođenog šablona:

Primer custom_prompt:

Write a cold email for a prospect in the {{industry}} industry. 
Focus on {{pain_point}} and mention our {{product_name}} solution.

Opcije Tona glasa (12): duhovit · ležeran · uzbuđen · profesionalan · duhovit · sarkastičan · ženski · muški · smeo · dramatičan · mrzovoljan · tajanstven

Polje Jezik: slobodan tekst — unesite bilo koji jezik (npr.: "Serbian", "Romanian"). Dodaje se promptu sa uputstvom da piše na tom jeziku.

3. Transkripcija zvuka vs. Prevod zvuka

Preporučeni tok rada:

• Imate srpski snimak → Transkripcija → dobijate tekst na srpskom
• Imate snimak na bilo kom jeziku i želite na engleskom → Prevod
• Želite da kopirate transkripciju u drugi CRM modul (lid, tiket, napomena) → ručno kopiranje (nema dugmeta za automatski prenos)

4. Generisani dokumenti

Gde: /admin/arvisai/documents

Dokumenti sačuvani iz Motora šablona čuvaju se u tblArvisai_documents sa:

• document_name — naziv dokumenta
• document_description — HTML sadržaj (generisan u TinyMCE)

Ograničenja: dokumenti nemaju vezu sa drugim CRM entitetima (lid, klijent, projekat). Vidljivi su isključivo zaposlenom koji ih je kreirao (user_id = get_staff_user_id()).

Potrebne dozvole

Napomena: Ne postoji dozvola create_chat — ko god može videti Čet, može i slati poruke.

Česte greške

Reference modula

• Tiketi — automatski odgovor pri otvaranju tiketa
• WhatsApp — drugi kanal sa AI odgovorima (bot_type=12, odvojeno konfigurabilan provajder)
• ArvisAI — dokumentacija modula