Cenários para a criação de subagentes na versão prévia do Agente SRE do Azure

O Agente SRE do Azure apresenta um construtor de subagentes para ajudá-lo a projetar, configurar e estender subagentes operacionais inteligentes adaptados às necessidades da sua organização. Com o construtor de subagentes, você pode integrar diretamente fontes de dados, gerenciar e enriquecer bases de dados de conhecimento, criar subagentes especializados e automatizar fluxos de trabalho usando gatilhos e tarefas agendadas. Este artigo explora cenários comuns e padrões de configuração para ajudá-lo a maximizar o valor do construtor de subagentes para suas operações de SRE (engenharia de confiabilidade do site).

Traga suas próprias fontes de dados (ferramentas de observabilidade)

O construtor de subgêneros permite que você conecte sua infraestrutura de observabilidade existente para aprimorar os recursos de seus subagentes.

Conectores de dados com suporte

O SRE Agent dá suporte aos seguintes conectores de dados que interfacem com o construtor de subagentes:

• Protocolo de Contexto de Modelo (MCP): conecte-se a fontes de dados externas e APIs.
• Microsoft Teams: postar mensagens nos canais do Teams.
• Outlook: enviar notificações por email.

Processo de configuração

Use as etapas a seguir para configurar o subagente.

1. Navegue até conectores de dados.

   No construtor de subagentes, selecione a guia Configurações > Conectores.

2. Escolha o tipo de conector.

   Selecione entre as opções de conector disponíveis.

3. Forneça detalhes da conexão.

   Insira cadeias de conexão, credenciais de autenticação e configurações de escopo.

4. Teste a conexão.

   Valide a conectividade e as permissões antes de salvar.

5. Associar a subagentes.

   Vincule fontes de dados a subagentes específicos com base em seu foco operacional.

Upload de arquivos e gerenciamento de base de dados de conhecimento

Você pode aprimorar o conhecimento de seus subagentes carregando documentação, runbooks e guias de procedimento.

Aqui está uma pequena lista de exemplos de arquivos que você pode adicionar ao seu agente:

• Arquitetura ou Design do Sistema: diagramas e documentação que explicam os componentes do sistema e os fluxos de dados.

• Guias de solução de problemas: instruções passo a passo para diagnosticar e resolver problemas comuns ou recorrentes.

• Runbooks e SOPs (procedimentos operacionais padrão): fluxos de trabalho detalhados para operações de rotina, manutenção e resposta a incidentes.

• Relatórios de incidentes e pós-morte: documentação de interrupções passadas, incluindo análise de causa raiz e lições aprendidas.

• Notas de versão e logs de alterações: resumos de atualizações de produtos ou serviços, incluindo novos recursos, correções de bugs e alterações.

Esses tipos de arquivos ajudam os subagentes a fornecer respostas precisas e com reconhecimento de contexto e automatizar tarefas operacionais com mais eficiência.

Tipos de arquivo com suporte

Todos os procedimentos operacionais no formato Markdown (.md) ou texto (.txt).

Fluxo de trabalho de gerenciamento de arquivos

1. Acesse a base de conhecimento indo para a guia Configurações > Base de Conhecimento > Arquivos.

2. Carregue arquivos arrastando e soltando seus arquivos ou navegando para selecionar arquivos (no máximo 50 MB por arquivo).

3. Organize o conteúdo adicionando marcas e descrições para melhorar a pesquisa.

4. Habilite o acesso de subagentes configurando quais subagentes podem acessar fontes de conhecimento específicas.

5. Monitore o uso acompanhando como os subagentes usam o conhecimento carregado em suas respostas.

Criar seus subagentes

Crie subagentes especializados que se concentram em domínios operacionais ou áreas técnicas específicas.

Tipos de subagentes

Exemplos de subagentes especializados incluem:

• Especialistas em banco de dados: concentre-se no diagnóstico de desempenho e conectividade do banco de dados.

• Analistas de rede: especialize-se em problemas de conectividade e desempenho.

• Investigadores de segurança: treinado em incidentes de segurança e verificações de conformidade.

• Monitores de aplicativo: especialistas em pilhas ou estruturas de aplicativos específicas.

Configuração do subagente

• Definir finalidade: especifique claramente o foco operacional e a experiência do subagente.

• Selecionar ferramentas: escolha ferramentas de sistema relevantes e conectores de dados para o domínio do subagente.

• Customizar instruções: Forneça orientações e procedimentos operacionais específicos do domínio.

• Definir regras de transferência: configure como o subagente escalona para operadores humanos ou outros subagentes.

• Recursos de teste: validar o desempenho do subagente em cenários específicos do domínio

Configuração de subagente de exemplo:

agent: 
  name: "WebApp-Performance-Specialist" 
  description: "Specialized subagent for web application performance analysis" 
  instructions: | 
    You are a specialist in diagnosing web application performance and reliability issues. 

    Focus on HTTP response codes, memory usage patterns, and application dependencies  

    when investigating incidents. 
  tools: 
    - "AzureMonitorQuery" 
    - "HttpHealthCheck"  
    - "ResourceHealthStatus" 
    - "DeploymentHistory" 
  handoff_conditions: 
    - "Infrastructure-level issues requiring network analysis" 
    - "Database performance issues requiring specialized expertise" 
    - "Security incidents requiring specialized investigation" 

Ferramentas estendidas (conectores de dados internos e ferramentas MCP)

Expanda os recursos de seus subagentes com um kit de ferramentas abrangente para tarefas operacionais.

Ferramentas internas do sistema

• Ferramentas específicas do Azure:

  • Gerenciamento de recursos: dimensionar, reiniciar e configurar recursos do Azure

  • Consultas do Azure Monitor: executar consultas em logs e métricas do Azure Monitor

  • Verificações de integridade: avaliar o status de disponibilidade e integridade do recurso

  • Análise de implantação: examine as alterações recentes e o histórico de implantação

• Ferramentas operacionais genéricas:

  • Solicitações HTTP: Testar a disponibilidade do endpoint e os tempos de resposta

  • Operações de arquivo: ler arquivos e logs de configuração

  • Transformação de dados: processar e analisar dados operacionais

  • Sistemas de notificação: enviar alertas e atualizações de status

Integração do PROTOCOLO MCP (Model Context Protocol)

O MCP permite que seus subagentes se conectem com sistemas externos e APIs além dos recursos nativos do Azure.

• Configuração da conexão MCP:

  • Configurar o servidor MCP: Defina o endpoint do serviço externo.

  • Autenticação: forneça as credenciais necessárias e os tokens de acesso.

  • Descoberta de ferramentas: importar ferramentas e funções disponíveis do servidor MCP.

  • Atribuição: associar ferramentas MCP a subagentes específicos.

• Cenários de MCP com suporte

  • APIs personalizadas: ferramentas internas e serviços específicos para sua organização.

  • Integrações de terceiros: ServiceNow, Jira, Slack e outras ferramentas operacionais.

  • Bancos de dados especializados: bancos de dados de série temporal, repositórios de documentos e plataformas de análise.

  • Sistemas de monitoramento: Grafana, Prometheus e painéis personalizados.

Disparadores (incidentes e tarefas agendadas)

Automatize seus fluxos de trabalho operacionais com mecanismos de gatilho inteligentes.

Gatilhos de incidente

Ative automaticamente os subagentes quando condições de incidente específicas forem atendidas ajustando as seguintes opções de configuração:

• Integração de plataforma: Azure Monitor, PagerDuty ou ServiceNow.

• Critérios de filtragem: impacto do serviço, nível de severidade, tipo de incidente e regras de correspondência personalizadas.

• Tempo de resposta: ativação imediata ou resposta atrasada com base na duração do incidente.

• Caminhos de escalonamento: defina procedimentos de entrega quando a resolução automatizada falhar.

Exemplo de gatilho de incidente:

trigger: 
  name: "High-CPU-Alert-Response" 
  platform: "AzureMonitor" 
  conditions: 
    - metric: "cpu_percent" 
    - threshold: "> 90%" 
    - duration: "5 minutes" 
    - service: "production-webapp" 
  response: 
    agent: "WebApp-Performance-Specialist" 
    mode: "review" 
    timeout: "30 minutes" 

Tarefas agendadas

Crie atividades operacionais recorrentes que são executadas automaticamente:

• Tipos de agendamento:

  • Expressões cron: use a sintaxe cron padrão para o tempo preciso.

  • Intervalos predefinido: execução por hora, diária, semanal ou mensal.

  • Idioma natural: descrever agendamentos em inglês simples (por exemplo, "todos os dias da semana às 9h").

• Padrões comuns de tarefa agendada:

  • Resumos de saúde: relatórios diários de status do ambiente.

  • Verificações de conformidade: segurança semanal e validação de política.

  • Análises de desempenho: análise mensal de utilização de recursos.

  • Verificações de manutenção: avaliações trimestrais de integridade do sistema.

Exemplo de tarefa agendada:

scheduled_task: 
 name: "Daily-Environment-Health-Report" 
  schedule: "0 9 * * 1-5"  # Weekdays at 9 AM 
  timezone: "UTC" 
  instructions: | 
    Generate a comprehensive health report covering: 
    - Resource utilization trends (CPU, memory, storage) 
    - Active alerts and their resolution status 
    - Recent deployment impacts on performance 
    - Recommendations for optimization 
  outputs: 
    - email: "ops-team@company.com" 
    - teams_channel: "operations-reports" 

Conteúdo relacionado

• Criar subagentes no Agente SRE do Azure