> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mka1.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agentes especializados

> Use agentes para investigar o revisar y defina roles reutilizables con herramientas e instrucciones propias.

export const ScreenshotCrop = ({src, alt, width, height, x = 0, y = 0, cropWidth = width, cropHeight = height, maxWidth = "100%"}) => <div className="not-prose" style={{
  position: "relative",
  overflow: "hidden",
  width: "100%",
  maxWidth,
  margin: "0 auto",
  aspectRatio: `${cropWidth} / ${cropHeight}`
}}>
    <img src={src} alt={alt} width={width} height={height} style={{
  position: "absolute",
  display: "block",
  margin: 0,
  maxWidth: "none",
  width: `${width / cropWidth * 100}%`,
  height: "auto",
  left: `${-x / cropWidth * 100}%`,
  top: `${-y / cropHeight * 100}%`
}} />
  </div>;

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](/es/docs/mka1-code/review-changes) en el flujo principal.

<Frame caption="Los roles de agente disponibles definen una tarea, una selección de modelo y un conjunto de herramientas.">
  <ScreenshotCrop src="/images/mka1-code/guides/agents.jpg" alt="Tarjetas de agentes de revisión, pruebas e implementación" width={2720} height={1660} x={860} y={315} cropWidth={715} cropHeight={685} maxWidth="520px" />
</Frame>

## Cree un rol reutilizable

Elija **New agent** en **Settings → Agents** o duplique una definición existente.

| Campo | Uso |
| - | - |
| Nombre | Identificador en minúsculas, como `checkout-review`, con letras, números y palabras separadas por guiones. |
| Descripción | Cuándo debe seleccionarse el agente. |
| Modelo | Heredar el modelo principal o elegir uno de la cuenta. |
| Esfuerzo de razonamiento | Heredar o seleccionar un nivel compatible cuando se ofrezca. |
| Acceso a herramientas | Heredar las permitidas o elegir un subconjunto. |
| Instrucciones | Rol, evidencia esperada y límites. |
| Límites avanzados | Número de turnos y tiempo máximo de la tarea delegada. |

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](/es/docs/mka1-code/workspaces). Para procedimientos reutilizables sin otro rol, consulte [skills y plugins](/es/docs/mka1-code/extensions).