Tu primer espacio de trabajo

Lo que vas a crear

Al terminar este tutorial, tendrás:

• Un espacio de trabajo con el nombre de tu proyecto
• Un repositorio de Git registrado en él
• Cinco agentes sembrados, uno de los cuales habrás configurado lo suficiente para ejecutarlo
• Un segundo espacio de trabajo, vacío, que demuestra el límite de aislamiento

La incorporación ya creó un espacio de trabajo para ti. Este tutorial crea uno nuevo a propósito, para que veas cada parte del proceso.

Antes de empezar, elige un checkout de Git que cumpla estas tres condiciones; el paso de registro rechaza cualquier otro:

• está dentro de un árbol de trabajo de git
• tiene un remoto origin
• ese remoto apunta a github.com, gitlab.com o bitbucket.org

Paso 1: Crea un espacio de trabajo

1. Haz clic en el chip del espacio de trabajo de la barra de título
2. Elige Añadir espacio de trabajo…
3. Escribe un nombre que identifique el proyecto, como “api-service” o “frontend-v2”
4. De manera opcional, elige un logo
5. Haz clic en Añadir espacio de trabajo

Control Center cambia al nuevo espacio de trabajo y te lleva a su bandeja de entrada (/workspaces/<id>/inbox).

Detrás de eso, el servidor publica un evento WorkspaceCreated y siembra el espacio de trabajo con:

• un agente CEO, cuya persona es la coordinación y la delegación
• cuatro especialistas —qa, architect, engineer y librarian—, cada uno con sus propias instrucciones y skills
• las plantillas de pipeline integradas y sus filas de disparadores

Todos los espacios de trabajo que crees reciben todo esto, no solo el primero.

Compruébalo: abre Ajustes → Espacio de trabajo → Agentes. Hay cinco agentes en la lista, cada uno con un anillo de estado hueco.

Paso 2: Registra un repositorio

1. Ve a Ajustes → Espacio de trabajo → Repositorios
2. Haz clic en Añadir repositorio
3. Navega hasta tu checkout. El cuadro de diálogo recorre las carpetas de la máquina que ejecuta cc_server —no tu cliente— y se mantiene dentro de las raíces que ese servidor expone (el directorio de inicio de su usuario de forma predeterminada). Un checkout de git recibe un icono de carpeta distinto y una casilla de verificación; una carpeta normal no recibe ninguno de los dos, así que solo se pueden seleccionar checkouts.
4. Marca uno o varios checkouts y registra el lote. Las selecciones se conservan mientras navegas, así que puedes reunir varios en una sola pasada y una selección equivocada nunca descarta el resto.

Control Center lee el remoto origin de cada checkout, resuelve el propietario y el repo y crea la fila del repo dentro de este espacio de trabajo. No hay un segundo paso para vincularlo: el registro es lo que le da su alcance.

Registrar el mismo checkout en otro espacio de trabajo más adelante crea una segunda fila de repo, independiente y con su propio id. Entre espacios de trabajo, un checkout se identifica por su ruta en el sistema de archivos, nunca por su id.

Compruébalo: el repo aparece en la lista con su owner/repo y su rama actual.

Paso 3: Prepara un agente para ejecutarse

Los cinco agentes que este espacio de trabajo acaba de sembrar no tienen adaptador ni modelo. El despacho los ejecuta en Control Center (built-in) y, como no hay ningún modelo definido, le pide a Anthropic el suyo predeterminado, así que funcionan solo si conectaste una cuenta de Anthropic y, si lo hiciste, sobre un modelo que no elegiste. La incorporación del primer arranque fija su elección en todos los agentes del primer espacio de trabajo, una sola vez; un espacio de trabajo que crees después empieza con los cinco sin definir. Define uno ahora.

1. Abre Ajustes → Espacio de trabajo → Agentes
2. Selecciona engineer en la lista
3. En la pestaña Ajustes, define Adaptador como Control Center (built-in) y elige un Modelo de un proveedor que hayas conectado en Ajustes → Servidor → Proveedores de modelos
4. Presiona Guardar cambios

Compruébalo: vuelve a abrir el agente y los dos campos conservan tus elecciones.

Cada agente lleva su propio adaptador y modelo, así que repite esto con cualquier otro agente que quieras usar. Crear y configurar un agente explica el resto del formulario.

Paso 4: Observa el límite de aislamiento

Crea un segundo espacio de trabajo desde el chip de la barra de título, exactamente como en el paso 1. Luego examínalo:

• Ajustes → Espacio de trabajo → Repositorios está vacío. El repo que registraste hace un minuto no está ahí.
• Ajustes → Espacio de trabajo → Agentes contiene cinco agentes, pero son filas distintas: el adaptador que definiste en el paso 3 ya no está.
• La lista de espacios, los tickets y la memoria están todos vacíos.

No se filtró nada, porque no hay de dónde filtrarse: las filas de cada espacio de trabajo viven en el archivo de base de datos de ese mismo espacio. Una lectura entre espacios de trabajo no es una consulta que se filtra, es una consulta que no tiene dónde ejecutarse. Eliminar un espacio de trabajo es desvincular un archivo.

Vuelve con el chip de la barra de título, o abre Gestionar espacios de trabajo para verlos uno junto al otro.

Para conocer el modelo completo, lee Espacios de trabajo y aislamiento.

Resumen

Creaste un espacio de trabajo, viste cómo sembraba un CEO y cuatro especialistas, registraste un repo en él, le diste a un agente un adaptador y un modelo y confirmaste que un segundo espacio de trabajo no comparte nada de eso.

Siguiente: Despacha tu primer agente para poner el espacio de trabajo a trabajar.