Saltar para o conteúdo principal
No Kolmena, um job indica a um agente que execute uma tarefa segundo um agendamento e entregue o resultado num chat ou canal. Pode configurar jobs únicos ou recorrentes, alterá-los mais tarde e rever cada execução. Esta página mostra como criar um job, escolher um agendamento, gerir o seu estado e retomá-lo após uma paragem automática.

Antes de começar

Confirme que o agente que quer agendar está criado e publicado. Os jobs mantêm-se em todas as versões publicadas desse agente, pelo que as atualizações do agente não estragam os agendamentos existentes.
Pode ter até 25 jobs ativos ou em pausa ao mesmo tempo. Se atingir o limite, elimine um job antigo antes de adicionar um novo.

Criar um novo job

1

Abra o painel Jobs

Aceda ao agente que quer agendar, selecione Configure e abra o separador Jobs.
2

Comece um novo job

Clique em New Job. Introduza um Name e descreva a Task em linguagem simples, para que o agente saiba o que fazer em cada execução.
3

Escolha um acionador

Escolha Schedule como tipo de acionador. Também pode acionar jobs a partir de aplicações ligadas quando ocorrem eventos.
4

Defina o agendamento

Selecione uma frequência: One Time, Hourly, Daily, Weekly, Monthly ou Custom.
  • Nos jobs de hora a hora, pode definir um intervalo horário e os minutos específicos de cada hora.
  • Nos jobs diários, pode excluir dias específicos.
  • O intervalo mínimo permitido é de 15 minutos.
5

Escolha o destino

Decida para onde vão os resultados:
  • New chat for this job: cria um chat dedicado.
  • Um chat existente: envia os resultados para um chat que já tem com o agente.
  • Job runs only (no chat): guarda os resultados sem os enviar para um chat.
6

Defina o tipo de resultado

Escolha se o agente deve produzir A reply in the chat ou A file, dashboard, or app. Se escolher um ficheiro, dashboard ou aplicação, cada execução tem de o criar; uma execução sem ele conta como falhada.
7

Guarde o job

Clique em Add Job. Vai ver uma confirmação de que o job foi adicionado, e o agente é iniciado, se necessário.

Editar, pausar ou retomar um job

Pode alterar um job depois de o criar. Abra o painel Jobs, encontre o job e clique nele para editar o nome, a tarefa, o agendamento ou o destino. Clique no interruptor para pausar ou retomar um job. Os jobs em pausa mantêm o histórico, mas não são executados até os voltar a ativar.
Se um job falhar cinco execuções seguidas, para automaticamente e mostra Needs attention. Corrija a causa (por exemplo, volte a ligar uma aplicação ou escolha um destino válido) e, depois, clique em Resume para o iniciar novamente.

Executar um job a pedido

Para testar um agendamento ou voltar a executar uma tarefa de imediato, clique em Run now num job ativo cujo agente esteja iniciado. A execução aparece logo no histórico do job.

Ver o histórico de execuções

Clique em View runs em qualquer job para abrir o histórico. Pode ver: Selecione uma execução para ler a transcrição do agente e as mensagens que produziu. Se a execução falhou, o erro explica porquê (por exemplo, destino indisponível, agente parado ou orçamento esgotado).

Eliminar um job

Abra o menu do job e escolha Delete. O job e o respetivo histórico de execuções são removidos. Os chats criados para o job ficam na sua lista de conversas.

Próximos passos

Visão geral dos jobs

Saiba como funcionam os jobs, os agendamentos e os acionadores.

Ligar aplicações

Ligue aplicações para usar acionadores por evento.

Versões e publicação

Veja como as versões do agente afetam os seus jobs.