Configurar las tareas del agente

Activarlo

Las tareas del agente se activan por proyecto, no por cuenta. Abre el proyecto, ve a Ajustes, luego a la pestaña Agente, y marca Activar tareas del agente. Eso arranca un poller dentro de cada instancia de staging y de desarrollo del proyecto, lista para recoger trabajo.

Necesitas el permiso de ajustes del proyecto para ver y cambiar esta pestaña. Si no puedes abrirla, pregunta a quien administre tu espacio de trabajo.

Elegir una CLI

En CLI del agente, elige qué CLI de programación planifica y ejecuta las tareas de este proyecto:

• Claude Code
• Gemini CLI
• Codex CLI

Cada una inicia sesión con su propia credencial y se ejecuta en tu propia cuenta con ese proveedor. CICDoo no revende acceso a modelos; el agente usa la suscripción o la clave que tú aportas, y las ejecuciones cuentan contra tu cuota allí.

Puedes cambiar de CLI más tarde. Una credencial que ya has guardado conserva su máscara, así que cambiar a otra y volver no vuelve a pedirte el secreto.

Conectar tu cuenta

Cómo te conectas depende de la CLI, y esa diferencia decide quién paga.

Claude Code

Ejecuta claude setup-token en tu propia máquina, lo que requiere una suscripción a Claude, y pega el token en Token de Claude Code. Es el único modo que ofrece aquí Claude Code.

Gemini CLI y Codex CLI

Ambas pueden funcionar de dos maneras, que se eligen en Cómo inicia sesión el agente:

• Tu propia suscripción. Inicia sesión en la CLI en tu propia máquina y luego pega el contenido completo de su archivo de sesión en caché: ~/.gemini/oauth_creds.json para Gemini, ~/.codex/auth.json para Codex. El agente lo refresca mientras trabaja y devuelve la copia refrescada, así que no deberías tener que repetir esto.
• Clave de API, facturada por token. Crea una clave en Google AI Studio o en el panel de la plataforma de OpenAI y pégala. El proveedor factura las ejecuciones a esa clave.

Una licencia de pago de Gemini Code Assist necesita además el id de su proyecto de Google Cloud. Déjalo en blanco si usas una cuenta personal de Google.

Lee esto antes de pegar una credencial

La credencial se guarda en la plataforma y se envía a los contenedores de tu instancia para que el agente pueda autenticarse. Cualquiera con acceso de shell o de IDE a esos contenedores puede leerla.

Un archivo de sesión es algo más fuerte de entregar que una clave de API. Es la sesión de tu cuenta, no una credencial acotada: no se puede revocar por sí sola, y es lo que usaría la CLI si alguien la ejecutara a mano dentro del contenedor. Los proveedores además orientan estos planes al uso interactivo, y OpenAI recomienda una clave de API para flujos automatizados, así que revisa las condiciones de tu plan antes de apuntar un agente a una suscripción personal.

Si eso te preocupa en tu caso, usa el modo de clave de API donde el proveedor lo ofrezca: una clave se puede acotar y revocar por sí sola.

Ajustes opcionales

• Modelo. Un alias de modelo o el nombre completo del modelo para la CLI que elegiste. Déjalo en blanco para usar el suyo por defecto.
• Ejecución automática de planes. Las nuevas tareas de este proyecto se saltan el paso de revisión: un plan correcto se aprueba automáticamente y luego se implementa y se sube con push sin que nadie lo lea antes. Un plan que el agente marca como bloqueado sigue esperándote, igual que todos los planes en la instancia de producción. Puedes cambiarlo tarea por tarea, y activarlo requiere el permiso de aprobación de planes.

Habilidades: enseñarle tus convenciones

La sección Habilidades de esa misma pestaña es donde registras las convenciones de la casa que el agente debe seguir: cómo nombras las cosas, cómo escribes las vistas, cómo pruebas.

Sube un archivo Markdown, o un .zip de una carpeta de habilidad con un SKILL.md dentro. Eliges qué habilidades usa una tarea al crearla, y una habilidad puede marcarse como siempre activa para que la reciban todas las tareas. Las habilidades viven en el bucket de almacenamiento propio de tu proyecto y se instalan en el contenedor para las tareas que las usan.

Es la forma más barata de mejorar los resultados. Un agente que conoce la disposición de tus módulos y tu convención de pruebas produce planes que tienes que corregir menos veces.

Siguientes pasos

Para saber qué es una tarea del agente y las reglas alrededor de producción, consulta Qué son las tareas del agente. Para crear y revisar la primera, consulta Ejecutar una tarea y revisar el resultado.

Si te quedas atascado, abre un ticket de soporte desde la página de Tickets o el widget de chat.