Agentes, modelos y uso — Documentación de Noea Code

El Agente lee tu proyecto y realiza tareas; el modelo interpreta y genera contenido. Esta guía explica cómo gestionar Agentes, conectar proveedores de modelos, elegir ajustes y leer la información de uso. Los modelos, métodos de inicio de sesión y funciones disponibles dependen del Agente seleccionado.

Gestiona los Agentes locales

Abre Configuración → Agente. Noea ofrece actualmente Codex, Claude Code, OpenCode y CodeBuddy Code, cada uno con su versión, estado y acción principal.

Pulsa la fila de un Agente para abrir su panel de detalles e instalarlo, iniciar sesión, verificarlo, actualizarlo o desinstalarlo. Cada Agente se prepara por separado. Cerrar el panel no interrumpe una preparación ya iniciada.

Listo significa que se ha superado la verificación. Un estado de instalación completada o unas credenciales detectadas aún requieren verificación. Si falla, sigue el panel de detalles. Consulta Instalar y preparar Noea para la configuración inicial.

Conecta un proveedor de modelos

Los Agentes compatibles con varios proveedores muestran una lista en su panel de detalles. Selecciona un proveedor y conéctalo mediante una cuenta o una clave de API según las instrucciones.

Un mismo proveedor se conecta y gestiona por separado en cada Agente. El Agente se encarga del inicio de sesión y del almacenamiento de credenciales; Noea no guarda claves de inicio de sesión por separado. El Agente sí puede almacenar datos de autenticación localmente.

OpenCode también ofrece un punto de conexión personalizado. Introduce un nombre, la URL base, el protocolo y al menos un modelo; después guarda y configura las credenciales en la ventana de inicio de sesión. Elige Chat Completions o Responses según la API de tu servicio.

Un fallo al leer la lista de proveedores no es lo mismo que un proveedor sin conectar. Actualiza para comprobar el estado de conexión actual y la hora de consulta.

Configura el chat actual

Utiliza el menú de configuración bajo el cuadro de entrada para elegir el Agente, el modelo y el esfuerzo de razonamiento. El esfuerzo de razonamiento ajusta cuánto razonamiento dedica el modelo a un problema. Los modelos se agrupan por proveedor. El esfuerzo de razonamiento, el modo de planificación, el modo rápido y otras opciones aparecen según la compatibilidad del Agente.

Un chat nuevo normalmente utiliza el Agente del último chat normal conectado correctamente. Puedes cambiarlo antes del primer mensaje, pero no después de la conexión. Inicia un chat nuevo para utilizar otro Agente.

Algunas listas de modelos solo están disponibles después de conectar, como indica la interfaz. Si el Agente no admite una opción, no se aplicará y el chat explicará por qué.

Los permisos tienen un control separado en el cuadro de entrada. Elige entre las opciones disponibles del Agente según la tarea.

Configura las operaciones del proyecto

En Configuración → Proyecto actual → Operaciones, elige por separado un Agente, modelo y esfuerzo de razonamiento para Implementar, Explicar y Organizar la Fuente.

Estos ajustes se aplican a las respectivas operaciones del proyecto, no a todos los chats normales. Explicar activado después de implementar en un chat utiliza el Agente de ese chat. Explicar después de aceptar un plan de organización utiliza los ajustes de Explicar del proyecto.

Si el Agente seleccionado no está disponible, Noea utiliza una alternativa disponible y muestra un aviso. Comprueba aquí la elección efectiva antes de ejecutar una operación.

Lee el uso del chat actual

El pequeño anillo bajo el cuadro de entrada muestra el uso del contexto. Púlsalo para ver el contexto, los límites o saldos de la cuenta, y la información de tokens y costes del chat actual. Los tokens son unidades que utilizan los modelos para procesar texto y otros contenidos; no equivalen a palabras ni caracteres.

El uso de contexto indica cuánto espacio de contexto disponible del modelo utiliza el chat. Los límites de cuenta describen las restricciones de uso impuestas por el proveedor o el Agente. Miden cosas distintas.

Consulta totales e interpreta los costes

Abre Configuración → Uso o elige la opción de ver todo el uso en el panel de uso. Filtra por hoy, los últimos 7 días, los últimos 30 días o todo el periodo. Expande un Agente para ver detalles de modelos y tokens.

Información	Alcance y significado
Uso dentro de la aplicación	Registros generados por el trabajo dentro de Noea.
Límites de cuenta	Pueden incluir uso fuera de Noea y no cambian con el filtro de periodo.
Equivalentes o estimaciones según tarifas de API	Una forma de entender la escala del uso, no tu factura real de suscripción.
Créditos	Se muestran por separado según su origen y no se tratan como dólares estadounidenses.
Sin precio o desconocido	Faltan precios o lecturas; no significa coste ni uso cero.

Las lecturas muestran su hora de actualización. Si una actualización falla, se conserva el valor anterior. Actualiza después de la hora de restablecimiento antes de interpretar el límite. Si un Agente no puede informar de los límites de cuenta, la interfaz indica que no están disponibles.

Para problemas de conexión, consulta Solución de problemas. Para extensiones, consulta Añadir servidores MCP y Skills.