Skip to main content
Un agente especializado asigna un rol a una parte de la tarea, como revisar un diff o investigar una cadena de llamadas. Su descripción indica cuándo delegar; sus instrucciones explican cómo trabajar. Use un rol específico cuando repita el mismo tipo de investigación o revisión.

Use un agente disponible

Abra Settings → Agents para examinar definiciones preestablecidas, personales, del proyecto y de paquetes. Busque por nombre o descripción, filtre con All o Enabled y compruebe el interruptor del agente. En una sesión de Code, escriba @ y seleccione el agente en las sugerencias. Delimite la tarea y la salida:
Revise el cambio de cantidades del checkout. Compruebe cálculo, pruebas y conservación de la firma pública. Informe de problemas concretos con referencias a archivos. No modifique archivos.
Lea los hallazgos antes de pedir cambios. Detectar una prueba ausente no la escribe ni la ejecuta. Mantenga la revisión del diff y la verificación en el flujo principal.

Los roles de agente disponibles definen una tarea, una selección de modelo y un conjunto de herramientas.

Cree un rol reutilizable

Elija New agent en Settings → Agents o duplique una definición existente. Separe la descripción de selección de las instrucciones. Una descripción útil es: «Revise cambios de checkout para detectar regresiones de cálculo y casos de prueba ausentes». Las instrucciones podrían ser:
Examine el cálculo modificado y sus pruebas. Compruebe cantidades de uno y varias unidades, y cambios involuntarios de interfaz. Para cada hallazgo, indique archivo, comportamiento afectado y prueba sugerida. Si no hay evidencia suficiente, explique qué no pudo verificar. No edite archivos.
Use Custom en el acceso a herramientas para elegir solo las necesarias. Para inspección, omita edición y ejecución de comandos salvo que sean necesarias. Las instrucciones describen el comportamiento; las herramientas y permisos de la sesión principal determinan las acciones disponibles. Un conjunto personalizado no concede más acceso que el agente principal. Elija Save agent, actívelo y pruébelo con un cambio pequeño conocido. Ajuste la descripción si se selecciona para trabajo equivocado, o las instrucciones si faltan evidencias.

Gestione definiciones y alcance

El origen determina qué puede editar. Los agentes personales se pueden editar, duplicar o eliminar. Puede restaurar un agente preestablecido modificado. Un agente de paquete puede dirigirlo a la gestión del paquete. Eliminar una definición personal requiere confirmación y conserva resultados anteriores. Desactivarla controla su disponibilidad sin borrar el trabajo pasado de la conversación. Los roles no crean copias Git independientes. Si varias tareas deben editar a la vez, use worktrees separados. Para procedimientos reutilizables sin otro rol, consulte skills y plugins.