Como usar o HagiTask
Para quem é este guia: Usuários que já instalaram o HagiCode e precisam gerenciar ou executar tarefas.
Pré-requisitos: Ter concluído Como instalar o HagiTask ou ter predefinições integradas disponíveis no aplicativo.
Descobrir tarefas
Abra a interface de gerenciamento de tarefas do HagiTask ou da comunidade no aplicativo. Ela reúne predefinições integradas, pacotes da comunidade instalados, pacotes do espaço de trabalho e fontes gerenciadas, identificando a origem de cada tarefa e se ela pode ser removida. O catálogo da Community Gallery serve para descobrir e obter pacotes da comunidade; os diretórios acessíveis ao servidor servem para descobrir fontes de tarefas no ambiente de execução.
Instalar tarefas
Selecione e instale uma tarefa da Gallery ou use a instalação de um ZIP local aceito que você já tenha obtido. Após a instalação, o aplicativo registra o ID canônico, a versão, o publicador, a origem, o resumo do arquivo e o diretório de instalação. Uma tarefa instalada com o mesmo ID não será substituída sem aviso; é preciso resolver a instalação existente primeiro.
Ativar e desativar
- Ativar: Coloca uma tarefa instalada no catálogo ativo, permitindo que seja descoberta e executada.
- Desativar: Mantém o registro de instalação e os arquivos do pacote, mas retira a tarefa do catálogo ativo para que não seja executada.
- Desinstalar: Disponível apenas para tarefas da comunidade com registro de instalação; tarefas integradas são informativas e não podem ser desinstaladas.
Depois de alterar o estado, o aplicativo atualiza o catálogo. Se a atualização falhar, a operação de ciclo de vida deve preservar o estado funcional anterior, sem deixar um catálogo parcialmente atualizado.
Atualizar o catálogo e executar tarefas
Use a ação de atualizar para ler novamente o catálogo atual. Ao forçar a atualização do catálogo da Gallery, o aplicativo faz uma nova consulta e valida os dados; um cache válido pode continuar disponível caso a fonte remota falhe temporariamente. Atualizar o catálogo não muda automaticamente o estado de ativação nem a versão das tarefas.
Antes de executar, confirme que a tarefa está ativada e que suas dependências estão disponíveis. Em seguida, execute-a pelo painel da tarefa ou pelo ponto de entrada correspondente. Se ela não aparecer, atualize o catálogo e verifique o estado da instalação, o ID da tarefa e os avisos de compatibilidade. Se o Schema ou os recursos do pacote forem inválidos, consulte o guia de contribuição da comunidade.
Gerenciamento de pacotes e de fontes do servidor
Estas duas operações costumam ser confundidas:
| Recurso | Finalidade | Significado do caminho |
|---|---|---|
| Gerenciamento de pacotes | Instalar, ativar, desativar e desinstalar pacotes locais do HagiTask. | Diretório de dados gerenciado pelo aplicativo. |
| Gerenciamento de fontes do servidor | Configurar fontes de tarefas que o ambiente de execução usa para descobrir tarefas no catálogo. | Deve ser um diretório acessível ao servidor. |
O backend lê o caminho configurado como fonte do servidor para descobrir pacotes de tarefas naquele diretório; não se trata de um caminho do navegador nem de um controle de envio de arquivos. O fluxo atual de instalação não envia uma pasta local do navegador diretamente como pacote da Community Gallery. Para instalar, use a Gallery ou o fluxo aceito de ZIP local.
Quando uma tarefa não está disponível
- Confirme que o ID, a versão e o registro de instalação da tarefa ainda existem.
- Confirme que ela está ativada e que os agentes, skills e ferramentas de CLI necessários estão disponíveis.
- Atualize o catálogo de tarefas e reabra a interface de gerenciamento.
- Se a origem for um diretório no servidor, confirme que o processo de backend tem permissão de leitura no caminho.
- Se a verificação do arquivo ou os recursos do pacote falharem, volte à solução de problemas de instalação; se você mantém o pacote, leia Como contribuir com a comunidade.
Próximo passo: Como contribuir com a comunidade ou volte à introdução ao HagiTask.