Configuración · Windows
Instale el agente de Query Streams en Ventanas
El Agente es un pequeño programa que se ejecuta junto a tus datos y se encarga de la conexión. Instálalo una vez y luego configura todo lo demás desde tu navegador.
Query Streams te permite extraer datos en tiempo real de tus bases de datos y aplicaciones empresariales (a Excel, Google Sheets, informes o un asistente de IA) sin copiarlos primero en ningún sitio. Para ello, necesita un pequeño programa auxiliar que se ejecute en algún lugar que ya pueda acceder a tus datos. Ese programa auxiliar es el Agente.
Lo que necesitarás antes de empezar
Un PC o servidor con Windows
Debe permanecer encendido mientras se realizan consultas. Un equipo que entra en modo de suspensión durante la noche simplemente no estará disponible hasta que se active.
Tu clave de acceso
Un código de un solo uso que vincula este agente a su organización. Lo encontrará en la sección "Flujos de consulta" de la página de descarga, justo al lado del instalador.
Detalles de su base de datos
El nombre del servidor, el nombre de la base de datos y un nombre de usuario y contraseña para acceder a ella. Si otra persona administra tu base de datos, esta es la información que debes solicitarle.
¿Dónde debería ir? Instale el Agente en un equipo que ya pueda abrir su base de datos; normalmente, se trata del propio servidor de la base de datos o de cualquier PC de la misma red de oficina. Si usted puede acceder a los datos desde ese equipo, el Agente también podrá.
Instálalo en cuatro pasos.
-
Descarga y ejecuta el instalador.
Iniciar sesión en my.querystreams.com/descargar y elige la descarga para Windows. Ejecuta el archivo y acepta las indicaciones.
El agente se instala como un servicio de Windows, lo que significa que se inicia automáticamente cada vez que se enciende el equipo. No es necesario que recuerdes iniciarlo, y esta es la única vez que lo descargarás. Se actualiza automáticamente a partir de ahora..
-
Inicia sesión con tu clave.
Cuando el agente esté instalado, abra su página en esa máquina:
En la máquina en la que lo acabas de instalarhttp://localhost:1823
Pegue su clave de inicio de sesión. Mire la insignia en el esquina superior izquierda: una vez que se lee “Conectado a flujos de consultas” Cuando aparezca un punto verde, habrá terminado. El agente se está presentando a su cuenta, y es lo último que debe hacer en este dispositivo.
La propia página te dirá lo mismo: “Este agente gestiona sus conexiones localmente; la administración diaria se realiza en el Portal de Flujos de Consultas.” Esa es la señal para que la cierres y continúes en tu navegador.
-
Agrega tu primera conexión desde tu navegador.
Ahora vuelve a Consultar flujos en tu navegador y abre Agentes de datos (está bajo Datos en el menú superior). Su nuevo agente aparecerá allí. Haga clic. Agregar conector y responde a las preguntas: elige qué tipo de base de datos o aplicación es y luego completa los detalles que recopilaste anteriormente.
Puedes probar la conexión antes de guardarla, así sabrás al instante si los detalles son correctos, en lugar de descubrirlo más tarde. Query Streams también sugiere configuraciones adecuadas para bases de datos comunes y añade un pequeño conjunto de consultas de ejemplo predefinidas para que puedas ejecutarlas de inmediato.
Una vez guardado, Query Streams analiza tu base de datos y registra su contenido: las tablas, las columnas y sus relaciones. Esta información se utiliza para completar la lista que seleccionas en Query Builder, y así es como Nova puede responder a la pregunta "¿Cuántos pedidos enviamos el mes pasado?" sin que tengas que mencionar ninguna tabla. No necesitas activarlo ni configurarlo; se actualiza automáticamente según un cronograma, adaptándose a los cambios en tu base de datos.
Analiza la forma, no el contenido. Este paso se refiere a los nombres de las tablas y columnas, no a las filas. En una base de datos grande, puede tardar unos minutos en completarse; no tiene que esperar, y verá cuándo ha terminado en el conector. Agentes de datos.
Tu contraseña nunca sale de esa máquina. Cuando guardas una conexión, los detalles se transmiten a tu agente a través de un enlace cifrado y las credenciales se almacenan allí, en tu propio ordenador, no con nosotros.
-
Ejecuta tu primera consulta
La ruta más rápida: pulse “Iniciar una consulta” en la última pantalla de la configuración del conector. Eso abre Generador de consultas Con tu nueva conexión ya seleccionada, no tienes que buscar nada. También puedes acceder en cualquier momento desde el menú superior.
A partir de ahí, ejecuta una de las consultas de ejemplo predefinidas, escribe la tuya propia o simplemente hazle una pregunta a Nova, nuestro asistente, en lenguaje sencillo y deja que escriba la consulta por ti.
Cuando guardas una consulta, esta se vuelve reutilizable en cualquier lugar: puedes actualizarla en Excel o Google Sheets, programarla, compartirla con un compañero, dársela a un asistente de IA o convertirla en un enlace web al que otro sistema pueda acceder.
Cómo encajan las piezas
Puedes gestionarlo todo desde el navegador.
Una vez que el Agente esté instalado y se haya iniciado sesión, No deberías tener que volver a esa máquina. Todo —conexiones, qué bases de datos incluir, con qué frecuencia se actualizan los datos, todas las configuraciones del propio Agente— se gestiona desde Agentes de datos en tu navegador, desde dondequiera que te encuentres.
Consulta flujos, en tu navegador
Todo lo que realmente harás, desde cualquier lugar:
- Agregar, editar y eliminar conexiones
- Probando una conexión
- Elegir qué bases de datos incluir
- Configurar la frecuencia de actualización de los datos
- Configuración de todos los agentes
La página del propio agente
Un solo trabajo, y puede que nunca lo necesites:
- Comprobando por qué el agente no puede acceder a los flujos de consulta.
Si su agente aparece como desconectado en el navegador y no puede ver por qué, abra localhost:1823 en esa máquina. La insignia en su esquina superior izquierda te lo dice enseguida (ver qué significan los cuatro estados), y puede ver la red desde donde se encuentra, algo que su navegador no puede hacer.
El agente se está desvinculando por completo de la intervención humana. Está diseñado para ser algo que instalas una vez y te olvidas. Cada operación se está moviendo hacia Agentes de datos En el navegador, la página del Agente solo te ayudará a averiguar por qué no puede acceder a los flujos de consulta. Por lo tanto, si un guía o un compañero te indica que configures algo en la máquina del Agente, primero revisa el navegador.
Si has leído una versión anterior de esta guía: Decía que las conexiones debían establecerse en la propia página del Agente y no En el navegador. Eso ya no es cierto: ahora el navegador es el lugar para hacerlo. Todo lo que configuraste de la forma anterior sigue funcionando y lo encontrarás disponible en Data Agents.
¿El agente se comunica con los flujos de consulta?
Esa insignia en la esquina superior izquierda de la página del Agente es la respuesta a casi todas las preguntas de "¿por qué no funciona esto?". Siempre dice una de cuatro cosas, y el texto te indica exactamente en qué situación te encuentras. Esto es lo que estás buscando:
Conectar y reconectar se ven igual: una banda de color en movimiento, que significa "trabajando en ello". Un brillo verde constante significa que está conectado. Un indicador plano y tenue significa que no lo está.
La lucecita no es un botón. Solo informa el estado; al hacer clic en él no sucede nada. Conectar, Reconectar y Desconectar Los controles son botones con nombre en el panel de Conexión, más abajo en la página, lo cual es intencional: una luz sin etiqueta que desconectaba silenciosamente a su Agente al hacer clic era una trampa que valía la pena eliminar.
Todo funciona correctamente. Tus consultas se ejecutarán y cualquier cambio que realices en el navegador llegará a este agente en cuestión de segundos. No tienes que hacer nada.
Es normal que esto ocurra durante unos segundos después de que el equipo arranque o el agente se reinicie. Espere un momento.
La conexión se ha interrumpido y el agente la está restableciendo automáticamente; normalmente se trata de un breve fallo de red y no necesita ninguna ayuda por tu parte.
Si permanece aquí durante más de unos minutos, algo en la red está bloqueando la salida. En ese caso, deberías avisarnos.
Mientras se encuentre en este estado, nada en este Agente funcionará. Es el Agente el que realiza la lectura propiamente dicha, así que si no se puede acceder a él, no hay nada que haga el trabajo.
Compruebe que la máquina esté en línea y, a continuación, pulse Reconectar En el panel de Conexión. Si no vuelve a funcionar, normalmente se debe a un cortafuegos o un servidor proxy que bloquea el tráfico saliente. Envíanos un mensaje y te ayudaremos a identificar la causa.
¿Qué se detiene mientras un agente está desconectado? Todo lo que necesita acceder a sus datos:
- Las consultas a sus conexiones no se ejecutarán, ya sea en el Generador de consultas, en Excel o Google Sheets, desde la API REST o desde un asistente de IA.
- Las actualizaciones programadas y las automatizaciones para esos datos no se realizan.
- Sus conexiones no se pueden probar, explorar ni actualizar desde su navegador.
- En Data Agents aparece como fuera de línea y las cifras que ve son las siguientes: último conocido aquellos en lugar de vivir
Sin embargo, no se pierde nada. Los cambios que guardes en tu navegador mientras está ausente se conservarán y se aplicarán en el momento en que se vuelva a conectar, por lo que puedes seguir configurando las cosas sin tener que esperar.
¿Tienes algún problema de conexión? El panel Conexión en esa página enumera las cuatro cosas que más nos ayudan. Cópielas en su Ayuda mensaje y normalmente podemos saltarnos el intercambio de mensajes:
- Máquina
- en qué ordenador se encuentra el Agente
- Organización
- a qué cuenta está vinculada
- Versión del agente
- ¿Qué versión está ejecutando?
- Conectados desde
- cuando logró conectarse por última vez
Se mantiene actualizado
Instalas el Agente una sola vez. No se te pedirá que lo descargues de nuevo, y no tendrás que preocuparte por las actualizaciones: cuando lancemos una nueva versión, tu Agente se encargará de instalarla automáticamente, generalmente en cuestión de segundos.
Tiene tres formas de averiguarlo, para que no se pierda ninguna actualización:
En el momento en que publicamos una actualización, la enviamos directamente a través de la conexión que su agente ya tiene abierta. Se actualiza en el lugar y se reinicia automáticamente.
Pregunta si se ha perdido algo unos segundos después de volver a conectarse y, a continuación, se pone al día.
Además, realiza una comprobación diaria utilizando su propia conexión saliente, por lo que incluso en una red con acceso muy restringido se mantiene actualizada.
Cómo saber si se está actualizando correctamente. El panel de conexión en la página del agente muestra Versión del agenteEn condiciones normales, esto realiza un seguimiento de nuestra versión actual por sí solo. Si nota que se queda muy atrás durante días, algo en la red está bloqueando la ruta de actualización; eso merece una revisión. Envíanos un mensaje, porque no es algo de lo que el Agente pueda salir airoso por sí solo.
¿Cuándo empieza a funcionar una nueva conexión?
Casi siempre en cuestión de segundos. La respuesta exacta depende de su agente:
El agente está en funcionamiento y actualizado, por lo que detecta el cambio de inmediato. No es necesario reiniciarlo.
Tu cambio se guarda de forma segura y se aplica en el momento en que la máquina vuelve a estar en línea.
Es poco común, ya que los agentes se actualizan automáticamente. La función Consultar flujos te indicará en pantalla si esto se aplica a tu caso.
Preguntas frecuentes
¿Dónde puedo agregar, editar o eliminar conexiones?
En su navegador, en el Agentes de datos página — usar Agregar conectorLos cambios suelen llegar a su agente en cuestión de segundos. Si el agente ha estado desconectado, se aplicarán en cuanto se vuelva a conectar. No es necesario acceder al equipo del agente para añadir o modificar una conexión.
¿Se copian mis datos a los flujos de consulta?
No. Tu base de datos permanece donde está. Cuando ejecutas una consulta, el Agente lee tu base de datos y devuelve solo las filas solicitadas. Tu contraseña de la base de datos se queda en el equipo del Agente.
¿Necesito abrir un puerto o modificar nuestro cortafuegos?
Normalmente no. El agente establece una conexión saliente con nosotros, del mismo modo que lo hace un navegador web. No es necesario que nada acepte tráfico entrante de internet.
¿Puedo usar más de un agente?
Sí, muchas organizaciones administran uno por sitio o por red. Todos aparecen juntos en tu cuenta, por lo que a la persona que realiza una consulta no le importa qué agente tiene qué conexión.
¿Tengo que seguir actualizándolo?
No, y no hay nada en lo que hacer clic. Cuando publicamos una nueva versión, se envía a su Agente a través de la conexión que ya tiene abierta, por lo que normalmente se actualiza en cuestión de segundos y se reinicia automáticamente. También realiza una comprobación automática una vez al día como medida de seguridad. Puede ver en qué versión se encuentra en Versión del agente en su panel de conexión.
¿Qué pasa si me quedo atascado a la mitad?
Envíanos un mensaje desde Ayuda Dentro de Query Streams, indíquenos dónde se encuentra. Si le resulta más fácil, diga qué pantalla está viendo y qué esperaba ver; con eso solemos poder identificar el 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