---
title: Scripts Personalizados e Agente da Loja
description: Adicione JavaScript da loja e escolha quais Habilidades estão disponíveis em um projeto de loja.
---

Scripts Personalizados alteram o comportamento da loja, enquanto Agente da Loja altera quais Habilidades o Runner pode usar para o projeto atual. Ambas são configurações específicas da loja e devem ser revisadas com cuidado extra.

## O que este guia cobre

Você será capaz de adicionar e salvar um script, pausá-lo sem deletá-lo e adicionar ou desativar uma Habilidade apenas para o projeto atual.

## Disponibilidade e pré-requisitos

- Abra Configurações de dentro do projeto pretendido.
- JavaScript personalizado pode alterar o comportamento da loja. Adicione apenas código que você entenda e confie.
- As ações de Habilidade dependem das Habilidades de espaço de trabalho disponíveis e se uma System Habilidade é configurável.
- A página completa do Agente e o portão de plano ainda controlam a disponibilidade mais ampla de Habilidade.

## Caminhos de entrada

- Scripts: **avatar → Configurações → Loja → Scripts Personalizados**
- Habilidades do Projeto: **avatar → Configurações → Loja → Agente**

## Controles de Scripts Personalizados

| Entrada ou botão | Por que é útil | O que acontece a seguir |
| --- | --- | --- |
| **Adicionar Script** | Criar uma entrada de script da loja. | Uma nova linha de Script ativada abre com Código JavaScript vazio. |
| Linha de script | Expanda ou recolha seu editor. | **Nome do Script** e **Código JavaScript** ficam visíveis. |
| Ícone de olho / olho oculto | Ative ou desative um script. | A linha local muda de estado; selecione Salvar Alterações para aplicá-lo. |
| Ícone de exclusão | Remova um script da lista pendente. | A linha desaparece sem um segundo diálogo; Salvar Alterações aplica a remoção. |
| **Salvar Alterações** | Aplique cada edição de script pendente. | O Runner salva a lista de scripts completa e mostra uma mensagem de sucesso ou erro. |

O Runner permite até dez entradas de script. O botão Salvar Alterações permanece desativado quando nada mudou.

## Adicionar ou alterar um script

1. Abra **Loja → Scripts Personalizados**.
2. Selecione **Adicionar Script**.
3. Digite um **Nome do Script** claro e **Código JavaScript** confiável.
4. Deixe o script ativado apenas se ele deve ser executado na loja.
5. Revise todas as outras linhas porque **Salvar Alterações** aplica a lista inteira.
6. Selecione **Salvar Alterações** e aguarde **Salvo**.
7. Verifique a loja com segurança após salvar.

O Runner tenta evitar que um erro de script quebre a página, mas isso não torna código desconhecido seguro. Um script ainda pode afetar privacidade, desempenho, rastreamento e experiência do cliente.

## Controles do Agente da Loja

| Entrada ou botão | Por que é útil | O que acontece a seguir |
| --- | --- | --- |
| Linha de Habilidade ativa | Veja qual Habilidade está disponível neste projeto. | A linha mostra nome, descrição e tipo System ou Custom. |
| **Desativar** | Remova uma Habilidade configurável apenas deste projeto. | A Habilidade sai da lista ativa deste projeto; não é globalmente deletada. |
| **Adicionar Habilidade** | Adicione uma Habilidade de espaço de trabalho disponível a este projeto. | Selecionar uma Habilidade listada a ativa para o projeto atual. |
| **Criar skill personalizada…** | Crie uma nova capacidade personalizada. | O editor de Habilidade abre, depois a lista de projetos é atualizada após o sucesso. |

## Configurar Habilidades do Projeto

1. Abra **Loja → Agente**.
2. Revise as Habilidades ativas no momento.
3. Selecione **Adicionar Habilidade** e escolha uma Habilidade disponível ou **Criar skill personalizada…**.
4. Aguarde a mensagem de sucesso e confirme que a Habilidade aparece.
5. Use **Desativar** quando uma Habilidade configurável deve parar de se aplicar a este projeto.
6. Abra **Centro de Controle → Agente** para detalhes completos de Habilidade, ações de pausa, edição, importação ou exclusão.

## Estados e limites

- As alterações de script permanecem locais até que **Salvar Alterações** tenha sucesso.
- Remover uma linha de script não tem confirmação separada antes de Salvar Alterações.
- Atingir dez scripts desativa **Adicionar Script**.
- O Agente da Loja pode mostrar carregamento, um erro, **Nenhuma skill ativada** ou a lista ativa.
- System Habilidades fixas não mostram **Desativar**.
- Desativar no Agente da Loja altera o escopo deste projeto; não deleta ou pausa globalmente a Habilidade.

## Solução de problemas

- Se um script ainda for executado, confirme seu estado desativado foi seguido por **Salvar Alterações**.
- Se Salvar falhar, a lista salva anteriormente permanece inalterada; corrija o código ou tente novamente após o erro.
- Se **Adicionar Habilidade** não tiver entrada esperada, verifique a página completa do Agente e o plano atual.
- Se **Desativar** estiver ausente, a System Habilidade não é configurável para este projeto.
- Se uma nova Habilidade aparecer globalmente mas não aqui, adicione-a ao projeto a partir do Agente da Loja.

## Guias relacionados

- [Loja Geral](./store-general)
- [Habilidades do Agent](../agent/skills)
- [Criar, importar e gerenciar Habilidades](../agent/create-import-manage-skills)
- [Segurança de chave de API](./api-keys)