---
title: Customização do Agent
description: Adicione Habilidades reutilizáveis e Memória confiável para que o Runner possa trabalhar de uma forma que se adeque à sua loja.
---

A página **Agent Customization** do Runner traz Habilidades e Memória para um único lugar pesquisável. Use-a quando quiser que o Runner repita um método útil, lembre-se de um fato estável ou pare de usar um recurso que você não precisa mais.

## O que este guia cobre

Você saberá como abrir Agent Customization, encontrar um recurso existente e escolher se uma Habilidade ou Memória é a ferramenta certa.

## Disponibilidade e pré-requisitos

- Você precisa de acesso a um projeto de loja.
- Habilidades podem depender do seu plano atual. Se seu plano não incluir Habilidades, o Runner mostra o caminho de atualização disponível em vez de ativar a ação.
- Memória aparece apenas quando o recurso de Memória unificada está ativado para sua conta.
- Links antigos de **Habilidades**, **Memória** e **Customize** redirecionam para esta página do Agent.

## Abra Agent Customization

De um projeto, abra **Centro de controle → Agente**.

![Página de Habilidades do Agente](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgMN6p3Ta4kBHzfjRG8M5Ywdv1hEVDJx43X2bU)

## Controles principais

| Entrada ou botão | Por que é útil | O que acontece a seguir |
| --- | --- | --- |
| **Pesquise skills, memory…** | Encontre um recurso sem verificar cada seção. | A página filtra Habilidades e Memória correspondentes. O botão limpar restaura a lista completa. |
| Aba com o rótulo em inglês **All** | Revise tudo disponível para a página do Agent. | O Runner mostra a área de Habilidades e, quando ativado, Memória. |
| Aba com o rótulo em inglês **Skills** | Concentre-se em instruções e habilidades reutilizáveis. | O Runner mostra Habilidades recomendadas, adicionadas, pausadas e descobríveis. |
| Aba com o rótulo em inglês **Memory** | Concentre-se em fatos que o Runner deve reter. | O Runner mostra memórias agrupadas por escopo. Esta aba está oculta quando Memória não está disponível. |
| **Adicionar** | Instale ou reative uma Habilidade. | A Habilidade se move para **Adicionado** após o Runner concluir a ação. |
| **Adicionado** | Veja que uma Habilidade está ativa. | Para Habilidades configuráveis, selecioná-la pausa essa Habilidade. |
| **Importar** | Traga uma Habilidade compatível de uma URL. | O Runner verifica a fonte e abre uma importação editável ou um seletor multi-Habilidade. |
| **Criar Habilidade** | Escreva uma instrução reutilizável personalizada. | O editor de Habilidade abre. Os campos obrigatórios devem estar completos antes de poderem ser salvos. |
| **Adicionar uma memória** | Salve um fato estável ou preferência. | O diálogo **Nova memória** abre. |

## Escolha entre uma Habilidade e Memória

1. Use uma **Habilidade** quando o Runner deve seguir um processo repetível, formato ou conjunto de instruções.
2. Use **Memória** quando o Runner deve reter um fato conciso, preferência, correção, convenção ou decisão.
3. Mantenha segredos fora de ambos. Nunca armazene senhas, chaves de API, detalhes de pagamento ou credenciais privadas.
4. Retorne à aba em inglês **All** e pesquise um termo para confirmar que o novo item aparece.

## Estados e limites

- **Recomendado para você** mostra um pequeno conjunto de Habilidades em tendência.
- **Adicionado** contém Habilidades ativas; **Pausado** contém Habilidades inativas.
- **Discover** pode mostrar linhas de carregamento, resultados de pesquisa ou uma mensagem sem resultados.
- Uma Habilidade de Sistema pode ser somente visualização ou fixa. Uma Habilidade Personalizada pode oferecer ações de edição e exclusão.
- Uma área de Memória vazia oferece **Adicionar uma memória**. Uma pesquisa sem correspondência oferece **Limpar pesquisa** sem excluir nada.
- Estados de carregamento, plano e indisponibilidade não significam que um recurso foi adicionado.

## Solução de problemas

- Se a aba em inglês **Memory** estiver faltando, o recurso não está ativado para a conta atual. Continue usando Habilidades ou verifique novamente na navegação visível mais tarde.
- Se **Adicionar** abrir uma tela de atualização, compare planos antes de tomar uma decisão de faturamento.
- Se a pesquisa não encontrar nada, limpe a consulta e verifique as abas em inglês **All**, **Skills** e **Memory** separadamente.
- Se uma alteração falhar, mantenha o diálogo aberto, corrija o problema exibido e tente novamente. Não assuma que um toast ou estado de carregamento significa que a alteração foi concluída.

## Guias relacionadas

- [Use e pause Habilidades](./skills.mdx)
- [Criar, importar e gerenciar Habilidades](./create-import-manage-skills.mdx)
- [Adicione e edite Memória](./memory.mdx)
- [Use a paleta de comandos do Agent](./command-palette.mdx)