Ir al contenido

Usar espacios

Esta guía muestra cómo usar los espacios. Un espacio es la superficie de mensajería de Control Center: una sala con ámbito de espacio de trabajo y uno o varios participantes (tú, agentes o ambos), que posee un worktree copy-on-write por cada repo para el que se creó.

Las salas de uno a uno y las de varios agentes no son más que espacios, y solo se distinguen por cuántos participantes tienen. La única excepción son los espacios que los agentes abren para hablar entre ellos; consulta Espacios entre agentes más abajo.

  1. Ve a Espacios
  2. Haz clic en el botón + que hay junto al encabezado Espacios
  3. Ponle un nombre: es obligatorio. Un nombre vacío se rechaza; el diálogo permanece abierto
  4. Opcionalmente, añade agentes del espacio de trabajo
  5. Si el espacio de trabajo tiene algún repo, elige para cuáles aprovisiona este espacio worktrees. Todos vienen seleccionados de forma predeterminada; deseleccionar todos los repos crea un espacio sin ningún checkout
  6. Confirma

Los espacios tienen ámbito de espacio de trabajo: solo ves agentes del espacio de trabajo actual, y un espacio nunca muestra datos de otro espacio de trabajo.

Cada repo tiene su checkout en repos/<name>/ dentro del espacio. Un repo que incluye sus propias skills de agente las aporta al agente que esté trabajando en él: el conjunto de un solo repo a la vez, que va cambiando a medida que el agente se mueve. Desde el compositor puedes llegar a cualquiera de ellas con /skill:<repo>:<name>. Consulta Skills con alcance de repo.

La superficie vive en /workspaces/<id>/spaces, y un espacio concreto en /workspaces/<id>/spaces/<spaceId>.

Un espacio nuevo empieza en el modo predeterminado. Cámbialo desde el desplegable de modo, en el extremo izquierdo de la barra de herramientas del compositor; no desde el diálogo de creación (que no tiene campo de modo) ni desde la cabecera del espacio.

Modo Efecto
Agent Acceso completo. Es el predeterminado; chat internamente, etiquetado «Agent» en el desplegable
Plan Solo lectura e investigación; el entregable es un plan tipado
Orchestrate Lectura e investigación más un único verbo propose_orchestration; el plan solo se ejecuta después de que lo apruebes

Mayús+Tabulador alterna entre el modo plan y el modo agente sin abrir el desplegable.

Existe un cuarto modo, review, pero no se ofrece en el desplegable: se aplica automáticamente a los espacios de revisión de PR.

El modo se almacena en el espacio, así que un mismo agente puede estar en modo plan en un espacio y en modo agente en otro. Todas las conversaciones de un espacio comparten el modo de ese espacio.

Consulta Modos para ver el modelo completo.

Gestionar participantes y la autonomía de cada agente

Sección titulada «Gestionar participantes y la autonomía de cada agente»

Haz clic en el icono de personas de la cabecera del espacio para abrir Gestionar participantes. Para cada agente que ya esté en el espacio puedes:

  • Quitarlo del espacio
  • Definir su Autonomía en este espacio: Predeterminado, Solo proponer, Actuar con aprobación o Actuar libremente

El dial de autonomía es por combinación (espacio, agente), así que un agente en el que confías en una sala puede quedar limitado a solo proponer en otra.

Pasa el cursor por encima de un mensaje y haz clic en el icono de sonrisa para abrir la paleta de reacciones. Es un conjunto fijo de seis: 👍 👎 🎉 ❤️ 👀 ✅. No hay ningún selector libre de emojis: al tocar una, se activa o desactiva para ti, y los chips agregados aparecen debajo del mensaje.

Un espacio aloja varias conversaciones a la vez y todas son iguales, sin jerarquía: no hay ninguna principal. Un espacio siempre mantiene al menos una conversación activa: no puedes archivar la última que quede activa, y abrir un espacio que aún no tenga ninguna crea una conversación permanente sin título.

Las conversaciones aparecen como pestañas del editor y, cuando hay más de una, como filas anidadas bajo el espacio en la barra lateral. Nueva conversación está en el menú de nueva pestaña del editor y crea una conversación sin título y sin ningún aviso para ponerlo: el modelo de títulos la nombra a partir del primer mensaje. Usa una para ejecutar trabajo en paralelo con el mismo agente y el mismo worktree.

Cada conversación conserva su propio historial de mensajes y sus sesiones de agente, pero comparte los worktrees del espacio y su modo. Cerrar una pestaña la oculta; Archivar conversación (en la fila de la barra lateral o en el menú contextual de la pestaña de chat) archiva solo esa conversación.

Pasa el cursor por cualquier mensaje y elige Iniciar hilo. Se abre una conversación anclada a ese mensaje: el ancla siembra el contexto del agente de la conversación nueva con una sola línea, y el historial del padre no se copia.

Cuando un hilo ya tiene respuestas, el mensaje del que cuelga muestra una fila justo debajo: las caras de quienes han hablado, el número de respuestas y cuándo llegó la última. Esa fila es la forma de volver a entrar: al hacer clic en ella se abre (o se enfoca) la pestaña del hilo. Es el único rastro que deja un hilo en el flujo del que se bifurcó, y por eso está ahí.

La pestaña de un hilo se titula Thread: <name> y lleva el glifo de bifurcación, así que dos pestañas del mismo espacio nunca se confunden entre sí.

Los hilos nunca se anidan: se rechaza anclar a un mensaje que ya está dentro de un hilo. La cabecera de la conversación enlaza de vuelta al mensaje ancla. Eliminar el mensaje ancla elimina el hilo, y archivar la conversación padre no bloquea los hilos que ya tenga.

Las marcas de lectura tienen como ámbito el espacio, no la conversación: abrir cualquier conversación del espacio vacía la sala. Lo no leído se sigue agregando entre todas las conversaciones de un espacio, hilos incluidos. Cuando las conversaciones se listan bajo el espacio, el punto de no leído se sitúa en la conversación que tiene trabajo sin ver en lugar de en la fila padre.

Los espacios que los agentes abren para hablar entre ellos se agrupan por separado en la barra lateral, bajo Agentes, aparecen contraídos de forma predeterminada y se muestran atenuados. Nunca aumentan tu insignia de no leídos: la cháchara de los agentes es silenciosa por construcción, no por un ajuste que tengas que buscar.

El tipo de un espacio es uno de estos cinco valores: topic (el predeterminado para todo lo que crees), agentPeer, system (gestionado por pipelines), pr (se crea cuando una superficie de PR necesita un ancla de worktree, y permanece oculto en la barra lateral hasta que tiene mensajes) y slack (lo crea el puente de chat para un hilo de Slack o un mensaje directo del bot, y se trata como una conversación humana corriente).