DocumentaçãoPersonalização do Agent
Criar, Importar e Gerenciar Habilidades
Crie uma Habilidade personalizada, importe uma Habilidade compatível e edite ou exclua-a com segurança mais tarde.
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
- Criar: Centro de controle → Agente → Habilidades → Descobrir → Criar habilidade
- Importar: Centro de controle → Agente → Habilidades → Descobrir → Importar
- Editar ou excluir: Centro de controle → Agente → Habilidades → Adicionadas → 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. | O Runner usa este conteúdo quando a Habilidade é invocada. |
| Categoria | Agrupa Habilidades relacionadas. | Este rótulo opcional afeta como as Habilidades são organizadas. |
| Rótulo de Atalho | Dá à Habilidade um rótulo de comando mais claro. | O rótulo opcional aparece com controles orientados por comando. |
| Ativado | Escolhe se a Habilidade nova ou editada inicia ativa. | Desativá-la salva a Habilidade em estado pausado. |
| 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. |
| Ação salvar/criar | Persista uma Habilidade válida. | O Runner fecha o editor após o sucesso e atualiza a lista de Habilidades. |
Crie uma Habilidade personalizada
- Abra Agent → Habilidades.
- Em Discover, selecione Criar habilidade.
- Digite um Nome válido, uma Descrição concisa e o Conteúdo da Habilidade. Esses campos são obrigatórios.
- Adicione uma categoria, rótulo de atalho, dica de argumento ou arquivos de suporte apenas quando tornarem a Habilidade mais fácil de usar.
- Revise Ativado, Desabilitar Invocação Automática de IA e Invocável pelo Usuário. Esses controles alteram como o Runner pode usar a Habilidade.
- Selecione a ação salvar/criar.
- Confirme que a Habilidade aparece em Adicionado ou Pausado, dependendo da configuração Ativado.
Importe uma Habilidade
- Em Agent → Habilidades → Discover, selecione Importar.
- 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 salve.
- 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 que você precisa e salve.
- Para parar de usá-la sem perdê-la, selecione Adicionado para movê-la para Pausado.
- Para removê-la, abra Mais ações → Excluir.
- Revise o diálogo de confirmação nomeado e selecione Delete 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 Adicionado, verifique Pausado antes de recriá-la.
- Se a exclusão falhar, a Habilidade permanece; feche o erro e tente novamente após verificar suas permissões.