> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conceptos básicos

> Sesiones, proyectos, servidores en la nube, ejecución en tu dispositivo, Harness y modelos, fuentes de modelos, permisos, intervención requerida y subagentes, además de la función de cada área de la interfaz.

Esta página explica los conceptos que encontrarás a menudo al usar Cloud Agent. Los dos más importantes son las **sesiones** y los **servidores en la nube**: en una sesión asignas trabajo al agente, y el agente lo completa en un servidor en la nube o en tu ordenador.

## Sesiones

Una **sesión** es el registro completo del trabajo que tú y el agente hacéis sobre una tarea concreta, incluidos tus mensajes, los pasos del agente, sus respuestas y sus cambios. Una sesión puede pertenecer a un proyecto o a ninguno. Haz clic en **New chat** en la barra lateral para iniciar una sesión. Puedes archivar las sesiones que ya hayas terminado y, cuando quieras probar otra dirección, puedes bifurcar (fork) una nueva sesión a partir de un mensaje. Consulta [Iniciar una sesión](https://docs.aihubmix.com/es/cloud/sessions/start-a-session.md) y [Gestionar sesiones](https://docs.aihubmix.com/es/cloud/sessions/manage-sessions.md).

## Proyectos

Un **proyecto** es el directorio de código o el repositorio al que pertenece una sesión. Hay dos tipos:

* **Proyecto en la nube**: se crea en la nube, se importa desde GitHub o se sube desde tu ordenador. Se ejecuta en el servidor en la nube y puedes configurarle un entorno.
* **Proyecto local**: una carpeta de tu ordenador vinculada en la aplicación de escritorio. Las sesiones se ejecutan en ese ordenador y la carpeta no se sincroniza con la nube.

Una sesión que no pertenece a ningún proyecto se ejecuta en un directorio de trabajo temporal. Puedes moverla a un proyecto más adelante. Consulta [Proyectos y configuración del entorno](https://docs.aihubmix.com/es/cloud/environments/projects.md).

## Servidor en la nube y ejecución en tu dispositivo

Un **servidor en la nube** es la máquina Linux dedicada con IP pública que incluye Plus. Las sesiones que se ejecutan en él continúan cuando apagas tu ordenador. Puedes abrir un escritorio remoto para ver lo que hace el agente o tomar el control tú mismo.

La **ejecución en tu dispositivo** (que aparece en la interfaz como **Run on your device**) es la otra forma de ejecución: el agente permanece en la nube, pero la lectura y escritura de archivos y la ejecución de comandos ocurren en el ordenador que elijas, con el mismo efecto que una ejecución local. Ese ordenador debe tener la sesión iniciada en la aplicación de escritorio con **Allow execution** activado.

| | Servidor en la nube | En tu dispositivo |
| - | - | - |
| Entorno y archivos que se usan | La copia del proyecto y el entorno del proyecto en el servidor en la nube | El entorno y las carpetas de proyecto de ese ordenador |
| Proyectos disponibles | Proyectos en la nube, sesiones sin proyecto | Proyectos locales de ese ordenador, sesiones sin proyecto |
| Harness compatibles | Todos | Por ahora, solo Claude Code |
| El ordenador se apaga o se desconecta | No le afecta | La tarea actual se pausa y se reanuda automáticamente tras la reconexión |

Eliges la ubicación de ejecución al crear una sesión y no puedes cambiarla después. Consulta [Servidor en la nube](https://docs.aihubmix.com/es/cloud/environments/cloud-host.md) y [Ejecutar en tu dispositivo](https://docs.aihubmix.com/es/cloud/environments/your-device.md).

## Harness y modelos

Un **Harness** es el framework que ejecuta el agente, como Claude Code o Codex CLI. Un **modelo** es el modelo de lenguaje grande al que llama el Harness. Después de que una sesión envíe su primer mensaje, no puedes cambiar el Harness, pero sí el modelo. El **nivel de razonamiento** (que aparece en la interfaz como **Effort**) determina con qué profundidad piensa el modelo. Los niveles disponibles varían según el modelo. Consulta [Elegir un modelo](https://docs.aihubmix.com/es/cloud/models/choose-a-model.md).

## Fuentes de modelos

La **fuente de modelos** determina quién proporciona el modelo y dónde se contabiliza el uso.

| | Modelos Plus | Tus suscripciones | BYOK |
| - | - | - | - |
| Qué es | Modelos incluidos en el plan Plus | Tus propias cuentas de suscripción de ChatGPT, Claude u otras | Claves de API que añades tú mismo |
| Dónde se contabiliza el uso | En el plan Plus, sin cargo adicional | En la cuota de esa cuenta de suscripción | En el proveedor correspondiente, facturado según sus precios |

En BYOK, AIHubMix es un proveedor de pasarela más: una clave de API de AIHubMix que añadas se factura igual que cualquier otra clave y no tiene relación con Plus. Consulta [Fuentes de modelos](https://docs.aihubmix.com/es/cloud/models/model-sources.md).

## Permisos

Los **permisos** determinan si el agente te pregunta antes de realizar una acción. Elígelos en la parte inferior izquierda del cuadro de entrada:

* **Ask for approval**: siempre te pregunta antes de modificar archivos fuera del entorno o de acceder a internet.
* **Approve for me**: solo pregunta cuando detecta una acción potencialmente insegura.
* **Full access**: accede a internet y a todos los archivos del entorno en la nube sin restricciones. Las sesiones nuevas usan este nivel de forma predeterminada.

Puedes cambiar los permisos en cualquier momento durante una sesión.

## Requiere tu intervención

Cuando el agente se detiene para esperar a que apruebes un comando, respondas a una pregunta, proporciones un secreto o completes algo que no puede hacer por ti, como iniciar sesión, la sesión **requiere tu intervención**. La solicitud aparece encima del cuadro de entrada y la sesión también se marca en la barra lateral. Después de que la atiendas, la sesión continúa automáticamente. Consulta [Trabajar con el agente](https://docs.aihubmix.com/es/cloud/sessions/work-with-agent.md).

## Subagentes

Un **subagente** es un asistente que el agente envía dentro de la misma sesión para ocuparse de partes del trabajo en paralelo. Cuando todos terminan, los resultados se integran de nuevo en la sesión principal. Puedes ver el proceso de cada subagente en el panel derecho, pero no puedes enviarle mensajes directamente. Un subagente es distinto de una sesión que bifurcas (fork) manualmente: al bifurcar se crea una sesión independiente y normal. Consulta [Subagentes](https://docs.aihubmix.com/es/cloud/sessions/subagents.md).

## Vista general de la interfaz

* **Barra de iconos**: la columna de iconos en el extremo izquierdo de la ventana. Cambia entre Cloud Tasks, Scheduled, Projects, Cloud servers y Activity. El avatar de la parte inferior abre el menú de la cuenta.
* **Barra lateral**: la lista de sesiones, agrupada en Pinned, Cloud projects, Local projects y Recents.
* **Área de sesión**: el área principal en el centro de la ventana. Muestra los mensajes entre tú y el agente, sus pasos y los resultados.
* **Cuadro de entrada**: en la parte inferior del área de sesión. Úsalo para enviar mensajes, añadir archivos adjuntos y elegir el modelo, el nivel de razonamiento y los permisos.
* **Panel derecho**: los cambios, los archivos, las previsualizaciones web, el escritorio remoto del servidor en la nube, el chat lateral y los subagentes se abren aquí.

> [!NOTE]
>
> La web móvil no tiene barra de iconos. Las mismas entradas están en la parte inferior de la barra lateral. Cuando se abre el panel derecho, ocupa toda la página.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.