Scripts Personalizados e Agente da Loja
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
- Abra Loja → Scripts Personalizados.
- Selecione Adicionar Script.
- Digite um Nome do Script claro e Código JavaScript confiável.
- Deixe o script ativado apenas se ele deve ser executado na loja.
- Revise todas as outras linhas porque Salvar Alterações aplica a lista inteira.
- Selecione Salvar Alterações e aguarde Salvo.
- 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
- Abra Loja → Agente.
- Revise as Habilidades ativas no momento.
- Selecione Adicionar Habilidade e escolha uma Habilidade disponível ou Criar skill personalizada….
- Aguarde a mensagem de sucesso e confirme que a Habilidade aparece.
- Use Desativar quando uma Habilidade configurável deve parar de se aplicar a este projeto.
- 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.