Rotinas
Uma rotina define quando um Bot deve executar um fluxo de trabalho. Ela pode ser executada em intervalo programado ou quando algo acontece, como uma mensagem no Slack, um evento do GitHub, Linear, Sentry ou PagerDuty, um e-mail ou uma chamada de webhook. As rotinas são executadas na nuvem mesmo com seu laptop fechado.
Como faço para configurar ou alterar uma rotina?
Peça ao Bot no chat. Diga o que ele deve fazer e quando. Por exemplo: "Todo dia útil às 9h, resuma os novos tickets de suporte neste chat." O Bot cria a rotina, que passa a aparecer nas rotinas do Bot.
Para alterar uma rotina no desktop, abra-a e escolha Edit. O Grok Bot inicia uma mensagem para o Bot que começa com "Edite sua rotina:", seguido do nome da rotina. Adicione o que deve mudar e envie.
No celular, abra o perfil do Bot e toque em Add routine, em Routines. O Grok Bot inicia uma mensagem que começa com "Configure uma rotina para ". Complete a frase e envie.
Onde vejo as rotinas de um Bot?
No computador:
- Clique no nome do Bot no topo do chat para abrir os detalhes dele.
- Escolha Tasks. As rotinas ficam em Routines.
Cada linha mostra o nome da rotina e quando ela é executada, ou Paused. Use a chave na linha para pausar ou retomar a rotina. Se o Bot não tiver rotinas, aparecerá Ask in chat to set a routine.
Clique em uma rotina para abri-la:
- Instruction é o que o Bot faz a cada execução.
- When to run lista o agendamento e os eventos que a iniciam.
- Webhook mostra a URL e a chave, no caso de rotinas iniciadas por uma chamada de webhook.
Os botões na parte inferior são Pause ou Resume, Test, Edit e Delete routine (o ícone de lixeira). Antes de excluir, será solicitada uma confirmação. A exclusão interrompe as execuções futuras e não pode ser desfeita.
No celular, abra o perfil do Bot e procure Routines. Toque em uma rotina para ver Active, Schedule, Next run, Instruction e Run history. Desative Active para pausar a rotina. Para excluir uma rotina, deslize a linha dela.
Como funcionam os agendamentos e os fusos horários?
Os agendamentos usam o fuso horário definido em Settings, na seção Bot, no campo Timezone. Auto-detect segue este computador. Escolha um fuso quando a rotina precisar seguir outro, como o do escritório a que o trabalho pertence.
Descreva o agendamento com palavras simples, como "todo dia útil às 8:00" ou "a cada 2 horas". Depois, abra a rotina e confira When to run. Esse campo mostra o agendamento salvo por extenso, para você confirmar se ele corresponde ao que queria. Se não corresponder, escolha Edit e diga ao Bot o que corrigir.
Uma nova rotina aguarda o próximo horário agendado. Ela não é executada ao ser criada. Se você configurar "todos os dias às 8:00" às 8:05, a primeira execução será amanhã às 8:00. Para testá-la na hora, use Test.
Como faço para testar uma rotina?
Abra a rotina no desktop e escolha Test. O botão exibe Running… até o fim da execução. O resultado aparece no chat do Bot.
Um teste realiza trabalho real: ele pode alterar arquivos e usar plugins conectados. Por isso, use uma entrada segura. Se não for possível iniciar o teste, você verá Couldn't start a test run ou uma mensagem explicando o motivo.
Algumas rotinas não exibem Test. Mesmo assim, elas continuam sendo executadas conforme o agendamento ou o gatilho.
O que devo alterar se o uso cair rapidamente?
Comece pela frequência com que suas rotinas são executadas. Cada execução consome uso, então uma rotina executada com frequência gasta mais do que uma executada raramente. Um agendamento de hora em hora, um intervalo curto ou um gatilho do Slack em um canal movimentado podem consumir uma semana de uso em um único dia.
Se o Uso semanal estiver caindo mais rápido do que o esperado, pause as rotinas de que você não precisa. Depois, peça ao Bot para ampliar os intervalos dos agendamentos e restringir os gatilhos do Slack antes de subir de plano ou aumentar um limite on-demand. Uma rotina que nunca é executada não consome uso. Já um Test consome, porque realiza o trabalho.
Consulte Planos e faturamento para saber mais sobre o uso semanal e o limite mensal on-demand.
Como funcionam os gatilhos do Slack?
Um gatilho do Slack faz parte de uma rotina, não do plugin do Slack. O plugin permite que um Bot publique e leia mensagens como o usuário do Slack que você conectou. Já o gatilho inicia a rotina quando algo acontece no Slack. Conecte o Slack na conta do Cherri Code à qual o Bot pertence antes de contar com ele. Veja Conectar plugin.
Peça ao Bot o gatilho que você quer. Uma rotina pode ser iniciada quando o Bot é mencionado, quando uma palavra ou frase é mencionada, quando você reage a uma mensagem ou a cada mensagem. Ela pode monitorar um canal específico ou todo o Slack. When to run descreve o gatilho em palavras, como uma frase e um canal.
Defina o canal e a frase de forma bem específica. Um gatilho para qualquer mensagem em um canal movimentado é executado com frequência e consome uso com mensagens que não precisam do Bot. Apenas atividades novas contam. Mensagens anteriores à criação do gatilho não iniciam uma execução.
Onde ficam a URL e a chave do webhook, e o que significa um 200?
Peça ao Bot para adicionar um gatilho de webhook à rotina. Em seguida, abra a rotina no desktop. A seção Webhook mostra três campos:
- POST to é a URL.
- chave é o secret. Os remetentes o enviam como
Authorization: Bearer <key>. - header é esse header completo, pronto para copiar.
Clique em um campo para copiá-lo. Envie um HTTP POST para essa URL com o header. Você pode enviar um body JSON. O Bot recebe esse body junto com a instrução da rotina.
Uma resposta 200 significa que o Grok Bot aceitou a chamada e iniciou uma execução. Isso não quer dizer que o Bot concluiu a instrução. Consulte o chat do Bot para ver o resultado. Qualquer outra resposta indica que nenhuma execução foi iniciada. Confirme que a rotina não está pausada e que a solicitação usa a chave atual.
Por que minha rotina não foi executada?
Verifique primeiro estes pontos:
- A rotina não está Paused. No celular, Active está ativado.
- When to run mostra o agendamento ou gatilho esperado, no fuso horário correto.
- Um novo agendamento aguarda o próximo horário. Use Test para executá-lo agora.
- No Slack, a mensagem é nova, está no canal monitorado pelo gatilho e corresponde à frase configurada.
- Em um webhook, a chamada retornou 200 e usou a chave atual.
No celular, Run history mostra cada execução recente como Running, Succeeded ou Failed. Uma execução com falha mostra o motivo. No runs yet significa que nada iniciou a rotina até agora.