Ir al contenido

Arquitectura del agente

Cómo funciona Kosmo

Kosmo trabaja dentro de un proyecto de Kosmico. No responde a un mensaje aislado: lleva adelante una tarea con los archivos, el contexto de investigación, las herramientas y los permisos del proyecto, en un modo explícito.

Los datos del producto que siguen se comprueban en el código fuente de Kosmico en cada versión. Distinguen qué puede hacer el agente, qué necesita tu permiso, qué cambia entre escritorio y web y qué datos salen del dispositivo.

La autonomía tiene límites explícitos

Una petición larga puede necesitar muchos pasos seguidos, pero las herramientas disponibles, las aprobaciones, el presupuesto de turnos y el modo activo marcan los límites. Que algo exista en escritorio no significa que exista igual en la web.

Por eso esta página detalla modos, permisos y diferencias entre escritorio y web, en lugar de usar «autonomía» como una etiqueta.

El contexto se selecciona del estado del proyecto

Puede incluir archivos, artículos, notas, el Research Map, la memoria del proyecto y el trabajo reciente. Kosmo lee lo que la tarea necesita; el proyecto entero no se pega en cada petición al modelo.

Cambiar de modelo cambia el modelo, no el proyecto. Un modelo que eliges tú queda seleccionado; con Recomendado, Kosmico elige antes de cada mensaje el modelo que incluye tu plan.

Almacenamiento local e inferencia local son decisiones distintas

Un archivo local, un proyecto sincronizado, una petición a un modelo en la nube y una a un modelo local siguen caminos distintos. Abajo se describen uno por uno, para que «en local» no se lea como «todo sin conexión».

Fuente oficial

Datos actuales del producto

Kosmico v0.7.6 · Verificado el

Disponibilidad

Disponibilidad
beta pública
Acceso
Registro abierto: creas una cuenta gratuita en la app web o en la de escritorio, sin código de activación.

Límites de autonomía

Kosmo puede encadenar muchos pasos por su cuenta, pero solo con las herramientas del modo activo: una herramienta fuera del modo se rechaza. Cada ejecución tiene un presupuesto fijo de turnos con herramientas, de 10 a 50 según dónde trabaje Kosmo (20 en el chat de escritorio, 50 en la web), y, al agotarse, termina con una respuesta escrita. Los subagentes de apoyo solo leen y tienen de 5 a 8 turnos.

Modos del agente

  • Agent: El modo predeterminado. Kosmo hace la tarea con las herramientas que admite el modelo: lee y edita archivos y, en escritorio, ejecuta comandos y celdas de notebooks.
  • Plan: Se activa con /plan. Kosmo lee el proyecto y propone los pasos; en el proyecto no cambia nada hasta que aceptas el plan, que luego se ejecuta en modo Agent.
  • Chat: Se usa cuando el modelo elegido no admite herramientas. Kosmo comenta el trabajo contigo y no cambia nada.

Permisos y protecciones

  • Los comandos de terminal, las celdas de notebooks, SSH y los cambios en el Research Map piden permiso antes: Permitir una vez, Permitir siempre o Denegar. Permitir siempre cubre un tipo de comando (por ejemplo git) hasta el final de ese chat.
  • Comandos como rm -r, sudo o dd nunca ofrecen Permitir siempre.
  • Las ediciones de archivos no interrumpen el trabajo: cada una aparece como un cambio que puedes aceptar, rechazar o revertir.
  • Un proyecto puede pasar a Acceso completo, que omite las preguntas, también las de comandos de riesgo. Solo vale para el proyecto abierto y se reinicia al salir o reiniciar la app.
  • Los comandos y los kernels de notebooks se ejecutan en tu equipo o en el servidor que conectas por SSH, nunca en los servidores de Kosmico.
  • Las herramientas de IA externas conectadas mediante el servidor MCP de Kosmico necesitan tu aprobación para cada acceso a tu memoria personal.

Modelos

Los modelos en la nube vienen de un catálogo que gestiona Kosmico y están incluidos en tu plan, contados en tokens. Los planes gratuitos tienen los modelos gratuitos; los de pago desbloquean el resto. El catálogo se actualiza desde el panel de administración, así que la lista puede cambiar entre versiones.

Recomendado
Recomendado es la opción predeterminada: antes de cada mensaje Kosmico elige el modelo que incluye tu plan. Un modelo que eliges tú queda seleccionado.
BYOK
No disponible. No hay dónde introducir una clave de API, y una suscripción a ChatGPT o Claude no puede alimentar el chat. Funciona al revés: Claude Code, Cursor y otros clientes MCP pueden usar tu proyecto a través del servidor MCP de Kosmico en escritorio.
Modelos por plan

Flujos de datos

Proyecto local (escritorio)

  • Los archivos se quedan en tu disco.
  • Un proyecto que nunca sincronizas no sale del equipo y no cuenta en el límite de proyectos de tu plan.

Proyecto sincronizado

  • La sincronización en la nube es un interruptor por proyecto. Un proyecto nuevo empieza con ella activada mientras tu plan tenga plazas libres.
  • Cuando está activada, el contenido del proyecto se copia en la nube de Kosmico para que colaboradores y la app web puedan acceder. Los secretos, como archivos .env y claves, nunca se sincronizan.
  • Puedes desactivarla en los proyectos que son tuyos: la copia en la nube se elimina, los archivos se quedan en el dispositivo y quien lo compartía contigo pierde el acceso.

Modelo en la nube

  • Tu mensaje, y lo que Kosmo lee para responder, pasan por Kosmico hasta el modelo en la nube que elegiste.
  • Las conversaciones se guardan para sincronizarlas entre tus dispositivos, y puedes borrarlas.
  • Kosmico no usa tus documentos ni tus prompts para entrenar modelos de IA.

Modelo local

  • Con un modelo local de Ollama no sale nada de tu equipo.

Fuentes de Deep Research

arXiv · siempre, a peticiónSemantic Scholar · siempre, a peticiónOpenAlex · siempre, a peticiónPubMed · a petición, cuando hace falta, por disciplinaCrossRef · a petición, cuando hace faltaDBLP · cuando hace faltaEurope PMC · cuando hace falta, por disciplina

Las etapas

  1. 01Revisas la propuesta: pregunta, alcance y fuentes
  2. 02Convierte la pregunta en objetivos y consultas, con una búsqueda web breve para el contexto
  3. 03Busca en paralelo en las bases de datos
  4. 04Une los duplicados por DOI, ID de arXiv, ID de PubMed o título casi idéntico
  5. 05Evalúa la pertinencia de cada candidato
  6. 06Busca de nuevo, sigue citas o detecta lagunas, una decisión cada vez
  7. 07Extrae la evidencia del texto completo de los artículos más pertinentes
  8. 08Redacta la revisión sección por sección y construye el Knowledge Graph

Cuándo se detiene

  • Solo termina como completa cuando reúne el número mínimo de artículos, la puntuación de cobertura alcanza el objetivo y cada objetivo requerido tiene artículos que lo respaldan. La puntuación se calcula, no la juzga un modelo: temas, métodos, periodo, variedad de fuentes, densidad de citas y objetivos.
  • Si Kosmo intenta terminar antes, vuelve a buscar para los objetivos que siguen abiertos.
  • Si no, se detiene cuando se agotan las búsquedas o pasadas de la profundidad elegida, y el resultado se marca como completado con lagunas, no como completo.

Comprobación de referencias

Cada cita viene de un registro obtenido de una de las bases de datos, y puedes abrirlo. La revisión solo puede citar artículos encontrados en la investigación: una sección con una referencia desconocida, o un párrafo sustancial sin cita, se rechaza y se reescribe. Una comprobación opcional resuelve además cada referencia por DOI, ID de arXiv, ID de PubMed o título y señala las que no puede confirmar.

Correspondencia entre afirmación y fuente

Una afirmación extraída del texto completo de un artículo solo se conserva si el pasaje citado aparece en la página indicada; las que no coinciden se descartan. Cada sección se redacta con la evidencia de los artículos que cita, pero ningún modelo comprueba que cada frase de la revisión esté respaldada: revisa las fuentes de lo que vayas a publicar.

Preguntas y respuestas

¿Puede Kosmo completar una secuencia larga sin supervisión?

Sí, con límites. En modo Agent encadena pasos con las herramientas que admite el modelo, dentro de un presupuesto fijo de turnos. Los comandos de terminal, las celdas de notebooks, SSH y los cambios en el Research Map piden permiso antes, salvo que des al proyecto Acceso completo, y cada edición de archivo aparece como un cambio que puedes revertir.

¿Cada modelo recibe el proyecto completo?

No. Kosmo lee lo que la tarea necesita, y eso es lo que llega al modelo en la nube que elegiste. Con un modelo local de Ollama en escritorio, no sale nada de tu equipo.

¿Puedo usar mi propia clave de API (BYOK)?

No. Los modelos en la nube los ofrece Kosmico y están incluidos en tu plan, y no hay dónde introducir una clave de API. Los modelos locales de Ollama en escritorio son gratuitos.