Integração com o Slack#
Liga o Slack à Ultralytics Platform para saberes quando uma tarefa de longa duração termina sem manter a Platform aberta. Escolhes um canal do Slack e os resultados importantes para o teu workspace.
Não precisas de uma chave de API do Slack, de um webhook nem de configuração técnica. Antes de começares, inicia sessão no Slack e decide qual canal deve receber os alertas da Platform. Se usares um workspace de equipa na Platform, tens de ser administrador ou proprietário do workspace.
Ligar o Slack#
- Abre Definições > Integrações e seleciona Slack na lista de integrações.
- Revê o resumo da configuração e clica em Continuar para o Slack.
- Escolhe um canal e clica em Permitir. A Platform solicita permissão para publicar apenas nesse canal. Se o Slack mostrar Solicitar aprovação, envia o pedido e pede ao administrador do teu workspace do Slack para aprovar a aplicação.
- Depois de voltares à Platform, escolhe os alertas que queres e clica em Guardar alertas. Treino concluído e Treino falhou estão selecionados inicialmente.
A Platform publica uma confirmação no canal selecionado assim que a ligação é estabelecida com sucesso. A integração mostra depois a que workspace e canal do Slack está ligada. Os administradores do workspace gerem a ligação e as opções de alertas para todo o workspace a partir do separador Integrações.
O Slack permite que a Platform publique mensagens no canal que escolheres. A Platform não pode ler as tuas mensagens do Slack nem publicar noutros canais através desta ligação.
Alertas disponíveis#
| Alerta | Quando é enviado |
|---|---|
| Treino concluído | Um modelo termina o treino |
| Treino falhou | Uma execução de treino é interrompida com um erro |
| Exportação concluída | Uma exportação do modelo está pronta |
| Exportação falhou | Uma exportação do modelo é interrompida com um erro |
| Implementação pronta | Uma implementação está pronta |
| Implementação falhou | Uma implementação não consegue iniciar |
Cada mensagem indica o que foi concluído e inclui uma ligação direta para o modelo ou a implementação relacionada na Platform. Os alertas de treino incluem o nome do conjunto de dados, a métrica principal do modelo, a duração da execução e o respetivo custo; os alertas de exportação incluem o formato e o tamanho do ficheiro. Os alertas de tarefas falhadas incluem um breve resumo do erro quando disponível, como nota incorporada ou bloco de código para mensagens mais longas. A entrega pelo Slack não altera o resultado do treino, da exportação ou da implementação. Consulta o resultado atual na página de treino ou de exportação do modelo, ou na página Implementações.
Mensagens de Fluxo de Trabalho de Agentes#
Usa um bloco do Slack em Agents para enviar uma mensagem quando uma condição de fluxo de trabalho corresponder. Ele usa o mesmo canal conectado. Configura a mensagem no bloco e inclui {output} para o resultado a montante. Estas mensagens são separadas das escolhas de notificação de trabalho acima.
Alterar ou desligar o Slack#
Para alterares os resultados publicados, seleciona ou desmarca os alertas e clica em Guardar alertas. Tem de permanecer selecionado pelo menos um alerta.
Para usares um canal diferente, clica em Desligar, liga novamente o Slack e escolhe o novo canal. Desligar interrompe imediatamente todos os alertas do Slack e não afeta as tarefas nem os recursos da Platform.
Resolução de problemas#
- A integração do Slack indica que um administrador tem de a ligar: pede a um administrador ou proprietário do workspace da Platform para concluir a ligação.
- O Slack mostra Solicitar aprovação em vez de Permitir: envia o pedido e pede ao administrador do teu workspace do Slack para aprovar a aplicação. Não precisas de criar uma chave de API nem um webhook.
- O teu workspace ou canal do Slack não aparece: confirma que tens sessão iniciada no workspace correto do Slack e que podes adicionar aplicações ao canal.
- A ligação funcionou, mas os alertas pararam: liga novamente o Slack para atualizar a permissão do canal. Isto é normalmente necessário se a permissão da aplicação tiver sido revogada ou se o canal tiver sido removido.
- Uma tarefa terminou sem uma mensagem do Slack: verifica os alertas selecionados em Definições > Integrações e, em seguida, abre o modelo ou a implementação relacionada na Platform. Os alertas do Slack são informativos e nunca controlam o processamento das tarefas.
Volta à visão geral das integrações da Platform para ligares dados, armazenamento ou serviços On Premise.
Perguntas frequentes#
Não. Conectar o Slack é um fluxo OAuth: clica em Continue to Slack, escolhe um canal e clica em Allow. A Platform recebe apenas permissão para publicar nesse único canal.
Cada espaço de trabalho conecta-se a um único canal. Para mudar de canal, desconecta o Slack e conecta novamente com o novo canal selecionado.
Num espaço de trabalho de equipa, o administrador ou o proprietário role gere a conexão e a seleção de alertas para todos. Os alertas estão disponíveis em todos os planos.
Verifica se o alerta correspondente está selecionado em Settings > Integrations e reconecta o Slack se a permissão da aplicação tiver sido revogada ou se o canal tiver sido removido. Os alertas são apenas informativos e nunca afetam o treino, a exportação ou a implementação em si.