Crear y configurar un agente

Esta guía te muestra cómo agregar un agente a un espacio de trabajo y configurarlo hasta que pueda ejecutarse de verdad.

Cada espacio de trabajo viene sembrado con cinco agentes —un CEO más qa, architect, engineer y librarian—, así que lo normal es que ya tengas agentes antes de haber configurado ninguno. Los pasos siguientes se aplican igual a un agente sembrado que a uno nuevo.

Antes de empezar

Estás dentro de un espacio de trabajo. Toda la superficie está en Ajustes → Espacio de trabajo → Agentes (/settings/workspace/agents).
El agente necesitará un backend. O conectas un proveedor para el arnés integrado en Ajustes → Servidor → Proveedores de modelos, o instalas la CLI de Claude Code en la máquina que aloja cc_server.
Si quieres que el agente lleve skills, instálalas antes en Ajustes → Espacio de trabajo → Habilidades. El formulario del agente solo permite activar skills que ya existan en el espacio de trabajo.

Agregar el agente

Abre Ajustes → Espacio de trabajo → Agentes.
Haz clic en Nuevo agente.

No hay ningún diálogo ni selector de rol. Se crea al instante un agente llamado «Agente sin nombre» y queda seleccionado en el panel de detalle de la derecha.

Ahora deberías ver «Agente sin nombre» en la lista de la izquierda, con la pestaña Ajustes de su panel de detalle abierta y un campo Nombre que contiene «Agente sin nombre».

Darle nombre

Nombre — el identificador corto que se usa en las menciones con @, por ejemplo alice. El análisis de menciones busca un @ seguido de caracteres de palabra, así que un nombre con guion, punto o espacio nunca se podrá mencionar.
Título — la etiqueta legible, por ejemplo «Programador sénior».
Prompt del sistema — instrucciones adicionales opcionales, que se inyectan como una sección «Agent instructions»; no sustituyen al resto del prompt ensamblado.

Haz clic en Guardar cambios en la parte inferior del formulario. Ese único botón guarda todos los campos de esta página.

Darle un adaptador y un modelo

El desplegable Adaptador lista los ejecutores que el host del servidor tiene realmente. El adaptador integrado siempre aparece (es el servidor). Claude Code solo aparece cuando su CLI se detectó en ese host:

Adaptador	Backend
Control Center (built-in)	El bucle de agente en proceso — sin CLI externa
Claude Code	`claude -p --output-format stream-json`

Solo el adaptador integrado aplica los modos, la orientación, la pausa y reanudación, los contratos de finalización y los subagentes. Claude Code no te da nada de eso. Cursor, Codex y los demás proveedores de modelos se conectan al adaptador integrado, no como ejecutores aparte.

El desplegable Modelo depende del adaptador que hayas elegido. Con el adaptador integrado, la lista llega en vivo desde los proveedores que hayas conectado en Ajustes → Servidor → Proveedores de modelos, así que un proveedor sin credencial almacenada aporta cero modelos.

Agregar skills

Habilidades es un selector de chips sobre los paquetes de skills instalados en este espacio de trabajo. Toca un chip para activarlo o desactivarlo; el glifo de verificación marca los seleccionados. Si el espacio de trabajo no tiene skills, el campo dice «No skills available. Create skills in Settings → Skills first.»

Aquí no eliges las skills propias de un repo. Un repo que las incluya (en .agents/skills/, .claude/skills/ o .opencode/skills/) las aporta automáticamente al agente que esté trabajando en él, y se cambian cuando pasa a otro: consulta Skills con alcance de repo.

Establecer la línea de reporte y la persona

Reporta a — elige otro agente por su nombre. Esto construye el árbol de reporte que muestra el botón Organigrama de la cabecera de la página. No es la lista que usa un líder de equipo cuando delega: esa sale de los miembros del equipo y de sus skills.
Persona — texto libre que da forma al tono y al comportamiento, por ejemplo: «Prefiere soluciones simples y legibles. Escribe pruebas para todo el código nuevo.»

Ajustar la ejecución

Esfuerzo de razonamiento — las opciones vienen de los niveles que publica el propio modelo seleccionado: Low / Medium / High, más Extra High en los modelos de estilo OpenAI y Extra High + Max en los de estilo Claude. El campo se oculta por completo cuando el modelo seleccionado no declara niveles de pensamiento, y su valor predeterminado es el del propio modelo.
Tamaño de la ventana de contexto — se rellena con la ventana de contexto del modelo cada vez que cambias de modelo, con chips de un toque para el valor predeterminado del modelo, 200k, 500k y 1M. Un valor que escribas después de elegir el modelo manda hasta el siguiente cambio de modelo.
Tiempo de silencio (minutos) — termina una ejecución después de ese tiempo sin salida. Déjalo vacío para usar el valor predeterminado de cada modo.

Conceder permisos

Un agente no tiene interruptores de permisos propios. Lo que puede enviar, abrir, fusionar o alcanzar lo fijan las reglas de acciones de Ajustes → Espacio de trabajo → Permisos de agentes, donde una regla se puede limitar a este agente. De entrada, un push, una pull request, una revisión o fusión y una escritura en un rastreador te preguntan primero cada uno, y el acceso a la red está permitido.

El token de GitHub del agente es siempre de solo lectura. Un push pasa por Control Center, que pregunta a la regla Enviar a un remoto antes de reenviarlo. Consulta Configurar políticas de sandbox para ver cómo llega cada regla a una ejecución.

Comprobar que se ejecuta

Abre Ajustes → Servidor → Proveedores de modelos y confirma que el adaptador que elegiste informa de una versión instalada y no de «No encontrado». Haz clic en Actualizar para volver a probar: la prueba se ejecuta en la máquina que aloja cc_server, no en la máquina que estás mirando.
Abre un espacio con el agente y envíale un mensaje, o menciónalo con @ en un espacio que ya exista.
Vuelve a Ajustes → Espacio de trabajo → Agentes, selecciona el agente y abre su pestaña Registros. Debería aparecer una ejecución con una insignia de estado, una duración, su hora de inicio y el adaptador que usó. Vista abre el flujo de eventos de esa ejecución.

Si no aparece ninguna ejecución, repasa Diagnosticar un agente.

Eliminar un agente

Selecciónalo en la lista. En la pestaña Ajustes, desplázate hasta la Zona de peligro, al final del formulario, y haz clic en Eliminar.