Voice, Plugin dan Layanan dengan Model Sendiri

Buka di CMS

Chat bukan satu-satunya yang mengirim data Anda ke model AI. Voice note ditranskripsi, balasan diucapkan, PDF hasil scan dibaca, logo digambar, plugin menulis SQL dan pertanyaan form, dan agent mencari di web. Semua ini bisa berjalan di model dan key milik Anda sendiri, sehingga data tetap di akun yang Anda kendalikan dan modelnya tidak memakai credit Qlar.

Siapa yang bisa? Owner dan Admin organization. Pilihannya berlaku untuk semua agent di organization.


Apa saja yang bisa berjalan di akun Anda

PekerjaanTempat memilihYang dibutuhkanProvider
Speech to text (dikte, voice note WhatsApp)Tasks › VoiceModel speech-to-text, misalnya gpt-transcribe, gpt-4o-transcribe atau whisper-1OpenAI, Azure OpenAI, OpenAI-compatible
Text to speech (balasan WhatsApp yang diucapkan, voice preview)Tasks › VoiceModel text-to-speech, misalnya gpt-4o-mini-ttsOpenAI, OpenAI-compatible
Voice calls (turn-by-turn)Tasks › Voice › Voice calls · Turn-by-turn, atau per agent di halaman Voice-nya › Voice runs onModel realtime voice, misalnya gpt-realtime-2.1 atau gpt-realtime-2.1-miniOpenAI, Azure OpenAI
Voice calls (Natural conversation)Tasks › Voice › Voice calls · Natural conversation, atau per agent di halaman Voice-nya › Voice runs onModel GPT-Live, gpt-live-1OpenAI, Azure OpenAI
Read scanned PDFsTasks › Chat helpersModel chat yang menerima gambarAPI key apa pun
Logo imageTasks › Builder assistantsModel gambar, misalnya gpt-image-2 atau gpt-image-1OpenAI, Azure OpenAI
Plugin: Chat Form, SQL Database Reader, Dynamic TableTasks › PluginsModel chatAPI key apa pun
Web searchSources › Service keys, lalu Tasks › Other servicesAPI key ExaExa
Knowledge searchTasks › Other servicesModel embeddingLihat Knowledge Search dengan Model Sendiri

Public Documents (plugin pustaka dokumen bersama) dan transkripsi video knowledge selalu berjalan di Qlar.

Berbeda dengan chat helpers, pekerjaan ini tidak pernah meminjam model grupnya: pekerjaan voice, gambar, atau PDF scan baru berjalan di model Anda bila Anda memilih model untuknya.


Sebelum mulai

Tambahkan modelnya di tab Sources, di bawah API key dari provider yang menyediakannya. Lihat Memakai API Key Sendiri.

Buka halaman Organizations → pilih organization Anda → Manage organization → tile AI Models → tab Sources → Add API key (atau Add models di key yang sudah ada).

  • Dari daftar Qlar: centang modelnya. Model speech, gambar, dan realtime menampilkan jenisnya, bukan chip kemampuan.
  • Model yang tidak ada di daftar: Add a model that isn't listed, ketik Model name-nya, lalu nyalakan jenisnya:
    • Speech-to-text model (for dictation and voice notes)
    • Text-to-speech model (for spoken replies and voice previews)
    • Realtime voice model (for voice calls)
    • untuk model gambar, Produces › Image

Switch hanya muncul untuk provider yang bisa menyediakan jenis model itu. Model ini hanya ditawarkan untuk pekerjaannya sendiri, tidak pernah sebagai model chat.


Voice

Tab Tasks → Voice. Setiap baris punya picker sendiri; biarkan kosong untuk tetap memakai model Qlar (tampil sebagai placeholder, misalnya "Qlar text to speech (gpt-4o-mini-tts)").

Grup Voice di tab Tasks: Speech to text di my-stt, Text to speech di my-tts, keduanya Runs on Your API key, dan Voice calls di model realtime my-realtime dengan Your OpenAI account · 2 agents
  • Speech to text mentranskripsi dikte di chat dan voice note WhatsApp.
  • Text to speech mengucapkan balasan agent sebagai voice note WhatsApp, dan voice preview di halaman Voice agent.
  • Voice calls · Turn-by-turn menjalankan panggilan turn-by-turn di model realtime dan key OpenAI atau Azure OpenAI Anda. Di Azure, tambahkan modelnya dengan nama deployment realtime Anda. Baris ini juga menawarkan voice Qlar yang lebih murah, Qlar realtime voice mini (gpt-realtime-2.1-mini), yang tidak memerlukan key sendiri.
  • Voice calls · Natural conversation menjalankan panggilan Natural conversation di model GPT-Live Anda (gpt-live-1). Biarkan kosong untuk GPT-Live milik Qlar. Lihat Natural conversation di akun OpenAI Anda.

Kedua baris ini adalah default organization Anda. Keduanya berlaku untuk setiap agent yang Voice runs on-nya di halaman Voice dibiarkan di Organization default, yaitu titik awal setiap agent; agent bisa memilih voice lain di sana. Setiap baris menghitung agent-nya menurut tempat panggilannya berjalan, dan Show agents menampilkan setiap agent, misalnya "Turn-by-turn · your OpenAI account (my-realtime) · organization default".

Baris Voice calls dengan Realtime model my-realtime, chip Your OpenAI account · 2 agents, dan daftar agent: Ani dan Budi, keduanya Turn-by-turn · your OpenAI account

Bila akun OpenAI Anda tidak bisa menerima panggilan (key tidak valid, kuota habis), panggilan berakhir dan penelepon melihat "Voice is unavailable right now. Please try again later or type your message." Alasannya hanya ada di log Anda, tidak pernah ditampilkan ke penelepon. Agent Natural conversation di langganan Anda tetap memakai setelannya sendiri.

Natural conversation di akun OpenAI Anda

Panggilan Natural conversation (GPT-Live) juga bisa berjalan di akun OpenAI atau Azure OpenAI organization Anda:

  1. Di tab Sources, tambahkan gpt-live-1 di salah satu key OpenAI Anda, atau di key Azure OpenAI dengan nama deployment gpt-live-1 Anda (ada di daftar model).
  2. Untuk semua agent sekaligus, pilih model itu di tab Tasks pada Voice calls · Natural conversation. Agent yang Voice runs on-nya Organization default lalu menjalankan panggilan Natural conversation-nya di model itu.
  3. Atau untuk satu agent, di halaman Conversation → Voice-nya pilih Natural conversation di tab Conversation, lalu di tab AI models pada Voice runs on pilih Your OpenAI account (atau Your Azure OpenAI account). Setiap model GPT-Live Anda tercantum beserta empat karakter terakhir key-nya. Pilih Qlar agar agent tetap di GPT-Live milik Qlar apa pun pilihan organization.
  • OpenAI atau Azure menagih akun Anda untuk voice-nya. Tidak ada credit Qlar yang ditagih per menit. Pemakaian Answering AI model ditagih seperti biasa (tanpa credit Qlar bila itu model milik Anda sendiri).
  • Berlaku untuk agent Personal maupun Service, dan tidak memerlukan komputer terhubung maupun pilot Natural conversation di Qlar.
  • Bila key Anda tidak bisa dipakai, atau modelnya dihapus, panggilan berakhir dengan pesan yang sama seperti di atas. Panggilan tidak pernah pindah ke voice Qlar.
  • Voice calls · Turn-by-turn tidak pernah menawarkan gpt-live-1, dan Voice calls · Natural conversation hanya menawarkan model gpt-live-1.

Read scanned PDFs (di Chat helpers) membaca PDF tanpa teks yang bisa dipilih, seperti hasil scan, yang diunggah end user. Setiap halaman dikirim ke model Anda sebagai gambar, sehingga token-nya lebih banyak daripada teks. Tanpa model sendiri, Azure AI Vision milik Qlar yang membaca halamannya.

Baris Read scanned PDFs: Model my-gpt-4o, catatan bahwa setiap halaman scan dikirim ke model ini sebagai gambar dan tanpa model ini Azure AI Vision milik Qlar yang membaca halamannya, serta Runs on Your API key

Logo image (di Builder assistants) menggambar logo dan avatar saat Anda membuat tampilan agent, sekitar 4 gambar per setup. Logo brief, yang menulis prompt gambarnya, tetap mengikuti model grup seperti sebelumnya.

Baris Logo image: butuh model gambar, Model my-image, Runs on Your API key

Plugin

Tab Tasks → Plugins. Pilih satu model dengan Use for every task in this group, atau satu per plugin:

PluginYang dikirim ke model
Chat FormDeskripsi form dan teks pertanyaan yang Anda tulis, saat Anda membuat form.
SQL Database ReaderSetiap pertanyaan, dengan nama serta deskripsi tabel dan kolom Anda; SQL-nya sendiri berjalan di database Anda. Model reasoning yang kuat menulis SQL lebih baik.
Dynamic TableDeskripsi tabel dan kolom saat Anda menyiapkannya; pertanyaan dan baris yang ditemukan pencarian. Barisnya di-embed dengan model Knowledge search Anda.
Grup Plugins: Use for every task in this group my-gpt-4o, serta Chat Form, SQL Database Reader, dan Dynamic Table masing-masing my-gpt-4o · from group, Runs on Your API key

Reminder tidak memakai model AI. Public Documents selalu berjalan di Qlar.

Dynamic Table dan knowledge search. Saat Anda memilih atau mengganti model Knowledge search, baris semua Dynamic Table milik agent Anda di-embed ulang di model itu, di akun Anda. Tabel besar berarti banyak panggilan ke model Anda, dan pencariannya menemukan lebih sedikit baris sampai proses selesai.


Web search di akun Exa Anda

Agent mencari di web dengan Exa. Defaultnya memakai akun Exa milik Qlar. Untuk memakai akun Anda:

  1. Tab Sources → Service keys → Add Exa key. Key ada di dashboard Exa (dashboard.exa.ai › API keys). Beri nama bila mau, lalu klik Check and save: Qlar menjalankan satu pencarian kecil untuk memeriksa key, lalu menyimpannya terenkripsi. Hanya 4 karakter terakhirnya yang ditampilkan.

    Bagian Service keys di tab Sources dengan tombol Add Exa key dan key Research, Exa · web search · ••••9f2c, bertanda Used for web search
  2. Menambah key belum mengubah apa pun. Tab Tasks → Other services → Web search → Search account → Your Exa account · nama. Toast mengonfirmasi "Web search now runs on your Exa account."

    Baris Web search: Search account Your Exa account · Research · ••••9f2c, Runs on Your Exa account

Untuk kembali, pilih Qlar's Exa account. Menghapus key yang sedang dipakai memindahkan web search kembali ke akun Qlar (atau mematikannya saat Only use our own models menyala); akun Exa Anda sendiri tidak berubah.


Melihat di mana panggilan Anda berjalan

Kartu AI calls in the last n days di tab Tasks menghitung panggilan AI organization di model Anda sendiri dan di model Qlar, per grup, untuk 7, 30, atau 90 days terakhir. See details menampilkan setiap pekerjaan dan modelnya.

Kartu AI calls in the last 30 days: 2,410 calls on your models · 0 on Qlar's, bar untuk Agent features, Chat helpers, Voice, dan Other services, serta daftar detail: Dialog, Guardrail validation, Knowledge search, Web search, Dialog realtime, dan Transcription, semuanya di model Anda

Saat Only use our own models menyala, kartu ini menampilkan panggilan yang masih berjalan di model Qlar sejak hari aturan itu dinyalakan. Penghitungan dimulai saat kartu ini ditambahkan, jadi panggilan yang lebih lama tidak termasuk; hari dihitung dalam UTC.


Saat Only use our own models menyala

Semua yang ada di halaman ini tetap berjalan di bawah Hanya Memakai Model Sendiri begitu berjalan di akun Anda:

PekerjaanTanpa model atau key sendiri
Speech to text, Text to speechMati: voice note tidak ditranskripsi, balasan dikirim sebagai teks.
Voice callsPanggilan di voice Qlar berakhir dengan "This agent can't take voice calls right now."
Read scanned PDFsPDF hasil scan ditolak; PDF yang berisi teks tetap bisa.
Logo imageDilewati: unggah logo sendiri.
PluginSQL Database Reader dan Dynamic Table berhenti (Dynamic Table juga butuh model Knowledge search sendiri); Chat Form tidak bisa membuat pertanyaan. Reminder tetap jalan. Public Documents mati.
Web searchMati, sampai Anda memilih key Exa Anda.

Penagihan

Panggilan di model Anda sendiri dan pencarian di akun Exa Anda tidak memakai credit Qlar; provider Anda menagih langsung. Biaya platform per pesan dari Qlar tetap berlaku.


Troubleshooting

GejalaPenyebabSolusi
Model tidak muncul di picker VoiceModel itu bukan jenis yang sesuai, atau provider-nya tidak bisa menyediakannyaTambahkan lagi dengan switch yang tepat (Speech-to-text model, Text-to-speech model, Realtime voice model). Voice calls butuh key OpenAI.
Penelepon mendengar "Voice is unavailable right now"Akun OpenAI atau Azure OpenAI Anda menolak panggilan (key, kuota, akses model, atau nama deployment yang tidak ada)Periksa key dan model di akun OpenAI Anda, atau pilih model realtime lain.
"Exa refused this key" saat menambah keyKey salah atau tidak punya creditSalin lagi key dari dashboard Exa.
Web search masih berjalan di QlarKey sudah ditambahkan tetapi belum dipilihTasks › Web search › Search account › key Anda.
Pencarian Dynamic Table tidak menemukan apa pun setelah perubahanBarisnya sedang di-embed ulang di model Knowledge search yang baruTunggu sampai selesai; tabel besar butuh waktu lebih lama.

Halaman Terkait