Mulai Cepat: Agent Pertama Anda

Saat Anda mendaftar, Qlar menawarkan untuk membangun agent pertama Anda bersama-sama. Create your first agent adalah alur singkat yang terpandu: Anda mengisi dua halaman, lalu Qlar membuat agent contoh yang menganalisis data Anda dan menjawab pertanyaan dengan merujuk ke dokumen Anda. Qlar menyiapkan model AI, menghubungkan data, meng-upload dokumen, mendesain logo, dan mem-publish versi pertama untuk Anda.

Halaman ini menjelaskan setiap layarnya. Agent bernama Tim, kecuali Anda memberinya nama lain. Semua yang disiapkan alur ini bisa diubah nanti.

Ingin membangun agent langkah demi langkah? Membuat Agent Pertama Anda memakai wizard New Agent untuk membangun Atlas, agent yang dipakai di seluruh panduan ini.

Sebelum memulai

• Anda memiliki akun Qlar dan sudah sign in ke CMS.
• Alur ini berjalan di organization Individual milik Anda sendiri, dan agent-nya adalah Personal agent: asisten untuk Anda sendiri. Untuk melayani tim atau pelanggan, buat Service agent di organization Collective nanti. Lihat Personal Agent vs Service Agent.
• Opsional: data Anda sendiri (workbook Excel, atau detail database SQL) dan paling banyak 3 dokumen. Tanpa itu, Anda bisa memakai file contoh Qlar untuk industri Anda.
• Opsional: langganan (subscription) Claude atau ChatGPT, atau API key dari OpenAI, DeepSeek, atau server OpenAI-compatible. Tanpa itu, agent berjalan dengan credit Qlar.

Yang disiapkan alur ini

Langkah 1: Buka Create your first agent

Anda bisa memulai alur ini dari dua tempat:

• Layar sambutan. Selama organization Individual milik Anda belum punya agent, CMS terbuka dengan Hi dan nama depan Anda, welcome to Qlar!, serta tombol Create your first agent. Jika Anda juga anggota organization lain, Switch to other organization menampilkan daftarnya; pilih salah satu untuk membuka agent pertamanya, atau daftar agent-nya.
• Halaman Organizations. Saat Anda memilih organization Individual milik Anda dan organization itu belum punya agent, tampilan kosongnya menawarkan Create your first agent. Lihat Organizations.

Layar sambutan hanya tampil sekali. Setelah Anda membuat agent, mengklik Cancel di alur ini, atau berpindah ke organization lain, layar itu tidak muncul lagi, di perangkat mana pun. Tombol di halaman Organizations tetap ada sampai organization tersebut punya agent.

Langkah 2: Baca pengantarnya

Alur dibuka dengan Let's create a sample agent, yang menjelaskan apa yang akan terjadi:

• Sekarang Anda hanya melakukan setup minimal: nama, industri, sumber data, beberapa dokumen, dan sumber model AI. Qlar menyarankan file contoh yang sesuai dengan industri Anda.
• Qlar membuat agent, menghubungkan data Anda, dan meng-upload dokumen Anda. Anda bisa langsung mencobanya.
• Setiap pengaturan bisa diubah dan dikembangkan nanti, misalnya kepribadian, perilaku, WhatsApp, form, atau API.

Klik Start. Cancel membawa Anda ke halaman Organizations, dan layar sambutan tidak muncul lagi.

Header alur menampilkan Create your first agent, chip Personal agent, dan halaman tempat Anda berada: 1 of 2 · Agent and data atau 2 of 2 · AI model source.

Langkah 3: Agent dan data

Halaman 1 menanyakan nama agent, industri Anda, sumber data, dan dokumen.

Nama agent dan industri

Sumber data

Use Qlar sample menampilkan workbook contoh untuk industri Anda, ukurannya, dan sheet-nya, dengan Download sample agar Anda bisa melihat isinya.

Upload my own menerima satu workbook .xlsx, paling besar 20 MB. Baris pertama setiap sheet berisi nama kolom. Belum yakin dengan susunannya? Download contohnya, ubah di Excel, lalu upload.

SQL connection meminta:

Pada awalnya agent membaca paling banyak 20 tabel. Anda bisa memilih tabel lain nanti di Setup.

Dokumen

Documents bersifat opsional: PDF, TXT, atau Markdown (.md), paling banyak 3 file dan 5 MB jika digabung. Seret file ke kotaknya atau klik choose files.

Di bawah kotak itu, industri Anda punya 2 dokumen contoh. Download menyimpan dokumen; Use menambahkannya ke daftar, dengan tanda example. Saat Anda mengganti industri, dokumen contoh di daftar ikut berganti. File Anda sendiri tetap ada.

Industri dan file contohnya

Semua perusahaan, orang, dan angka dalam contoh ini fiktif, dan file-nya berbahasa Inggris.

Klik Next.

Langkah 4: Pilih sumber model AI

Halaman 2 bertanya Where should Tim's AI run? Ada tiga kartu. Setup untuk kartu yang Anda pilih tampil di bawah kartu-kartu itu. Anda bisa berganti kartu kapan saja: yang sudah Anda ketik di setiap kartu tetap tersimpan sampai Anda meninggalkan alur ini.

Anda tidak pernah memilih model di sini. Qlar memilih model yang tepat untuk setiap pekerjaan dan menampilkannya di kartu ringkasan, misalnya Tim will use your subscription. Anda bisa mengubah semuanya nanti di Organization → AI Models → Tasks.

Subscription

Langganan yang dimaksud adalah langganan yang dipakai Claude Code atau Codex (ChatGPT) untuk sign in di komputer milik Anda, yang terhubung ke Qlar dengan Qlar connector. Lihat Memakai Langganan Claude atau ChatGPT untuk cara kerjanya dan apa yang dilindunginya.

• Sudah ada komputer yang terhubung, online, dan sudah sign in. Komputer itu langsung dipakai: misalnya My laptop is online. ChatGPT subscription detected., diikuti ringkasan model. Jika Claude Code dan Codex sama-sama sudah sign in, ChatGPT yang dipakai.
• Belum ada komputer. Connect your subscription menjalankan wizard koneksi yang sama dengan di halaman AI Models, kali ini di dalam alur: beri nama komputer dan pilih sistemnya, jalankan perintahnya di komputer itu, bandingkan fingerprint lalu setujui, kemudian sign in. Tidak ada daftar centang model, karena Qlar yang memilih modelnya.
• Komputer yang belum selesai (belum disetujui, offline, atau belum sign in) dilanjutkan dari titik terakhir. Langkah sign-in menampilkan status setiap tool dan diperbarui sendiri begitu sebuah tool sudah sign in.

Langganan hanya tersedia untuk organization Individual, paling banyak 2 komputer per organization. Jika belum tersedia untuk organization Anda, kartunya menyebut Subscriptions aren't available for this organization yet. Choose your own API key or Qlar credit.

Selama belum ada komputer yang siap, Create agent tetap nonaktif dengan teks Connect a computer with your subscription, or choose Qlar credit. atau Finish signing in on diikuti nama komputernya.

Your own API key

Klik Check key. Qlar menanyakan ke provider model mana saja yang bisa dipakai key itu, sebelum apa pun disimpan. Jika berhasil, muncul Key works. dan ringkasan model; jika gagal, pesan error tampil di bawah field. Key baru disimpan di organization Anda, terenkripsi, setelah Anda mengklik Create agent. Lihat Memakai API Key Sendiri.

Memakai Azure OpenAI? Azure tidak ditawarkan di sini. Mulailah dengan sumber lain, lalu tambahkan key Azure Anda nanti di Organization → AI Models.

Create agent menunggu sampai key diperiksa: Check your API key first, or choose Qlar credit. Jika key berfungsi tetapi tidak ada modelnya yang bisa dipakai, halaman menyebut None of the models this key offers can be used yet. Try another key or source.

Qlar credit

Menampilkan saldo credit Anda (credits available), kapan credit gratis Anda berakhir (Free credit valid until sebuah tanggal), dan Top up anytime. Tanpa sisa credit pun Anda tetap bisa membuat agent; chat memerlukan credit, jadi top up sebelum mencobanya. Lihat Cara Kerja Credit.

Ringkasannya berbunyi Tim will use Qlar's models: Analyst untuk chat, data, dan dokumen, serta Natural conversation di Qlar untuk voice. Anda bisa beralih ke langganan atau API key sendiri nanti di Organization → AI Models.

Jika organization Anda hanya mengizinkan model sendiri, kartu Qlar credit tampil abu-abu dengan Your organization only allows its own models. Lihat Hanya Memakai Model Sendiri.

Model yang dipilih Qlar

Perlu diketahui:

• Jika akun Anda tidak menawarkan model di tabel, Qlar mengambil model berikutnya yang tersedia. Model yang sudah Anda tambahkan ke organization tetap memakai alias-nya.
• Model-model ini menjadi default organization Anda di tab Tasks: model chat untuk Conversation, Reranker, KB Training, builder assistant, dan plugin; model ringan untuk Summarization, Personalization, dan chat helper; model mendalam untuk Conversation Analysis. Model voice, speech, pencarian dokumen, dan logo dari OpenAI hanya diatur bila tab Tasks organization Anda menawarkan task tersebut.
• File check membaca gambar. Jika model ringan tidak bisa membaca gambar, File check tetap memakai model Qlar yang bisa, sehingga upload tetap berfungsi.

Yang tetap memakai Qlar

Kalimat di bawah ringkasan menyebutkan apa yang tetap berjalan di Qlar:

Voice mati sampai Anda menyalakannya. Lihat Voice.

Setelah sumber yang dipilih siap, klik Create agent. Back kembali ke halaman 1 dengan semua yang sudah Anda isi.

Langkah 5: Tunggu selagi Tim dibuat

Halaman menampilkan Creating Tim dan berapa langkah yang sudah selesai. Setiap baris adalah langkah yang benar-benar dijalankan:

Baris berubah hijau setelah selesai. Kuning berarti langkah itu perlu dicek nanti, misalnya This step didn't finish. You can do it in Setup. atau The logo is still being drawn; it appears on its own when it's ready. Proses tetap berlanjut.

Error pada Setting up your AI models atau Creating your agent menghentikan proses. Barisnya berubah merah dan pesannya menjelaskan penyebabnya, dengan:

• Try again: menjalankan ulang dan melewati yang sudah berhasil (model, agent).
• Change AI model source: kembali ke halaman 2, jika sumbernya yang bermasalah dan agent belum dibuat.

Selama langkah-langkah berjalan, tips berganti setiap beberapa detik. Tips pertama membahas pilihan Anda, dengan pertanyaan yang benar-benar terjawab oleh data contoh atau dokumen contoh Anda, dan apakah chat memakai langganan, key Anda, atau credit Qlar (dengan Qlar credit, Tim mulai dengan model Analyst; Anda bisa memilih model lain di halaman Behavior). Setelah itu muncul ide untuk nanti: WhatsApp, Automations, kepribadian, dan Service agent untuk tim Anda.

Setelah semuanya selesai, Anda melihat Your agent is ready to try. Jika masih ada dokumen yang diproses, hal itu disebutkan, dan A few steps need a look; Setup shows them. muncul jika ada baris yang kuning. Klik Go to Setup.

Langkah 6: Coba Tim di Setup

Tim terbuka di halaman Setup, dengan preview chat di sebelahnya. Tepat setelah alur selesai, Setup menampilkan beberapa tambahan.

Processing documents

Selama ada dokumen yang diproses, atau ada yang gagal, sebuah kartu menampilkan Processing documents dengan jumlah yang sudah selesai dan status setiap dokumen. Halaman diperbarui setiap 5 detik selama ada dokumen yang diproses. Tim bisa memakai dokumen setelah dokumen itu menampilkan Ready; chat sebelum itu menjawab tanpa dokumen tersebut. Dokumen yang gagal punya tombol Try again. Jika dokumen Anda dibaca dengan langganan, pastikan komputer itu online, lalu coba lagi.

Catatan

Tur

Tur singkat menunjukkan empat hal, sekali untuk setiap agent di browser ini:

1. Your documents are being processed: Tim bisa memakai setiap dokumen setelah statusnya "ready". Hanya jika Anda menambahkan dokumen.
2. Try your agent here: preview selalu memakai draft terakhir Anda. Mulailah dengan salah satu contoh pertanyaan.
3. Changes are saved as a draft: user lain baru melihat perubahan konfigurasi setelah Anda mengklik Publish. Lihat Preview dan Publish Perubahan.
4. Resources apply right away: dokumen dan resource lain tidak memerlukan Publish.

Contoh pertanyaan

Jika Anda memakai Excel contoh atau dokumen contoh, contoh pertanyaan di chat berasal dari file itu (paling banyak 2 tentang data dan 2 tentang dokumen), sehingga percobaan pertama langsung berhasil. Jika Anda hanya memakai data dan file sendiri, contoh hasil generate tetap dipakai.

Voice

Alur ini tidak menyalakan voice. Saat Anda menyalakan Voice conversations di Conversation → Voice, Natural conversation langsung terpilih di tempat yang bisa menjalankannya; jika tidak, style-nya tetap Turn-by-turn. Anda masih bisa memilih Turn-by-turn sebelum mengklik Save. Dengan langganan ChatGPT yang komputernya bisa melakukan voice, atau key OpenAI dengan gpt-live-1, alur ini sudah mengatur Natural conversation Tim agar berjalan di sana, sehingga tidak ada credit Qlar per menit. Pada sumber lain, Natural conversation berjalan di GPT-Live milik Qlar, ditagih per menit selama panggilan terbuka. Lihat Berbicara dengan Suara.

Periksa hasilnya

• Halaman Organizations menampilkan Tim di organization Individual Anda, dengan chip Personal.
• Preview di Setup menjawab sebuah contoh pertanyaan. Dengan file contoh, coba salah satu pertanyaan ini:

• Jawaban tentang data muncul sebagai tabel, grafik, atau peta; jawaban dari dokumen menunjukkan dokumen sumbernya.
• Dengan langganan atau API key, Organization → AI Models → Tasks menampilkan model Anda sebagai default.

Pemecahan masalah

Saya tidak melihat layar sambutan. Layar ini hanya muncul selama organization Individual milik Anda belum punya agent dan Anda belum pernah membuat agent, membatalkan, atau berpindah organization dari layar itu. Pilih organization Individual Anda di halaman Organizations lalu pakai Create your first agent di tampilan kosongnya. Di organization lain, pakai New agent.

"Your personal organization isn't ready yet." Organization Individual Anda masih disiapkan. Muat ulang halaman sebentar lagi, atau buat agent dari halaman Organizations.

"Tim is already created" setelah halaman dimuat ulang. Halaman dimuat ulang saat agent sedang disiapkan. Klik Go to Setup dan selesaikan sisanya di sana.

Create agent tetap nonaktif. Sumber yang dipilih belum siap. Teks di samping tombol menyebutkan apa yang kurang: sign in di komputer, periksa key, atau pilih Qlar credit.

"Some tasks still use Qlar. Review them in Organization › AI Models › Tasks." Beberapa default task tidak bisa diatur. Buka tab Tasks dan pilih model Anda untuk task tersebut.

Sebuah dokumen menampilkan Failed. Klik Try again di kartu Processing documents. Jika dokumen Anda dibaca dengan langganan, pastikan dulu komputer itu online.

Langkah berikutnya