Configuração · Windows
Instale o Agente de Fluxos de Consulta em Janelas
O Agente é um pequeno programa que fica ao lado dos seus dados e faz a conexão. Instale-o uma vez e, em seguida, configure todo o resto pelo seu navegador.
O Query Streams permite extrair dados em tempo real de seus bancos de dados e aplicativos de negócios — para o Excel, Planilhas Google, relatórios ou um assistente de IA — sem precisar copiá-los primeiro. Para isso, ele precisa de um pequeno programa auxiliar em execução em algum lugar que já tenha acesso aos seus dados. Esse auxiliar é o Agente.
O que você vai precisar antes de começar
Um PC ou servidor Windows
É necessário que permaneça ligado enquanto houver pessoas executando consultas. Uma máquina que entra em modo de repouso à noite simplesmente ficará indisponível até ser ativada.
Sua chave de login
Um código único que vincula este agente à sua organização. Você o encontrará em Fluxos de Consulta na página de Download, ao lado do instalador.
Detalhes do seu banco de dados
O nome do servidor, o nome do banco de dados e um nome de usuário e senha que permitam a leitura. Se outra pessoa gerencia seu banco de dados, esta é a informação que você deve solicitar a ela.
Para onde deve ir? Instale o Agente em uma máquina que já consiga acessar seu banco de dados atualmente — geralmente o próprio servidor de banco de dados ou qualquer computador na mesma rede do escritório. Se você conseguir acessar os dados a partir dessa máquina, o Agente também conseguirá.
Instale-o em quatro etapas.
-
Baixe e execute o instalador.
Faça login em my.querystreams.com/download Selecione a opção de download para Windows. Execute o arquivo e aceite as instruções.
O Agente se instala como um serviço do Windows, que é uma forma elegante de dizer que ele inicia automaticamente sempre que o computador é inicializado. Você não precisa se lembrar de iniciá-lo, e este é o único momento em que você precisará baixá-lo. A partir daqui, ele se atualiza automaticamente..
-
Faça login com sua chave.
Após a instalação do Agente, abra a página dele nessa máquina:
Na máquina em que você acabou de instalá-lohttp://localhost:1823
Cole sua chave de login. Observe o ícone de confirmação no painel. canto superior esquerdo: assim que ler “Conectado a fluxos de consulta” Com um ponto verde, você terminou aqui. Esse é o Agente se apresentando à sua conta — e é a última coisa que você precisa fazer nesta máquina.
A própria página lhe dirá a mesma coisa: “Este agente executa suas conexões localmente — o gerenciamento diário ocorre no Portal de Fluxos de Consulta.” Esse é o sinal para você fechar a janela e continuar navegando no seu navegador.
-
Adicione sua primeira conexão — pelo seu navegador.
Agora volte para Query Streams no seu navegador e abra Agentes de dados (está embaixo) Dados (no menu superior). Seu novo agente será listado lá. Clique Adicionar conector e siga as instruções: escolha o tipo de banco de dados ou aplicativo e preencha os detalhes que você coletou anteriormente.
Você pode testar a conexão antes de salvá-la, assim saberá imediatamente se os detalhes estão corretos, em vez de descobrir isso mais tarde. O Query Streams também sugere configurações adequadas para bancos de dados comuns e adiciona um pequeno conjunto de exemplos de consultas prontas para uso, para que você possa executá-las imediatamente.
Depois de salvo, o Query Streams examina seu banco de dados e registra o que ele contém — as tabelas, as colunas e como elas se relacionam. É isso que preenche a lista que você seleciona no Construtor de Consultas, e é assim que a Nova consegue responder à pergunta “quantos pedidos enviamos no mês passado?” sem que você precise especificar o nome de uma única tabela. Você não precisa ativar o recurso nem configurá-lo; ele se atualiza automaticamente de acordo com uma programação, acompanhando as mudanças no seu banco de dados.
Ele lê a forma, não o conteúdo. Esta etapa diz respeito aos nomes das tabelas e colunas, não às suas linhas. Em um banco de dados grande, pode levar alguns minutos para ser concluída — você não precisa ficar esperando, e verá quando terminar no conector. Agentes de dados.
Sua senha nunca sai dessa máquina. Ao salvar uma conexão, os detalhes são enviados ao seu agente por meio de um link criptografado e as credenciais são armazenadas lá, no seu próprio computador — e não conosco.
-
Execute sua primeira consulta
O caminho mais rápido: clique em “Iniciar uma consulta” na última tela da configuração do conector. Isso abre Construtor de consultas Com a sua nova conexão já selecionada, não precisa procurar nada. Você também pode acessar a qualquer momento pelo menu superior.
A partir daí, execute uma das consultas de exemplo prontas, escreva a sua própria ou simplesmente faça uma pergunta à Nova — nossa assistente — em linguagem simples e deixe que ela escreva a consulta para você.
Ao salvar uma consulta, ela se torna reutilizável em qualquer lugar: atualize-a no Excel ou no Google Sheets, agende-a, compartilhe-a com um colega, entregue-a a um assistente de IA ou transforme-a em um link da web que outro sistema possa acessar.
Como as peças se encaixam
Você gerencia tudo pelo navegador.
Após a instalação e o login do Agente, Você não deveria precisar voltar a usar aquela máquina. Tudo — conexões, quais bancos de dados incluir, com que frequência os dados são atualizados, todas as configurações do próprio Agente — é gerenciado a partir daqui. Agentes de dados no seu navegador, de onde você estiver.
Consultar fluxos, no seu navegador
Tudo o que você realmente fará, de qualquer lugar:
- Adicionar, editar e remover conexões
- Testando uma conexão
- Escolher quais bases de dados incluir
- Definir a frequência de atualização dos dados.
- Todas as configurações do agente
A página do próprio agente
Um emprego, e você pode nunca mais precisar dele:
- Verificando por que o Agente não consegue acessar os Fluxos de Consulta.
Se o seu agente aparecer como offline no navegador e você não conseguir descobrir o motivo, abra localhost:1823 naquela máquina. O emblema no canto superior esquerdo indica imediatamente (Veja o que significam os quatro estados.), e consegue ver a rede do lugar onde está — algo que o seu navegador não consegue.
O agente está se tornando totalmente independente. Ele foi projetado para ser algo que você instala uma vez e esquece. Todas as operações estão migrando para isso. Agentes de dados No navegador, a única coisa que a própria página do Agente manterá é uma ajuda para descobrir por que ele não consegue acessar os Fluxos de Consulta. Portanto, se um guia ou um colega lhe disser para configurar algo na máquina do Agente, verifique primeiro o navegador.
Se você já leu uma versão anterior deste guia: Dizia que as conexões tinham de ser configuradas na própria página do Agente e não no navegador. Isso não é mais verdade — agora o navegador é o lugar certo para fazer isso. Tudo o que você configurou da maneira antiga ainda funciona e você encontrará tudo esperando por você nos Agentes de Dados.
O agente está se comunicando com fluxos de consulta?
Aquele selo no canto superior esquerdo da página do Agente é a resposta para quase todas as perguntas do tipo "por que isso não está funcionando?". Ele sempre indica uma de quatro coisas, e a mensagem explica exatamente qual é a sua situação. É isto que você deve procurar:
Conectar e reconectar são visualmente semelhantes: uma faixa colorida em movimento, indicando que a conexão está sendo trabalhada. Um brilho verde constante significa que a conexão está ativa. Um ícone apagado e sem brilho significa que não está.
Aquela luzinha não é um botão. Ele apenas exibe o status — clicar nele não faz nada. Conectar, Reconectar e Desconectar Os controles são botões nomeados no painel Conexão, mais abaixo na página, o que é proposital: uma luz sem rótulo que silenciosamente desconectava seu Agente ao ser clicada era uma armadilha que valia a pena remover.
Está tudo funcionando. Suas consultas serão executadas e quaisquer alterações feitas no navegador chegarão a este agente em segundos. Nada a fazer.
É normal que o sistema fique assim por alguns segundos após a inicialização da máquina ou a reinicialização do Agente. Aguarde um momento.
A conexão caiu e o Agente está restabelecendo automaticamente — geralmente uma breve instabilidade na rede, e não precisa da sua ajuda.
Se permanecer aqui por mais de alguns minutos, algo na rede está bloqueando a saída. Nesse caso, envie-nos uma mensagem.
Enquanto estiver nesse estado, nada funciona nesse agente. É o Agente que realiza a leitura propriamente dita, portanto, se não for possível contatá-lo, não há nada que faça o trabalho.
Verifique se a máquina está online e pressione Reconectar no painel de Conexão. Se a conexão não retornar, geralmente é um firewall ou proxy bloqueando o tráfego de saída — envie-nos uma mensagem e ajudaremos você a identificar o problema.
O que para de funcionar quando um agente é desconectado? Tudo que precisa acessar seus dados:
- As consultas às suas conexões não serão executadas — seja no Construtor de Consultas, no Excel ou no Google Sheets, na API REST ou por meio de um assistente de IA.
- Não ocorrem atualizações e automações programadas para esses dados.
- Suas conexões não podem ser testadas, visualizadas ou atualizadas a partir do seu navegador.
- Em Data Agents, aparece como offline, e os valores que você vê são os... última conhecida aqueles em vez de viver
Nada se perde, porém. As alterações que você salva no seu navegador enquanto ele está desconectado são mantidas e aplicadas assim que a conexão for restabelecida — então você pode continuar configurando tudo sem precisar esperar.
Entrar em contato devido a um problema de conexão? O painel Conexão nessa página lista as quatro coisas que mais nos ajudam. Copie-as para o seu... Suporte mensagem e geralmente podemos pular a troca de mensagens:
- Máquina
- Em qual computador o Agente está instalado?
- Organização
- a qual conta está vinculado
- Versão do agente
- Qual versão está sendo executada?
- Conectados desde
- quando conseguiu se conectar pela última vez
Ele se mantém atualizado.
Você instala o Agente apenas uma vez. Não será solicitado que você o baixe novamente, e não haverá notificações constantes de "atualização disponível" para se preocupar — quando lançarmos uma nova versão, seu Agente cuidará disso automaticamente, geralmente em questão de instantes.
Existem três maneiras de descobrir, para que nenhuma atualização passe despercebida:
No momento em que publicamos uma atualização, nós a enviamos diretamente pela conexão que seu Agente já tem aberta. Ele atualiza no local e reinicia automaticamente.
O sistema pergunta se perdeu alguma coisa alguns segundos depois de voltar a ficar online e, em seguida, atualiza a página.
Ele também realiza uma verificação diária usando sua própria conexão de saída — assim, mesmo em uma rede fortemente protegida, ele se mantém atualizado.
Como saber se está acompanhando o ritmo. O painel Conexão na página do Agente mostra Versão do agenteEm condições normais, o sistema acompanha nossa versão atual automaticamente. Se você notar que ele está muito atrasado por dias, algo na rede está bloqueando o caminho da atualização — isso merece uma investigação. mensagem para nósPorque não é algo que o Agente possa resolver sozinho com palavras.
Quando uma nova conexão começa a funcionar?
Quase sempre em poucos segundos. A resposta exata depende do seu agente:
O agente está em execução e atualizado, portanto, detecta a alteração imediatamente. Não é necessário reiniciar.
Seu troco é salvo com segurança e será aplicado assim que a máquina voltar a funcionar.
É raro, já que os agentes se atualizam automaticamente. O Query Streams informa na tela se isso se aplica ao seu caso.
Perguntas frequentes
Onde posso adicionar, editar ou excluir conexões?
No seu navegador, no Agentes de dados página — usar Adicionar conectorAs alterações geralmente chegam ao seu Agente em segundos. Se o Agente estiver offline, elas serão aplicadas assim que ele se reconectar. Você não precisa acessar o dispositivo do Agente para adicionar ou alterar uma conexão.
Meus dados são copiados para o Query Streams?
Não. Seu banco de dados permanece onde está. Quando você executa uma consulta, o Agente lê seu banco de dados e retorna apenas as linhas solicitadas pela consulta. A senha do seu banco de dados permanece na máquina do Agente.
Preciso abrir uma porta ou alterar o firewall?
Normalmente não. O agente estabelece uma conexão de saída conosco, da mesma forma que um navegador da web. Nada precisa aceitar tráfego de entrada da internet.
Posso usar mais de um agente?
Sim — muitas organizações executam um por local ou por rede. Todos aparecem juntos na sua conta, então não importa para quem está escrevendo a consulta qual agente mantém qual conexão.
Preciso ficar atualizando?
Não — e não há nada para clicar. Quando publicamos uma nova versão, ela é enviada para o seu Agente pela conexão já aberta, então geralmente atualiza em instantes e reinicia automaticamente. Ele também verifica por conta própria uma vez por dia como medida de segurança. Você pode ver em qual versão está instalado em Versão do agente no painel de Conexão.
E se eu ficar preso no meio do caminho?
Envie-nos uma mensagem de Suporte Dentro do Query Streams, diga-nos onde você parou. Se for mais fácil, diga qual tela você está visualizando e o que esperava ver — isso geralmente é suficiente para identificarmos o problema.
Linux
macOSSetup 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