View Categories

Cara Menginstal Query Streams Agent di macOS

Waktu baca 14 menit

0:00 16:41
Apple macOS Pengaturan · macOS

Instal Agen Query Streams pada macOS

Agent adalah program kecil yang berada di samping data Anda dan melakukan koneksi. Instal sekali, lalu atur semuanya melalui browser Anda.

Sekitar 10 menit Tidak perlu coding. Data Anda tetap aman.
Mengalami kesulitan di suatu titik? Tanyakan saja pada kami. Membuka Dukungan Di Query Streams (menu kanan atas → Dukungan) dan kirimkan pesan kepada kami. Ada orang sungguhan yang membacanya, dan "Saya tidak tahu apa yang diminta layar ini" adalah pertanyaan yang sangat wajar.

Query Streams memungkinkan Anda menarik data langsung dari basis data dan aplikasi bisnis Anda — ke Excel, Google Sheets, laporan, atau asisten AI — tanpa perlu menyalinnya terlebih dahulu. Untuk melakukan itu, dibutuhkan satu program pembantu kecil yang berjalan di suatu tempat yang sudah dapat mengakses data Anda. Program pembantu tersebut adalah... Agen.

Yang Anda perlukan sebelum memulai

Mac yang tetap aktif

Aplikasi ini perlu tetap aktif saat orang menjalankan kueri, jadi ada baiknya memeriksa pengaturan daya. Berjalan secara native pada Apple Silicon (M1–M4) dan pada Mac berbasis Intel.

Kata sandi masuk Anda

Kode sekali pakai yang mengaitkan Agen ini dengan organisasi Anda. Anda akan menemukannya di Aliran Kueri pada halaman Unduh, tepat di sebelah penginstal.

Detail basis data Anda

Nama server, nama basis data, serta nama pengguna dan kata sandi yang dapat membacanya. Jika ada orang lain yang mengelola basis data Anda, inilah bagian yang perlu Anda minta dari mereka.

Ke mana seharusnya itu dikirim? Pasang Agent pada mesin yang sudah dapat membuka basis data Anda saat ini — seringkali server basis data itu sendiri, atau PC mana pun di jaringan kantor yang sama. Jika Anda dapat mengakses data dari mesin tersebut, Agent pun dapat mengaksesnya.

Instal dalam empat langkah

  1. Unduh dan jalankan program instalasinya.

    Masuk di my.querystreams.com/download lalu pilih unduhan macOS — tersedia versi Apple Silicon dan Intel. Unduh versi yang sesuai dengan Mac Anda, kemudian instal dengan beberapa baris perintah di Terminal — Anda memerlukan kata sandi administrator.

    Membuka Terminal (tekan ⌘ Ruang angkasa lalu ketik “Terminal”) dan tempelkan baris-baris berikut untuk Mac Anda. Tidak yakin Mac Anda yang mana? Menu Apple › Tentang Mac Ini: Chip: Apple M… artinya Apple Silicon, Prosesor: Intel… artinya Intel.

    Apple Silicon (M1 – M4)
    cd ~/Downloads mkdir -p querystreams-agent tar -xzf querystreams-agent_*_osx-arm64.tar.gz -C querystreams-agent cd querystreams-agent sudo ./install.sh
    Intel Mac
    cd ~/Downloads mkdir -p querystreams-agent tar -xzf querystreams-agent_*_osx-x64.tar.gz -C querystreams-agent cd querystreams-agent sudo ./install.sh

    Itu * Ini menggantikan nomor versi, jadi Anda tidak perlu mengetiknya. Jika Anda telah mengunduh lebih dari satu versi ke dalam folder tersebut, ketik nama file lengkapnya.

    sudo Meminta kata sandi Mac Anda. Tidak ada yang muncul saat Anda mengetik — itu normal; tekan Kembali setelah kamu selesai.

    Jika Anda mengunduh menggunakan Safari, Safari mungkin telah mengekstrak file ke dalam folder yang diberi nama sesuai dengan nama unduhan (Safari melakukan ini ketika Buka file "aman" setelah mengunduh. (sedang aktif). Dalam hal ini ter Baris tersebut akan mengatakan bahwa file tidak ditemukan; sebagai gantinya, masuk ke folder tersebut dan jalankan penginstal dari sana:

    Jika Safari sudah mengekstraknya
    cd ~/Downloads/querystreams-agent_*_osx-* sudo ./install.sh

    Kemudian periksa apakah programnya berjalan — Anda seharusnya melihat baris yang diakhiri dengan com.querystreams.agent:

    Periksa layanannya
    sudo launchctl list | grep querystreams

    Jika tidak ada respons, lognya ada di /usr/local/querystreams/agent/logs/agent-stdout.log — pasangkan ke permintaan dukungan dan kita akan melanjutkannya dari situ. Setelah terpasang, Anda dapat menghapusnya. agen aliran kueri folder di Unduhan.

    Agen tersebut mendaftarkan dirinya sebagai layanan latar belakang, yang artinya agen tersebut akan berjalan secara otomatis setiap kali Mac dinyalakan. Anda tidak perlu mengingat untuk menjalankannya, dan ini adalah satu-satunya saat Anda akan mengunduhnya — Sistem akan memperbarui dirinya sendiri mulai dari sini..

  2. Masuk dengan kunci Anda

    Setelah Agen terpasang, buka halaman Agen tersebut di mesin itu:

    Di Mac tempat Anda baru saja menginstalnya
    http://localhost:1823

    Tempelkan kata sandi masuk Anda. Lihat lencana di pojok kiri atas: setelah terbaca “Terhubung ke Aliran Kueri” Dengan titik hijau, Anda selesai di sini. Itu adalah Agen yang memperkenalkan diri ke akun Anda — dan itu adalah hal terakhir yang perlu Anda lakukan di perangkat ini.

    Halaman itu sendiri akan memberi tahu Anda hal yang sama: “Agen ini menjalankan koneksi Anda secara lokal — manajemen sehari-hari dilakukan di Portal Query Streams.” Itu isyarat bagi Anda untuk menutupnya dan melanjutkan di browser Anda.

  3. Tambahkan koneksi pertama Anda — dari browser Anda

    Sekarang kembali ke Query Streams di browser Anda dan buka Agen Data (itu di bawah) Data (di menu atas). Agen baru Anda akan tercantum di sana. Klik Tambahkan konektor dan ikuti pertanyaan-pertanyaan berikut: pilih jenis basis data atau aplikasi apa itu, lalu isi detail yang telah Anda kumpulkan sebelumnya.

    Agen Data Terbuka

    Anda dapat menguji koneksi sebelum menyimpannya, sehingga Anda akan langsung tahu apakah detailnya sudah benar daripada baru mengetahuinya nanti. Query Streams juga menyarankan pengaturan yang masuk akal untuk basis data umum, dan menambahkan sejumlah kecil contoh kueri siap pakai sehingga Anda memiliki sesuatu untuk dijalankan segera.

    Setelah disimpan, Query Streams akan menelusuri basis data Anda dan mencatat isinya — tabel, kolom, dan bagaimana hubungannya satu sama lain. Itulah yang mengisi daftar yang Anda pilih di Query Builder, dan itulah cara Nova dapat menjawab pertanyaan “berapa banyak pesanan yang kami kirim bulan lalu?” tanpa Anda perlu menyebutkan satu pun tabel. Anda tidak perlu mengaktifkannya dan tidak ada yang perlu dikonfigurasi; fitur ini akan memperbarui dirinya sendiri sesuai jadwal sehingga tetap sesuai dengan perubahan basis data Anda.

    Alat itu membaca bentuknya, bukan isinya. Langkah ini berkaitan dengan nama tabel dan kolom, bukan baris Anda. Pada basis data yang besar, proses ini dapat memakan waktu beberapa menit — Anda tidak perlu menunggu, dan Anda akan melihat kapan proses selesai pada konektor. Agen Data.

    Kata sandi Anda tidak pernah keluar dari mesin itu. Saat Anda menyimpan koneksi, detailnya akan dikirimkan ke Agen Anda melalui tautan terenkripsi dan kredensial akan disimpan di sana, di komputer Anda sendiri — bukan di tempat kami.

  4. Jalankan kueri pertama Anda

    Cara tercepat: tekan “Mulai kueri” pada layar terakhir pengaturan konektor. Itu membuka Pembuat Kueri Dengan koneksi baru yang sudah Anda pilih, jadi Anda tidak perlu mencari apa pun lagi. Anda juga dapat mengaksesnya kapan saja dari menu atas.

    Dari situ, jalankan salah satu contoh kueri yang sudah tersedia, tulis kueri Anda sendiri, atau cukup ajukan pertanyaan kepada Nova — asisten kami — dalam bahasa Inggris sederhana dan biarkan ia menulis kueri untuk Anda.

    Saat Anda menyimpan kueri, kueri tersebut dapat digunakan kembali di mana saja: perbarui di dalam Excel atau Google Sheets, jadwalkan, bagikan dengan kolega, berikan kepada asisten AI, atau ubah menjadi tautan web yang dapat dipanggil oleh sistem lain.

    Buka Pembuat Kueri Dapatkan add-in Excel & Sheets

Bagaimana bagian-bagian tersebut saling terhubung

JARINGAN ANDA Aliran Kueri di browser Anda Agen di PC Windows Anda Basis data Anda tidak pernah bergerak pengaturan saja hasil Anda membacanya
Anda mengatur semuanya di browser. Agen melakukan pembacaan di dalam jaringan Anda. Hanya baris yang diminta oleh kueri Anda yang dikirim kembali — dan Agen selalu melakukan panggilan keluar, jadi tidak ada yang perlu dibuka ke internet agar berfungsi.

Anda mengelola semuanya dari browser.

Setelah Agen terinstal dan masuk, Anda seharusnya tidak perlu kembali ke mesin itu. Semua hal — koneksi, basis data mana yang akan disertakan, seberapa sering data diperbarui, semua pengaturan Agen itu sendiri — dikelola dari sini. Agen Data di peramban Anda, dari mana pun Anda berada.

Query Streams, di browser Anda

Semua hal yang akan Anda lakukan, dari mana saja:

  • Menambahkan, mengedit, dan menghapus koneksi.
  • Menguji koneksi
  • Memilih basis data mana yang akan disertakan
  • Mengatur seberapa sering data diperbarui
  • Semua pengaturan Agen

Halaman pribadi Agen

Satu pekerjaan, dan Anda mungkin tidak akan pernah membutuhkannya:

  • Memeriksa mengapa Agen tidak dapat mengakses Aliran Kueri

Jika Agen Anda menunjukkan status offline di browser dan Anda tidak dapat melihat alasannya, buka localhost:1823 pada mesin itu. Lencana di pojok kiri atasnya langsung memberi tahu Anda (lihat apa arti keempat negara bagian tersebut), dan perangkat ini dapat melihat jaringan dari tempatnya berada — yang tidak dapat dilakukan oleh peramban Anda.

Agen tersebut kini sepenuhnya lepas tangan. Ini dirancang agar Anda menginstalnya sekali dan melupakannya. Setiap operasi beralih ke Agen Data di browser, dan satu-satunya hal yang akan disimpan oleh halaman Agent sendiri adalah informasi yang membantu Anda mencari tahu mengapa Agent tidak dapat mengakses Query Streams. Jadi, jika panduan atau kolega meminta Anda untuk mengkonfigurasi sesuatu di mesin Agent, periksa browser terlebih dahulu.

Jika Anda telah membaca versi panduan yang lebih lama: Disebutkan bahwa koneksi harus diatur di halaman Agen itu sendiri dan bukan di browser. Itu tidak lagi benar — browser sekarang adalah tempat untuk melakukannya. Apa pun yang Anda atur dengan cara lama masih berfungsi, dan Anda akan menemukannya menunggu Anda di Agen Data.

Apakah Agen sedang berkomunikasi dengan Aliran Kueri?

Lencana di pojok kiri atas halaman Agen itu adalah jawaban untuk hampir setiap pertanyaan "mengapa ini tidak berfungsi?". Lencana itu selalu mengatakan salah satu dari empat hal, dan kata-katanya memberi tahu Anda persis posisi Anda. Inilah yang Anda cari:

Terhubung ke Aliran Kueri
Menghubungkan ke Aliran Kueri Menghubungkan kembali ke Aliran Kueri
Terputus dari Aliran Kueri

Menghubungkan dan memutuskan koneksi terlihat sama — pita warna yang bergerak, artinya "sedang dikerjakan". Cahaya hijau yang stabil berarti terhubung. Lencana yang datar dan redup berarti tidak terhubung.

Lampu kecil itu bukan tombol. Ini hanya melaporkan status — mengkliknya tidak akan menghasilkan apa pun. Menghubungkan, Terhubung kembali dan Memutuskan Kontrol-kontrol tersebut berupa tombol-tombol bernama pada panel Koneksi di bagian bawah halaman, dan ini memang disengaja: lampu indikator tanpa label yang diam-diam membuat Agen Anda offline saat diklik adalah jebakan yang perlu dihilangkan.

Semuanya baik-baik sajaTerhubung ke Aliran Kueri

Semuanya berjalan lancar. Kueri Anda akan dijalankan dan setiap perubahan yang Anda buat di browser akan sampai ke Agen ini dalam hitungan detik. Tidak ada yang perlu dilakukan.

MemulaiMenghubungkan ke Aliran Kueri

Ini normal selama beberapa detik setelah mesin dinyalakan atau Agen dimulai ulang. Beri waktu sebentar.

Sedang dikerjakanMenghubungkan kembali ke Aliran Kueri

Koneksi terputus dan Agen sedang memulihkannya sendiri — biasanya hanya gangguan jaringan singkat, dan tidak memerlukan bantuan dari Anda.

Jika perangkat tersebut tetap berada di sini selama lebih dari beberapa menit, berarti ada sesuatu di jaringan yang menghalangi jalan keluar. Itu perlu dilaporkan kepada kami.

Membutuhkan perhatianTerputus dari Aliran Kueri

Saat dalam kondisi ini, tidak ada satu pun yang berfungsi pada Agen ini. Agenlah yang melakukan pembacaan sebenarnya, jadi jika agen tidak dapat dihubungi, tidak ada yang dapat melakukan pekerjaan tersebut.

Periksa apakah mesin terhubung ke internet, lalu tekan Terhubung kembali pada panel Koneksi. Jika tidak muncul kembali, biasanya itu karena firewall atau proxy yang memblokir lalu lintas keluar — kirimkan pesan kepada kami dan kami akan membantu Anda menemukan penyebabnya.

Apa yang berhenti saat Agen terputus koneksinya? Semua hal yang perlu mengakses datanya:

  • Permintaan terhadap koneksinya tidak akan berjalan — baik di Query Builder, di Excel atau Google Sheets, dari REST API, maupun dari asisten AI.
  • Pembaruan terjadwal dan otomatisasi untuk data tersebut tidak terjadi.
  • Koneksinya tidak dapat diuji, dijelajahi, atau diperbarui dari peramban Anda.
  • Di Data Agents, statusnya menunjukkan offline, dan angka yang Anda lihat adalah... terakhir diketahui yang lebih baik daripada hidup

Namun, tidak ada yang hilang. Perubahan yang Anda simpan di browser saat browser tidak terhubung akan tetap tersimpan dan diterapkan saat browser terhubung kembali — sehingga Anda dapat melanjutkan pengaturan tanpa harus menunggu.

Ingin menghubungi kami terkait masalah koneksi? Panel Koneksi di halaman tersebut mencantumkan empat hal yang paling membantu kita. Salinlah ke dalam milik Anda. Dukungan pesan dan biasanya kita bisa melewati proses bolak-balik:

Mesin
komputer mana yang sedang digunakan Agen.
Organisasi
akun mana yang terhubung dengannya
Versi agen
versi mana yang sedang dijalankan
Terhubung sejak
saat terakhir kali berhasil terhubung

Sistem ini selalu memperbarui dirinya sendiri.

Anda hanya perlu menginstal Agen sekali. Anda tidak akan diminta untuk mengunduhnya lagi, dan tidak ada pemberitahuan "pembaruan tersedia" yang perlu Anda perhatikan — ketika kami merilis versi baru, Agen Anda akan menanganinya sendiri, dan biasanya dalam hitungan detik.

Ada tiga cara untuk mengetahuinya, sehingga pembaruan tidak akan terlewatkan:

Biasanya Dalam sekejap mata

Saat kami menerbitkan pembaruan, kami langsung mengirimkannya melalui koneksi yang sudah terbuka di Agen Anda. Pembaruan dilakukan di tempat dan Agen akan memulai ulang dirinya sendiri.

Jika dimatikan Beberapa detik setelah terhubung kembali

Aplikasi tersebut menanyakan apakah ada yang terlewat beberapa detik setelah kembali online, lalu memperbarui informasi.

Sabuk dan penyangga Sekali sehari, sendirian

Perangkat ini juga melakukan pengecekan sekali sehari menggunakan koneksi keluarnya sendiri — sehingga meskipun berada di jaringan yang dijaga ketat, perangkat ini tetap mendapatkan informasi terkini.

Bagaimana cara mengetahui apakah perkembangannya berjalan sesuai harapan. Panel Koneksi di halaman Agen menampilkan Versi agenDalam kondisi normal, sistem akan secara otomatis mengikuti rilis terbaru kami. Jika Anda melihat pembaruan tertinggal jauh selama beberapa hari, berarti ada sesuatu di jaringan yang menghalangi jalur pembaruan — ini perlu diperiksa. pesan kepada kami, karena itu bukan sesuatu yang bisa diselesaikan oleh Agen hanya dengan berbicara.

Kapan koneksi baru mulai berfungsi?

Hampir selalu dalam beberapa detik. Jawaban pastinya bergantung pada Agen Anda:

Biasanya Beberapa detik

Agen tersebut berjalan dan sudah diperbarui, sehingga langsung mendeteksi perubahan. Tidak perlu memulai ulang.

Jika dimatikan Saat terhubung kembali

Perubahan Anda tersimpan dengan aman dan akan berlaku saat mesin tersebut kembali online.

Agen Senior Pada saat memulai ulang berikutnya

Jarang terjadi, karena Agen memperbarui diri sendiri. Query Streams akan memberi tahu Anda di layar apakah ini berlaku untuk milik Anda.

Reading files on a network share

If a connector needs a file or folder on a network share, mount the share on this Mac before you add the connector. Mount it from Terminal with sudo, in a folder under /Volumes, so the Agent, which runs as a system background service, can see it. Share logins stored in the Portal are used by Windows Agents only. In the connector you can keep the \\server\share path, which the Agent maps onto the mount, or type the mount path directly. If the share isn’t mounted, Uji koneksi says it is not mounted and shows the exact command to run.

How to mount a share for the Agent on a Mac

Pertanyaan umum

Di mana saya dapat menambahkan, mengedit, atau menghapus koneksi?

Di browser Anda, pada Agen Data halaman — gunakan Tambahkan konektorPerubahan biasanya sampai ke Agen Anda dalam hitungan detik. Jika Agen sedang offline, perubahan akan diterapkan segera setelah terhubung kembali. Anda tidak perlu menyentuh mesin Agen untuk menambah atau mengubah koneksi.

Apakah data saya disalin ke Query Streams?

Tidak. Basis data Anda tetap berada di tempatnya. Saat Anda menjalankan kueri, Agen membaca basis data Anda dan hanya mengembalikan baris yang diminta oleh kueri tersebut. Kata sandi basis data Anda tetap berada di mesin Agen.

Apakah saya perlu membuka port atau mengubah firewall kami?

Biasanya tidak. Agen membuat koneksi keluar ke kami, sama seperti yang dilakukan peramban web. Tidak ada yang perlu menerima lalu lintas masuk dari internet.

Bisakah saya menggunakan lebih dari satu Agen?

Ya — banyak organisasi menjalankan satu agen per lokasi atau per jaringan. Semuanya muncul bersamaan di akun Anda, jadi tidak masalah bagi orang yang menulis kueri agen mana yang memegang koneksi mana.

Apakah saya harus terus memperbaruinya?

Tidak — dan tidak ada yang perlu diklik. Saat kami menerbitkan versi baru, versi tersebut akan dikirimkan ke Agen Anda melalui koneksi yang sudah terbuka, sehingga biasanya akan memperbarui dalam beberapa saat dan memulai ulang dirinya sendiri. Agen juga akan memeriksa sendiri sekali sehari sebagai langkah pencegahan. Anda dapat melihat versi yang digunakan di bawah ini. Versi agen pada panel koneksinya.

Bagaimana jika saya terjebak di tengah jalan?

Kirim pesan kepada kami dari Dukungan Di dalam Query Streams, beri tahu kami sampai di mana Anda berada. Jika lebih mudah, sebutkan layar mana yang Anda lihat dan apa yang Anda harapkan untuk dilihat — biasanya itu sudah cukup bagi kami untuk menemukannya.

Tidak berjalan sesuai rencana? Itu perlu diceritakan kepada kami. Membuka Dukungan Anda dapat mengirim pesan ke tim melalui Aliran Kueri, atau menelusuri tab Basis Pengetahuan untuk panduan lainnya. Jika langkah di halaman ini tidak sesuai dengan yang Anda lihat di layar, beri tahu kami juga — itu berarti panduan tersebut perlu diperbaiki, bukan Anda.
Apakah Anda memasangnya di tempat lain? Windows Linux

Setup trouble?

  • Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?
Updated on Oktober 12, 2026

What are your Feelings

  • Happy
  • Normal
  • Sad

Powered by BetterDocs