Criar, Importar e Gerenciar Habilidades
Crie uma Habilidade personalizada, importe uma Habilidade compatível e edite ou exclua-a com segurança mais tarde.
As capturas de tela e as gravações mostram a interface em inglês. Os nomes dos controles podem variar conforme o idioma selecionado.
Habilidades personalizadas permitem que você empacote suas próprias instruções para uso repetido. Importar é útil quando uma Habilidade compatível já existe e você quer revisá-la antes de adicioná-la ao Runner.
O que este guia cobre
Você saberá como criar ou importar uma Habilidade, entender cada controle do editor e distinguir pausa reversível de exclusão permanente.
Disponibilidade e pré-requisitos
- Abra um projeto com acesso a Agent → Habilidades.
- Habilidades exigem acesso ao plano.
- Importar exige uma URL de fonte compatível que o Runner possa ler.
- Não importe instruções em que você não confia. Revise o nome, descrição, conteúdo, configurações e arquivos inclusos antes de salvar.
Caminhos de entrada
- Crie: Barra lateral Agente → filtro Habilidades → Criar habilidade na seção Descobrir.
- Importar: Barra lateral Agente → Filtro Habilidades → Importar em Discover.
- Edite ou exclua: Barra lateral Agente → Filtro de Habilidades → uma linha em Adicionada → Mais ações.
Controles do editor de Habilidade
| Entrada ou botão | Por que é útil | O que acontece a seguir |
|---|---|---|
| Nome | Dá à Habilidade sua identidade em listas e comandos. | O Runner valida que um nome está presente antes de salvar. |
| Descrição | Explica quando a Habilidade deve ser usada. | A descrição aparece em listas e seletores de Habilidade. |
| Conteúdo | Armazena as instruções reutilizáveis. | Escreva no Editar e use o Visualização para verificar as instruções formatadas. |
| Configuração avançada | Revela configurações opcionais de invocação e organização. | Expanda-o apenas quando precisar alterar essas configurações. |
| Mudar para Markdown / Mudar para formulário | Altera a forma como você edita a habilidade. | Abre o Markdown ou editor baseado em campo; alternar visualizações não salva a habilidade. |
| Categoria | Agrupa Habilidades relacionadas. | Este rótulo opcional afeta como as Habilidades são organizadas. |
| Rótulo do atalho | Dá à Habilidade um rótulo de comando mais claro. | O rótulo opcional aparece com controles orientados por comando. |
| Habilitado | Escolhe se a habilidade nova ou editada começa ativa. | Começa para uma nova habilidade. Desligue-o antes de criar a habilidade se ela começar em pausa. |
| Desabilitar Invocação Automática de IA | Impede que o Runner escolha a Habilidade automaticamente. | A Habilidade permanece disponível para uso manual. |
| Invocável pelo Usuário | Permite uso manual de comando de barra. | Desativá-lo remove a invocação manual mantendo outro uso permitido. |
| Dica de Argumento | Mostra a entrada esperada após um comando. | A dica pode exibir exemplos como uma URL ou número de problema. |
| Área de arquivos | Adicione texto de suporte ou ativos necessários pela Habilidade. | O Runner valida limites de arquivo individual e total antes de salvar. |
| Cancelar | Saia sem aplicar a edição atual. | O diálogo fecha; as alterações não salvas são descartadas. |
| Criar / Salvar | Persistir uma habilidade válida. | Runner fecha o editor após sucesso e atualiza a lista de habilidades. |
Crie uma Habilidade personalizada
- Abra a barra lateral Agente e selecione o filtro Habilidades.
- Em Discover, selecione Criar habilidade.
- Insira um Nome hifenizado e minúsculo, como
homepage-copy-review, uma Descrição concisa e a Habilidade Conteúdo. Esses campos são obrigatórios. - Selecione Visualização em Conteúdo para conferir as instruções. Expanda Configuração avançada para configurações opcionais somente quando você precisar delas.
- Revise Habilitado e quaisquer configurações de invocação avançada que você alterou. Esses controles determinam como Runner pode usar a habilidade.
- Selecione Criar.
- Confirme que a Habilidade aparece em Adicionada ou Em pausa, dependendo da configuração Ativado.
As anotações em inglês indicam os controles. Selecione a imagem para ampliá-la.
Este exemplo mostra instruções antes de Criar. O rascunho não foi salvo.
Assista: revise um rascunho de habilidade
A gravação alterna o exemplo entre Markdown e visualização do formulário e depois é cancelada. Para manter sua própria habilidade, selecione Criar e confirme se ela aparece na lista.
Importe uma Habilidade
- Abra o Agente, selecione o filtro Habilidades e encontre Importar no Discover.
- Cole a URL de fonte compatível.
- Selecione Importar.
- Para uma Habilidade descoberta, o Runner abre o editor com campos importados preenchidos. Para uma fonte contendo várias Habilidades, o Runner abre um seletor.
- Revise cada campo importado e qualquer aviso de arquivo excluído ou tamanho.
- Faça as alterações necessárias e selecione Criar.
- Confirme que a Habilidade aparece na página do Agent antes de fechar seu fluxo de trabalho.
Importar não torna conteúdo não revisado confiável. Trate instruções importadas como qualquer outro conteúdo que possa influenciar o trabalho do Runner.
Editar, pausar ou excluir
- Selecione uma linha de Habilidade Personalizada ou abra Mais ações → Editar.
- Altere os campos necessários e selecione Salvar. Reabra a habilidade para confirmar as instruções atualizadas.
- Para parar de usá-la sem perdê-la, selecione Adicionada para movê-la para Em pausa.
- Para removê-la, abra Mais ações → Excluir.
- Revise o diálogo de confirmação nomeado e selecione Excluir apenas quando você pretender remover a Habilidade.
Excluir é destrutivo. Não é o mesmo que pausar, e a página não o apresenta como uma ação desfeita. System Habilidades não oferecem exclusão.
Estados e limites
- Nome, Descrição ou Conteúdo ausentes bloqueiam o salvamento e mostram uma mensagem de validação.
- Um nome de Habilidade importada duplicado pode ser rejeitado ou marcado como já presente.
- Arquivos que excedem limites aceitos podem ser ignorados; um aviso de tamanho total pode bloquear o salvamento até que o conteúdo seja reduzido.
- Enquanto salvamento, importação ou exclusão está em execução, aguarde a mensagem de sucesso ou erro antes de tomar outra ação.
- Ver Habilidades de Sistema apenas podem mostrar detalhes mas não expõem controles de edição de Habilidade Personalizada.
Solução de problemas
- Se Importar permanecer indisponível, aguarde a verificação de Habilidade existente ser concluída e confirme que o campo URL não está vazio.
- Se a importação abrir um seletor em lote, selecione apenas as Habilidades que você reconhece e precisa.
- Se o salvamento estiver bloqueado, verifique os campos obrigatórios e qualquer aviso de arquivo no topo do editor.
- Se uma Habilidade desapareceu após selecionar Adicionada, verifique Em pausa antes de recriá-la.
- Se a exclusão falhar, a Habilidade permanece; feche o erro e tente novamente após verificar suas permissões.