Automatizar fluxos de trabalho no Agente SRE do Azure

Sua equipe provavelmente tem tarefas recorrentes, como verificar a integridade do serviço todas as manhãs, revisar alertas durante a noite, verificar expirações de certificado ou postar relatórios semanais de capacidade. Conecte suas ferramentas, crie um fluxo de trabalho e deixe o agente executá-lo em um agendamento.

O que você realiza

• Conectar uma ferramenta de notificação para que o agente possa enviar mensagens
• Criar um agente personalizado que usa essa ferramenta
• Agendar uma verificação de saúde recorrente que se executa automaticamente
• Veja o fluxo de trabalho completo no Agent Canvas

Pré-requisitos

Como funciona

A automação conecta três blocos de construção, cada um configurado por meio do portal:

No portal, o segundo bloco aparece como Agente Personalizado.

O passo a passo a seguir cria um relatório de saúde matinal enviado por email, mas os mesmos três blocos abrangem outros trabalhos recorrentes. Altere as instruções e o cronograma para revisar alertas noturnos, verificar os vencimentos dos certificados ou publicar um resumo semanal de capacidade. Um relatório semanal enviado para uma lista de distribuição também dá à sua liderança um histórico permanente que ninguém precisa montar manualmente.

Adicionar um conector

Os conectores permitem que o agente interaja com serviços externos. Comece com uma ferramenta de notificação para que o agente possa relatar as descobertas. Esses passos configuram um conector do Outlook. No caso do Teams, consulte Configurar conector do Teams.

Duas identidades estão no escopo antes de começar. Seu login autoriza o corretor a agir no Outlook, por isso as mensagens enviadas vêm da sua conta. O agente usa sua própria identidade gerenciada atribuída pelo usuário para acessar o Azure e coletar 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, então você não cria uma aqui. Para mais informações, veja Identidade do Agente e Permissões do Agente.

1. Vá para Construir + configurar>Conectores na navegação lateral.
2. Selecione Adicionar conector.
3. Selecione a aba Notificações .
4. Selecione o conector Office 365 Outlook para o serviço Microsoft Outlook.
5. Selecione Avançar.
6. Faça login e autorize o acesso, e então selecione Próximo.
7. Em Configurar Ferramentas, selecione a operação de envio de e-mail. O assistente rotula esta etapa como Configurar ferramentas.
8. Defina a permissão como Perguntar.
9. Ative a política de parâmetros para a operação de envio de e-mail.
10. No parâmetro de destinatário ou To, insira o endereço do destinatário dos pré-requisitos.
11. Selecione Avançar.
12. Examine a configuração e selecione Criar.

Checkpoint: O conector aparece na lista de conectores com o status de Conectado.

Criar um agente personalizado

Os agentes personalizados são profissionais especializados com acesso a ferramentas específicas. Você constrói e conecta eles no Agent Canvas, um diagrama visual dos seus agentes personalizados, suas ferramentas e os gatilhos que os iniciam.

1. Vá para Construir + configurar>Agent Canvas na navegação lateral.
2. Selecione Criar na barra de ferramentas e selecione Agente Personalizado. O diálogo de criação abre com duas abas, Formulário e YAML.
3. Preencha os campos necessários:
   • Nome do agente personalizado: por exemplo, health-check-reporter
   • Instruções: descreva o que esse agente alfandegário faz e inclua o destinatário do relatório, por exemplo: "Você é um repórter de exames de saúde. Verifique a saúde dos recursos do Azure para meus apps contêineres e envie o resumo por e-mail paraops@example.com."
4. Selecione Escolher ferramentas e, em seguida, selecione a ferramenta de envio de e-mail do seu conector junto com as ferramentas do Azure que o relatório precisa. Ferramentas são as operações individuais que o agente pode invocar. Escolher ferramentas aqui substitui as configurações padrão globais das ferramentas para esse agente personalizado, e deixar a seleção em branco permite que esse agente herde todas as ferramentas globais. Veja Ferramentas e Ferramentas e Habilidades.
5. Selecione Criar.

Boas instruções indicam o escopo, a verificação e o que fazer com o resultado. A instrução de exemplo funciona porque diz quais recursos consultar, o que procurar e para onde o resumo vai, então o agente não precisa adivinhar nenhum dos três. A aba YAML mostra a mesma definição que o texto, então você pode revisar ou copiar o que construiu.

O agente personalizado aparece como um nó na área de trabalho, e a operação do Outlook selecionada é exibida em um nó da caixa de ferramentas, geralmente com o selo MCP.

Ponto de verificação: a tela exibe o nó de agente personalizado e um nó da caixa de ferramentas contendo a ferramenta do Outlook selecionada.

Agendar uma tarefa recorrente

Vincule uma tarefa agendada ao agente personalizado para que ela seja executada automaticamente.

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

2. No grupo Gatilho, 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	Seu agente personalizado, já selecionado
   Detalhes da tarefa	Verifique a integridade dos recursos em meu grupo de recursos. Verifique se todos os aplicativos estão rodando, verifique métricas de CPU e memória na última hora e revise quaisquer registros de avisos recentes. Resumir as conclusões e enviar o relatório.
   Frequência	Diariamente
   Hora do dia	8:00 da manhã

4. Selecione Criar tarefa.

O rótulo Horário do dia mostra o fuso horário em que seu navegador está, como Horário do dia (PST), mas o cronograma é salvo como UTC sem fuso horário. A tarefa sempre roda no mesmo horário UTC, então após uma alteração no horário de verão ela roda uma hora antes ou depois do horário local que você escolheu. Se você definir Frequência como 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 uso de agente, e uma tarefa diária continua consumindo uso de agente até você desativar a tarefa. Escolha a frequência mais baixa que ainda te dá o sinal que você precisa. Para saber como o uso é medido, veja Precificação e faturamento.

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

Verifique o resultado

Execute a tarefa imediatamente para verificar se tudo funciona:

1. Vá para Automação na navegação lateral, onde você pode ver suas tarefas agendadas. Links antigos para a página de tarefas agendadas redirecionam para cá.
2. Selecione a caixa de seleção ao lado da sua tarefa.
3. Selecione Executar agora na barra de ferramentas.
4. Para acompanhar a execução, selecione o nome da sua tarefa para abrir a exibição de execuções e, em seguida, selecione o link nome da thread. Você também pode encontrar o thread em Chats na barra lateral.

Executar agora envia a solicitação de execução e atualiza a lista de tarefas. O que a execução produz, desde as verificações de saúde e métricas até o relatório enviado por e-mail, depende das ferramentas que você selecionou, do acesso do agente aos seus recursos e telemetria, e da saúde do conector.

Ponto de verificação: uma execução aparece para a tarefa. Se a execução resolver uma thread, a visualização de execuções mostrará um link Nome da thread. Caso contrário, mostra Nenhuma thread encontrada. Se a execução for bem-sucedida e invocar a ferramenta Outlook, verifique se o destinatário recebeu o relatório.

Se a tarefa não for executada

Uma tarefa agendada pode ser concluída sem produzir o resultado que você esperava. Comece pelo histórico de execuções.

1. Vá em Automação e selecione o nome da tarefa. Cada linha de execução mostra o horário de início, um status Sucesso ou Falha e um link com o nome da thread ou Nenhuma thread encontrada. A linha não mostra mensagem de erro, então abra o tópico para ver o que aconteceu.
2. Abra o tópico mais recente. Ele mostra como o agente planejou o trabalho, quais ferramentas utilizou e a que conclusão chegou.
3. Uma execução é marcada como bem-sucedida assim que seu trabalho é entregue a uma thread, portanto pode exibir Sucesso mesmo que o agente posteriormente tenha parado, ficado pausado aguardando aprovação ou tido uma chamada de ferramenta com falha. Leia o tópico antes de confiar no status.
4. Se nenhuma execução aparecer, confirme que o status da tarefa está Ligado e verifique o próximo tempo de execução.

Para mais solução de problemas e gerenciamento de tarefas, veja Criar e editar tarefas agendadas.

Limpar os recursos

Depois de verificar o relatório, use Desligar ou Excluir para uma tarefa agendada que você não pretende manter. Use Remover ou Desconectar para o conector. Revogue a subvenção Outlook OAuth quando ela não for mais necessária.

Você concluiu a jornada de introdução

Você construiu um fluxo de trabalho de ponta a ponta. Um conector dá ao seu agente uma forma de entrar em contato com o Outlook, um agente personalizado sabe o que verificar e onde reportar, e uma tarefa agendada executa toda a cadeia sozinha.

Seu agente agora pode:

• Automatize fluxos de trabalho: execute tarefas agendadas através de agentes personalizados e conectores.
• Use o contexto da equipe: Basee-se nas fontes de conhecimento e detalhes da equipe que você conectou durante a configuração e a integração.

Se você completou sua primeira investigação, também viu o agente diagnosticar um problema usando seu código, telemetria e contexto do Azure. Se você completou o Automate incident response, ele capta alertas que correspondem a um plano de resposta e os investiga sem que seja solicitado.

Recursos relacionados

Conteúdo relacionado

Agora que você está configurado, explore os Conceitos para entender como o agente funciona, ou tente um tutorial para orientação prática sobre recursos avançados.