> ## 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 investigação ou revisão e defina papéis reutilizáveis com ferramentas e instruções próprias.

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>;

Um agente especializado atribui um papel a uma parte da tarefa, como revisar um diff ou investigar um caminho de chamadas. Sua descrição indica quando delegar; suas instruções explicam como trabalhar. Use um papel específico quando o mesmo tipo de investigação ou revisão se repetir.

## Use um agente disponível

Abra **Ajustes → Agentes** para examinar definições predefinidas, pessoais, do projeto e de pacotes. Busque por nome ou descrição, filtre por todos ou ativados e confira o controle de ativação.

Na sessão de Código, digite `@` e selecione o agente nas sugestões. Delimite a tarefa e o resultado:

> Revise a mudança de quantidades do checkout. Confira cálculo, testes e preservação da assinatura pública. Informe problemas concretos com referências a arquivos. Não altere arquivos.

Leia os resultados antes de pedir alterações. Encontrar um teste ausente não o escreve nem o executa. Mantenha [revisão do diff e verificação](/pt/docs/mka1-code/review-changes) no fluxo principal.

<Frame caption="Os papéis de agente disponíveis definem uma tarefa, uma escolha de modelo e um conjunto de ferramentas.">
  <ScreenshotCrop src="/images/mka1-code/guides/pt/agents.jpg" alt="Cartões de agentes de revisão, testes e implementação" width={2720} height={1800} x={760} y={380} cropWidth={855} cropHeight={820} maxWidth="520px" />
</Frame>

## Crie um papel reutilizável

Escolha **Novo agente** em **Ajustes → Agentes** ou duplique uma definição existente.

| Campo | Uso |
| - | - |
| Nome | Identificador em minúsculas, como `checkout-review`, com letras, números e palavras separadas por hífen. |
| Descrição | Quando o agente deve ser selecionado. |
| Modelo | Herdar o modelo principal ou escolher um disponível na conta. |
| Esforço de raciocínio | Herdar ou escolher um nível compatível quando oferecido. |
| Acesso a ferramentas | Herdar as permitidas ou escolher um subconjunto. |
| Instruções | Papel, evidências esperadas e limites. |
| Limites avançados | Quantidade de turnos e tempo máximo da tarefa delegada. |

Separe a descrição de seleção das instruções de trabalho. Uma descrição útil é: “Revise mudanças de checkout para encontrar regressões de cálculo e testes ausentes.” As instruções podem ser:

> Examine o cálculo alterado e seus testes. Confira quantidades de um e de várias unidades, além de mudanças involuntárias de interface. Para cada problema, informe arquivo, comportamento afetado e teste sugerido. Se faltar evidência, explique o que não pôde verificar. Não edite arquivos.

Use o acesso personalizado para selecionar somente as ferramentas necessárias. Para inspeção, omita edição e execução de comandos salvo quando exigidas. Instruções descrevem comportamento; ferramentas e permissões da sessão principal determinam ações disponíveis. Um conjunto personalizado não concede mais acesso que o agente principal.

Salve, ative e teste a definição em uma mudança pequena conhecida. Ajuste a descrição se ela for selecionada para o trabalho errado, ou as instruções se o resultado não trouxer evidências suficientes.

## Gerencie definições e escopo

A origem determina o que pode ser editado. Agentes pessoais podem ser editados, duplicados ou excluídos. Um predefinido alterado pode ser restaurado. Um agente de pacote pode direcionar você ao gerenciamento desse pacote.

Excluir uma definição pessoal exige confirmação e preserva resultados anteriores. Desativar controla a disponibilidade sem apagar o trabalho passado da conversa.

Papéis diferentes não criam cópias Git separadas. Se várias tarefas precisarem editar ao mesmo tempo, use [worktrees separados](/pt/docs/mka1-code/workspaces). Para procedimentos reutilizáveis sem outro papel de agente, consulte [skills e plugins](/pt/docs/mka1-code/extensions).