Configurazione · macOS
Installa l'agente Query Streams su macOS
L'Agent è un piccolo programma che si affianca ai tuoi dati e si occupa della connessione. Installalo una sola volta, poi configura tutto il resto dal tuo browser.
Query Streams ti consente di estrarre dati in tempo reale dai tuoi database e dalle tue app aziendali, in Excel, Fogli Google, report o un assistente AI, senza doverli prima copiare da nessuna parte. Per fare ciò, ha bisogno di un piccolo programma di supporto in esecuzione da qualche parte che possa già accedere ai tuoi dati. Questo programma di supporto è Agente.
Cosa ti servirà prima di iniziare
Un Mac che rimane attivo
Deve rimanere attivo quando gli utenti eseguono query, quindi vale la pena controllare le impostazioni di risparmio energetico. Funziona nativamente su Apple Silicon (M1–M4) e su Mac con processore Intel.
La tua chiave di accesso
Un codice univoco che collega questo agente alla tua organizzazione. Lo troverai in Query Streams nella pagina di download, proprio accanto al programma di installazione.
I dettagli del tuo database
Il nome del server, il nome del database e un nome utente e una password che consentano l'accesso. Se il database è gestito da qualcun altro, è a lui che dovete fornire queste informazioni.
Dove dovrebbe essere messo? Installa l'agente su una macchina che sia già in grado di aprire il tuo database, spesso il server del database stesso o qualsiasi PC della stessa rete aziendale. Se puoi accedere ai dati da quella macchina, anche l'agente potrà farlo.
L'installazione avviene in quattro passaggi.
-
Scarica ed esegui il programma di installazione
Accedi a my.querystreams.com/download Scegli il download di macOS: sono disponibili versioni native per Apple Silicon e Intel. Scarica la versione compatibile con il tuo Mac, quindi installala con pochi comandi nel Terminale: ti servirà la password di amministratore.
Apri terminale (premere ⌘ Spazio e digita “Terminale”) e incolla le righe relative al tuo Mac. Non sai quale modello hai? Menu Apple › Informazioni su questo Mac: Chip: Apple M… significa Apple Silicon, Processore: Intel… Significa 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
Mac Intelcd ~/Downloads mkdir -p querystreams-agent tar -xzf querystreams-agent_*_osx-x64.tar.gz -C querystreams-agent cd querystreams-agent sudo ./install.sh
IL
*sostituisce il numero di versione, quindi non è necessario digitarlo. Se hai scaricato più di una versione in quella cartella, digita invece il nome completo del file.sudoti chiede la password del tuo Mac. Non appare nulla mentre digiti: è normale; premi Ritorno quando hai finito.Se hai scaricato con Safari, potrebbe aver già estratto il file in una cartella con lo stesso nome del download (Safari lo fa quando Apri i file “sicuri” dopo il download è acceso). In tal caso il
catrameLa riga di comando indicherà che non riesce a trovare il file; invece, vai in quella cartella ed esegui il programma di installazione da lì:Se Safari lo ha già decompressocd ~/Downloads/querystreams-agent_*_osx-* sudo ./install.sh
Quindi controlla che sia in esecuzione: dovresti vedere una riga che termina con com.querystreams.agent:
Verifica il serviziosudo launchctl list | grep querystreams
Se non viene restituito nulla, il registro è a
/usr/local/querystreams/agent/logs/agent-stdout.log— attaccalo a un richiesta di supporto e da lì partiremo. Una volta installato puoi eliminare ilagente di flusso di querycartella in Download.L'agente si registra come servizio in background, il che significa che si avvia automaticamente ogni volta che il Mac si accende. Non è necessario ricordarsi di avviarlo, e questo è l'unico momento in cui lo scaricherete. si aggiorna da qui in poi.
-
Accedi con la tua chiave
Una volta installato l'agente, apri la sua pagina su quel computer:
Sul Mac su cui l'hai appena installatohttp://localhost:1823
Incolla la tua chiave di accesso. Guarda il badge nel angolo in alto a sinistra: una volta letto “Connesso ai flussi di query” Con un puntino verde, hai finito. È l'agente che si presenta al tuo account ed è l'ultima cosa che devi fare su questo dispositivo.
La pagina stessa ti dirà la stessa cosa: "Questo agente gestisce le connessioni localmente; la gestione quotidiana avviene tramite il portale Query Streams." Questo è il segnale per chiuderlo e continuare a navigare nel browser.
-
Aggiungi la tua prima connessione — dal tuo browser
Ora torna a Query Streams nel tuo browser e apri Agenti dati (è sotto Dati nel menu in alto). Il tuo nuovo agente verrà elencato lì. Fai clic Aggiungi connettore Segui le istruzioni: scegli il tipo di database o applicazione, quindi inserisci i dettagli che hai raccolto in precedenza.
È possibile testare la connessione prima di salvarla, in modo da sapere subito se i dettagli sono corretti, anziché scoprirlo in seguito. Query Streams suggerisce inoltre impostazioni appropriate per i database più comuni e aggiunge una piccola serie di query di esempio già pronte, così da poterle eseguire immediatamente.
Una volta salvato, Query Streams analizza il tuo database e ne annota il contenuto: tabelle, colonne e le loro relazioni reciproche. Queste informazioni vengono utilizzate per compilare l'elenco che selezioni in Query Builder, ed è così che Nova può rispondere alla domanda "quanti ordini abbiamo spedito il mese scorso?" senza che tu debba specificare una singola tabella. Non è necessario attivarlo né configurarlo; si aggiorna automaticamente a intervalli regolari, in modo da essere sempre al passo con le modifiche del database.
Rileva la forma, non il contenuto. Questo passaggio riguarda i nomi di tabelle e colonne, non le righe. Su un database di grandi dimensioni, il completamento può richiedere alcuni minuti: non è necessario attendere e verrà visualizzato il messaggio di conferma nel connettore. Agenti dati.
La tua password non lascia mai quel computer. Quando salvi una connessione, i dettagli vengono trasmessi al tuo agente tramite un collegamento crittografato e le credenziali vengono memorizzate lì, sul tuo computer, non presso di noi.
-
Esegui la tua prima query
Il metodo più rapido: premere "Avvia una query" nell'ultima schermata della configurazione del connettore. Ciò apre Generatore di query La tua nuova connessione è già selezionata, quindi non devi cercare nulla. Puoi accedervi in qualsiasi momento anche dal menu in alto.
Da lì, esegui una delle query di esempio predefinite, scrivine una tua oppure poni semplicemente una domanda a Nova, il nostro assistente, in un linguaggio semplice e lascia che scriva la query per te.
Quando salvi una query, questa diventa riutilizzabile ovunque: puoi aggiornarla in Excel o Fogli Google, programmarne l'esecuzione, condividerla con un collega, fornirla a un assistente IA o trasformarla in un link web che un altro sistema può richiamare.
Come i pezzi si incastrano
Puoi gestire tutto dal browser.
Una volta installato e effettuato l'accesso all'agente, Non dovresti aver bisogno di tornare a quella macchina. Tutto — connessioni, quali database includere, con quale frequenza vengono aggiornati i dati, tutte le impostazioni dell'agente — è gestito da Agenti dati nel tuo browser, ovunque tu sia.
Query Streams, nel tuo browser
Tutto ciò che potrai effettivamente fare, ovunque ti trovi:
- Aggiungere, modificare e rimuovere connessioni
- Verifica della connessione
- Scelta dei database da includere
- Impostazione della frequenza di aggiornamento dei dati
- Tutte le impostazioni dell'agente
La pagina personale dell'agente
Un solo lavoro, e forse non ne avrai mai bisogno:
- Verifica del motivo per cui l'agente non riesce a raggiungere i flussi di query.
Se il tuo agente risulta offline nel browser e non riesci a capire perché, apri localhost:1823 su quella macchina. Il badge nell'angolo in alto a sinistra te lo dice subito (vedere cosa significano i quattro stati), e può vedere la rete dalla posizione in cui si trova, cosa che il tuo browser non può fare.
L'agente sta abbandonando completamente l'intervento. È progettato per essere qualcosa che installi una volta e dimentichi. Ogni operazione si sta spostando in Agenti dati nel browser, e l'unica cosa che la pagina dell'Agente stesso manterrà è l'aiuto per capire perché non riesce a raggiungere Query Streams. Quindi, se una guida o un collega ti dice di andare a configurare qualcosa sulla macchina dell'Agente, controlla prima nel browser.
Se hai letto una versione precedente di questa guida: diceva che le connessioni dovevano essere impostate sulla pagina dell'agente e non nel browser. Non è più vero: ora il browser è il luogo ideale per farlo. Tutto ciò che hai configurato con il vecchio metodo funziona ancora e lo troverai disponibile in Data Agents.
L'agente sta comunicando con i flussi di query?
Quel badge nell'angolo in alto a sinistra della pagina dell'agente è la risposta a quasi tutte le domande del tipo "perché non funziona?". Indica sempre una di queste quattro cose e la formulazione ti dice esattamente a che punto sei. Ecco cosa devi cercare:
La connessione e la riconnessione hanno lo stesso aspetto: una banda colorata in movimento indica "connessione in corso". Una luce verde fissa indica connessione. Un'icona piatta e debole indica che non è connessa.
La piccola luce non è un pulsante. Si limita a segnalare lo stato: cliccandoci sopra non succede nulla. Collegare, Ricollega e Disconnetti I comandi sono pulsanti denominati nel pannello Connessione più in basso nella pagina, e questa scelta è intenzionale: una spia senza etichetta che metteva silenziosamente offline l'Agent quando veniva cliccata era una trappola che valeva la pena eliminare.
Tutto funziona correttamente. Le tue query verranno eseguite e qualsiasi modifica apportata nel browser verrà recepita da questo agente in pochi secondi. Non devi fare nulla.
Normale per alcuni secondi dopo l'avvio della macchina o il riavvio dell'agente. Attendi un attimo.
Il collegamento si è interrotto e l'agente lo sta ripristinando autonomamente: si tratta in genere di un breve problema di rete e non richiede alcun intervento da parte tua.
Se rimane bloccato qui per più di qualche minuto, significa che qualcosa nella rete sta ostruendo l'uscita. In tal caso, è opportuno inviarci una notifica.
Fintanto che si trova in questo stato, nulla su questo agente funziona. È l'Agente che effettua la lettura vera e propria, quindi se non è raggiungibile, non c'è nessuno che possa svolgere il lavoro.
Verifica che la macchina sia online, quindi premi Ricollega nel pannello Connessione. Se non torna, di solito è un firewall o un proxy che blocca il traffico in uscita: inviaci un messaggio e ti aiuteremo a individuare il problema.
Cosa si interrompe quando un agente è disconnesso? Tutto ciò che ha bisogno di accedere ai propri dati:
- Le query sulle sue connessioni non verranno eseguite: in Query Builder, in Excel o Fogli Google, tramite l'API REST o tramite un assistente AI.
- Gli aggiornamenti programmati e le automazioni per quei dati non avvengono
- Le sue connessioni non possono essere testate, visualizzate o aggiornate dal tuo browser
- In Data Agents risulta offline e le cifre che vedi sono le ultima conoscenza piuttosto che vivere
Tuttavia, non si perde nulla. Le modifiche salvate nel browser mentre è offline vengono mantenute e applicate non appena si riconnette, quindi è possibile continuare a configurare le impostazioni senza dover attendere.
Desideri contattarci per un problema di connessione? Il pannello Connessione in quella pagina elenca le quattro cose che ci aiutano di più. Copiale nel tuo Supporto messaggio e di solito possiamo evitare lo scambio di messaggi:
- Macchina
- su quale computer si trova l'agente
- Organizzazione
- a quale conto è collegato
- Versione agente
- quale versione sta eseguendo
- Collegato dal
- quando è riuscito a connettersi l'ultima volta
Si tiene aggiornato
L'Agent va installato una sola volta. Non ti verrà chiesto di scaricarlo nuovamente e non dovrai più preoccuparti di ricevere notifiche di "aggiornamenti disponibili": quando rilasciamo una nuova versione, il tuo Agent se ne occuperà automaticamente, solitamente in pochi istanti.
Ci sono tre modi per scoprirlo, così non ci si perde nessun aggiornamento:
Nel momento in cui pubblichiamo un aggiornamento, lo inviamo direttamente tramite la connessione già aperta dal tuo agente. L'aggiornamento avviene sul posto e il sistema si riavvia automaticamente.
Il sistema chiede se si è perso qualcosa pochi secondi dopo essere tornato online, quindi si mette in pari.
Inoltre, effettua un controllo giornaliero utilizzando la propria connessione in uscita, in modo da rimanere aggiornato anche su una rete con restrizioni severe.
Come capire se tiene il passo. Il pannello Connessione nella pagina dell'agente mostra Versione agente. In condizioni normali, questo tiene traccia della nostra versione corrente da solo. Se noti che rimane molto indietro per giorni, qualcosa sulla rete sta bloccando il percorso di aggiornamento: vale la pena inviaci un messaggio, perché non è qualcosa da cui l'Agente può tirarsi fuori con le sole parole.
Quando inizia a funzionare una nuova connessione?
Quasi sempre entro pochi secondi. La risposta esatta dipende dal tuo agente:
L'agente è in esecuzione e aggiornato, quindi rileva immediatamente la modifica. Non è necessario riavviarlo.
Il resto è stato salvato in modo sicuro e verrà applicato non appena la macchina tornerà online.
È raro, dato che gli agenti si aggiornano automaticamente. Query Streams ti avvisa a schermo se questo problema si applica al tuo caso.
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, Verifica la connessione says it is not mounted and shows the exact command to run.
How to mount a share for the Agent on a Mac
Domande frequenti
Dove posso aggiungere, modificare o eliminare le connessioni?
Nel tuo browser, sul Agenti dati pagina — usa Aggiungi connettoreLe modifiche vengono generalmente visualizzate sull'Agent in pochi secondi. Se l'Agent è stato offline, le modifiche vengono applicate non appena si riconnette. Non è necessario intervenire sul computer dell'Agent per aggiungere o modificare una connessione.
I miei dati vengono copiati in Query Streams?
No. Il tuo database rimane dov'è. Quando esegui una query, l'Agent legge il tuo database e restituisce solo le righe richieste dalla query. La password del tuo database rimane sul computer dell'Agent.
Devo aprire una porta o modificare il firewall?
Normalmente no. L'agente stabilisce una connessione in uscita verso di noi, nello stesso modo in cui lo fa un browser web. Non è necessario che nulla accetti traffico in entrata da Internet.
Posso utilizzare più di un agente?
Sì, molte organizzazioni ne utilizzano uno per sito o per rete. Sono tutti visualizzati insieme nel tuo account, quindi per chi effettua una richiesta non importa quale agente gestisca quale connessione.
Devo aggiornarlo continuamente?
No, e non c'è nulla su cui cliccare. Quando pubblichiamo una nuova versione, viene inviata al tuo Agent tramite la connessione già aperta, quindi di solito si aggiorna in pochi istanti e si riavvia automaticamente. Inoltre, esegue un controllo automatico una volta al giorno come misura di sicurezza. Puoi vedere la versione corrente in Versione agente sul suo pannello di connessione.
E se mi bloccassi a metà?
Inviaci un messaggio da Supporto All'interno di Query Streams, indicaci dove sei arrivato. Se ti è più facile, specifica quale schermata stai visualizzando e cosa ti aspettavi di vedere: di solito è sufficiente per individuare il problema.
Finestre
LinuxSetup trouble?
- Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish