> For the complete documentation index, see [llms.txt](https://docs.skyone.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skyone.cloud/espanol/skyone-studio/terminales-and-agentes/terminales.md).
# Terminales
* [**Concepto**](#concepto)
* [**Cuentas Conectadas**](#cuentas-conectadas)
* [**Gestión de Terminales**](#gestion-de-terminales)
* [**Información del Terminal**](#informacion-del-terminal)
* [**Probar la Conexión**](#probar-la-conexion)
* [**Logs del Terminal**](#logs-del-terminal)
* [**Eliminar un Agente**](#eliminar-un-agente)
### Concepto
Un **terminal** es una entidad lógica que representa la conexión de un único **Agente**, instalado en una máquina y vinculado a un usuario, con el **Espacio de Trabajo** de ese usuario en **Skyone Studio**.
Un **Espacio de Trabajo** puede contener varios terminales. Además, cualquier usuario del espacio puede ejecutar el **Agente**.
En una máquina con un **Agente** instalado, un terminal actúa como intermediario para permitir que una aplicación acceda a la **Base de Datos** de una empresa o a la **interfaz REST** de un ERP. Esto posibilita múltiples integraciones sin necesidad de una API pública. Así, varios flujos dentro de un **Espacio de Trabajo** pueden usar el mismo terminal, conectados por una o más cuentas de usuario.
Después de instalar y configurar un **Agente** en un entorno local (On Premises), automáticamente se crea un terminal en **Skyone Studio**. A partir de ese momento, puedes elegir y usar este terminal para configurar cuentas del tipo **REST** o **Base de Datos**. Cuando seleccionas un terminal al configurar estas cuentas, las credenciales de la cuenta se envían al **Agente** para ser utilizadas localmente.
Puedes asociar varias cuentas conectadas a un único terminal, lo que permite crear distintos usuarios en una base de datos para diferentes integraciones. Cada usuario puede configurarse en una cuenta distinta, pero todas las cuentas apuntarán al mismo terminal.
{% hint style="warning" %}
El terminal de un **Agente** es monitoreado de forma permanente, de modo que **Skyone Studio** siempre sabe cuándo está conectado y operativo. Por otro lado, la caída de un terminal, percibida mediante la desconexión del **Agente** asociado, implica la caída de todas las cuentas conectadas a él.
{% endhint %}
{% hint style="info" %}
Es posible instalar varios **Agentes** para un mismo usuario o **Espacio de Trabajo**, siempre que estén en diferentes dispositivos y con nombres y ubicaciones distintos. Cada uno aparecerá como un terminal diferente en **Skyone Studio**.
{% endhint %}
***
### Cuentas Conectadas
Por defecto, el campo **Terminal** de una cuenta del tipo **REST** o **Base de Datos** queda en blanco, lo que corresponde a no utilizar el **Agente** durante la conexión.
Para usar un **Agente** previamente instalado, debes seleccionar uno de los terminales (activos o no) configurados en el sistema. Ejemplo de configuración de cuenta conectada:
{% hint style="warning" %}
Cuando utilizas un **Terminal** en una cuenta, la ejecución de operaciones en un módulo (pruebas) o en un flujo (pruebas o ejecución) solo ocurrirá si el **Agente** está en ejecución y el **estado del Terminal** está activo (verde).
{% endhint %}
***
### Gestión de Terminales
En la pestaña **Terminales** verás todos los terminales conectados al **Espacio de Trabajo** seleccionado. Si aún no has instalado un **Agente**, puedes descargarlo haciendo clic en **“Descargar Agente”**.
Después de configurar uno o más **Agentes**, la lista de terminales disponibles y sus respectivos detalles y estados se mostrará en pantalla.
Cada fila corresponde a un **Agente** con información básica:
* **ID:** identificador único del **Agente**
* **Nombre del Agente:** nombre asignado durante la configuración
* **Conectado en:** última vez que el **Agente** se conectó
* **IP del Agente:** dirección IP de la máquina donde se instaló el **Agente**, visible solo cuando está conectado
* **Host ID:** firma del host que identifica de manera única la máquina donde se instaló el **Agente**
* **Estado:** estado de conexión del **Agente**
La información de esta pantalla es dinámica y se actualiza automáticamente cada pocos segundos.
***
### Información del Terminal
Para ver información detallada de un terminal:
1. En **Terminales**, selecciona el **Agente** que deseas visualizar y haz clic en el ícono de **Más Opciones**.
2. Selecciona **Visualizar**.
3. La pantalla de **Visualización del Terminal** mostrará los siguientes campos:
* **Host ID:** firma del host que identifica de manera única la máquina donde se instaló el **Agente**
* **Nombre del Agente:** nombre dado durante la configuración
* **Ubicación del Agente:** ubicación proporcionada durante la configuración
* **IP del Agente:** dirección IP de la máquina donde se instaló el **Agente**
* **Conectado en:** fecha de la última conexión (DD/MM/AAAA HH:MM:SS)
* **Último control del APC:** última vez que **Skyone Studio** envió un **APC (Agent Procedure Call)**
* **Último dato del APC:** última vez que **Skyone Studio** recibió mensajes
* **Controles entregados por el APC:** cantidad de mensajes enviados
* **Datos recibidos por el APC:** cantidad de mensajes recibidos
* **Cuentas Conectadas:** cuentas que apuntan al **Terminal**
***
### Probar la Conexión
El estado de la conexión indica que existe comunicación, pero no garantiza el funcionamiento completo. La prueba de conexión realiza un test completo con el **Agente**.
Para probar la conexión:
1. En **Terminales**, selecciona el **Agente** cuya conexión deseas probar y haz clic en **Más Opciones** (ícono de tres puntos).
2. Selecciona **Probar Conexión**.
3. Espera a que se ejecute la prueba y revisa el resultado.
***
### Logs del Terminal
Para ver los logs de un terminal:
1. En **Terminales**, selecciona el **Agente** y haz clic en el ícono de **Más Opciones**.
2. Selecciona **Logs**.
Los logs del terminal se mostrarán si existen registros disponibles.
***
### Eliminar un Agente
Si eliminas un **Agente** desde la pestaña **Terminales** y deseas volver a usar la aplicación, será necesario desinstalar y reinstalar el **Agente**. Esto también aplica si deseas modificar las configuraciones iniciales (Espacio de Trabajo, cuenta de **Skyone Studio**, nombre y ubicación del **Agente**).
Para eliminar un **Agente**:
1. En **Terminales**, selecciona el **Agente** que deseas eliminar y haz clic en **Más Opciones**.
2. Selecciona **Eliminar**.
3. Ingresa el nombre del terminal que deseas eliminar y confirma la acción haciendo clic en **Eliminar**.
Al eliminarlo, la conexión al servidor se interrumpirá. Para configurar nuevamente el **Agente**, será necesaria la desinstalación y reinstalación.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.skyone.cloud/espanol/skyone-studio/terminales-and-agentes/terminales.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.