Automatizar fluxos de trabalho no Agente SRE do Azure

A tua equipa provavelmente tem tarefas recorrentes como verificar o estado do serviço todas as manhãs, rever alertas noturnos, verificar a expiração dos certificados ou publicar relatórios semanais de capacidade. Liga as tuas ferramentas, constrói um fluxo de trabalho e deixa o agente executá-lo num calendário.

O que você realiza

• Ligue uma ferramenta de notificação para que o agente possa enviar mensagens
• Crie um agente personalizado que use essa ferramenta
• Agende um exame de saúde recorrente que seja feito automaticamente
• Veja o fluxo de trabalho completo no Agent Canvas

Pré-requisitos

Como funciona

A automação liga três blocos de construção, cada um configurado através do portal:

No portal, o segundo bloco aparece como Agente Personalizado.

O guia seguinte mostra como criar um relatório matinal de estado enviado por email, mas os mesmos três blocos aplicam-se a outras tarefas recorrentes. Altere as instruções e o calendário para rever alertas noturnos, verificar a validade dos certificados ou publicar um resumo semanal da capacidade. Um relatório semanal enviado para uma lista de distribuição também dá à sua liderança um registo permanente que ninguém tem de compilar à mão.

Adicionar um conector

Os conectores permitem que o agente interaja com serviços externos. Comece com uma ferramenta de notificação para que o seu agente possa reportar as conclusões. Estes passos configuram um conector do Outlook. Relativamente ao Teams, consulte Configurar um conector do Teams.

Duas identidades são abrangidas antes de começar. O seu login autoriza o agente a agir no Outlook, razão pela qual o correio enviado vem da sua conta. O agente utiliza a sua própria identidade gerida atribuída pelo utilizador para aceder ao Azure e recolher os dados de recursos para o relatório, de modo que os papéis RBAC atribuídos a essa identidade decidam o que o relatório pode incluir. O Azure cria essa identidade com o agente, por isso não crias uma aqui. Para mais informações, consulte Identidade do Agente e permissões do Agente.

1. Acede a Criação + configuração>Conectores na barra lateral de navegação.
2. Selecionar Adicionar conector.
3. Selecione o separador de Notificações .
4. Selecione o conector Office 365 Outlook para o serviço Microsoft Outlook.
5. Selecione Seguinte.
6. Inicie sessão e autorize o acesso, e depois selecione Próximo.
7. Em Configurar ferramentas, selecione a operação de enviar email. A barra lateral do assistente identifica esta etapa como Configurar ferramentas.
8. Defina Permissão como Perguntar sempre.
9. Ativa a política de parâmetros para a operação de envio de email.
10. No parâmetro destinatário ou To , introduza o endereço do destinatário a partir dos pré-requisitos.
11. Selecione Seguinte.
12. Reveja a configuração e, em seguida, selecione Criar.

Ponto de controlo: O conector aparece na lista de conectores com o estado de Conectado.

Criar um agente personalizado

Os agentes alfandegários são trabalhadores especializados com acesso a ferramentas específicas. Pode criá-los e ligá-los no Agent Canvas, um diagrama visual dos seus agentes personalizados, das respetivas ferramentas e dos acionadores que os iniciam.

1. Acede a Criação + configuração>Agent Canvas na barra lateral de navegação.
2. Selecione Criar na barra de ferramentas e depois selecione Agente Personalizado. O diálogo de criação abre com dois separadores, Formulário e YAML.
3. Preencha os campos obrigatórios:
   • Nome do agente alfandegário: por exemplo, health-check-reporter
   • Instruções: descreva o que este agente alfandegário faz e inclua o destinatário do relatório, por exemplo, "É um relator de verificação de saúde. Verifique a saúde dos recursos do Azure para as minhas aplicações container e envie o resumo por email paraops@example.com."
4. Selecione Escolher ferramentas e depois selecione a ferramenta de envio de email a partir do seu conector juntamente com as ferramentas do Azure que o relatório precisa. As ferramentas são as operações individuais que o agente pode invocar. Escolher ferramentas aqui sobrepõe-se aos padrões globais de ferramenta para este agente personalizado, e deixar a seleção vazia permite que herde todas as ferramentas globais. Ver Ferramentas e Ferramentas e competências.
5. Selecione Criar.

As boas instruções identificam o âmbito, a verificação e o que fazer com o resultado. A instrução de exemplo funciona porque diz que recursos consultar, o que procurar e para onde vai o resumo, para que o agente não tenha de adivinhar nenhum dos três. O separador YAML mostra a mesma definição que o texto, por isso podes rever ou copiar o que construíste.

O agente personalizado aparece como um nó na tela, e a sua operação selecionada no Outlook aparece num nó toolbox, normalmente com um emblema MCP.

Ponto de controlo: A tela mostra o nó do agente personalizado e um nó da caixa de ferramentas contendo a ferramenta Outlook selecionada.

Agende uma tarefa recorrente

Liga uma tarefa agendada ao agente personalizado para que corra automaticamente.

1. Selecione o botão + na lateral do nó do seu agente personalizado.

2. No grupo Trigger , selecione Adicionar tarefa agendada. O diálogo começa com o agente personalizado Response já definido para esse agente.

3. Preencha os campos:

   Campo	Valor de exemplo
   Nome da tarefa	daily-health-report
   Agente personalizado de resposta	O seu agente alfandegário, já selecionado
   Detalhes da tarefa	Verificar o estado dos recursos no meu grupo de recursos. Verifica que todas as aplicações estão a correr, verifica as métricas de CPU e memória da última hora e revê quaisquer registos de avisos recentes. Resume as conclusões e envie o relatório.
   Frequência	Diariamente
   Hora do dia	08:00

4. Selecione Criar tarefa.

A etiqueta Hora do dia mostra o fuso horário em que o seu navegador está, como Hora do dia (PST), mas o horário é guardado como UTC sem fuso horário. A tarefa corre sempre à mesma hora UTC, por isso, após uma alteração no horário de verão, ela corre uma hora antes ou depois da hora local que escolheste. Se definir Frequência para Cron personalizado, o seletor de tempo é substituído por um campo de expressão Cron (UTC ), e a expressão é lida como UTC.

Cada execução consome utilização de agentes, e uma tarefa diária continua a consumir utilização de agentes até a desativar. Escolhe a frequência mais baixa que ainda te dê o sinal de que precisas. Para saber como é medido o uso, consulte Preços e faturação.

A tela mostra agora toda a cadeia de fluxo de trabalho.

Verificar o resultado

Execute a tarefa imediatamente para verificar se tudo funciona:

1. Vai a Automação na navegação lateral, onde podes ver as tuas tarefas agendadas. Links antigos para a página de tarefas agendadas redirecionam para aqui.
2. Selecione a caixa de seleção junto da sua tarefa.
3. Selecione Executar agora na barra de ferramentas.
4. Para ver a execução, selecione o nome da sua tarefa para abrir a vista Execuções e, em seguida, selecione a ligação Nome da thread. Também podes encontrar o tópico em Chats na barra lateral.

Executar agora submete o pedido de execução e atualiza a lista de tarefas. O que a execução produz, desde as verificações do estado de funcionamento e métricas até ao relatório enviado por e-mail, depende das ferramentas que selecionaste, do acesso do agente aos teus recursos e à tua telemetria, e do funcionamento do conector.

Ponto de controlo: É apresentada uma execução da tarefa. Se a execução resolver um thread, a vista de execuções mostra um link do nome do Thread . Caso contrário, mostra Nenhum tópico encontrado. Se a execução for bem-sucedida e invocar a ferramenta Outlook, verifique se o destinatário recebe o relatório.

Se a tarefa não for executada

Uma tarefa agendada pode terminar sem produzir o resultado que esperava. Comece pelo histórico de execuções.

1. Vai a Automação e seleciona o nome da tarefa. Cada linha de execução mostra a hora de início, o estado Com êxito ou Falhou e uma ligação para o nome do tópico ou Nenhum tópico encontrado. A linha não mostra nenhuma mensagem de erro, por isso abre o tópico para ver o que aconteceu.
2. Abra o tópico mais recente. Mostra como o agente planeou o trabalho, a que ferramentas recorreu e a que conclusão chegou.
3. Uma execução é marcada como bem-sucedida assim que o respetivo trabalho é entregue a uma thread, pelo que uma execução pode mostrar Sucesso mesmo que o agente venha mais tarde a parar, fique em pausa a aguardar aprovação ou encontre uma falha numa chamada de ferramenta. Leia o tópico antes de confiar no estado.
4. Se não aparecer nenhuma execução, confirme que o estado da tarefa está Ligado e verifique o próximo tempo de execução.

Para mais resolução de problemas e gestão de tarefas, consulte Criar e editar tarefas agendadas.

Limpeza de recursos

Depois de verificares o relatório, usa Desligar ou Apagar para uma tarefa agendada que não planeias manter. Utilize Remover ou Desconectar para o conector. Revogue a autorização OAuth do Outlook quando já não for necessária.

Completaste a jornada de início

Construíste um fluxo de trabalho de ponta a ponta. Um conector dá ao seu agente uma forma de contactar o Outlook, um agente personalizado sabe o que verificar e onde reportar, e uma tarefa agendada executa toda a cadeia por si só.

O seu agente pode agora:

• Automatizar fluxos de trabalho: Executar tarefas agendadas através de agentes personalizados e conectores.
• Usa o contexto da equipa: Tira partido das fontes de conhecimento e dos detalhes da equipa que associaste durante a configuração e a integração inicial.

Se completaste a tua primeira investigação, também viste o agente diagnosticar um problema usando o teu código, telemetria e contexto do Azure. Se concluiu Automate incident response, este deteta alertas que correspondem a um plano de resposta e investiga-os sem que tal lhe seja pedido.

Capacidades relacionadas

Conteúdo relacionado

Agora que está configurado, explore os Conceitos para perceber como o agente funciona, ou experimente um tutorial para orientação prática sobre funcionalidades avançadas.