Ferramentas do Servidor MCP para o Azure SRE Agent

O Servidor MCP do Azure permite gerenciar recursos do Agente SRE do Azure, incluindo: ativar, adicionar, aplicar, criar, desativar, excluir, gerar, obter, investigar, kusto, listar, mcp, mensagem, pagerduty, pausar, planejar, reindexar, retomar, pesquisar, servicenow, testar, validar e yolo, por meio de prompts em linguagem natural.

Azure SRE Agent é um assistente de confiabilidade alimentado por inteligência artificial que ajuda as equipes a diagnosticar e resolver problemas de produção, diminuir o trabalho operacional e reduzir o tempo médio para resolução (MTTR). Para obter mais informações, consulte a documentação do Agente SRE do Azure.

Note

Parâmetros de ferramenta: as ferramentas do Servidor MCP do Azure definem parâmetros para os dados necessários para concluir tarefas. Alguns desses parâmetros são específicos para cada ferramenta e estão documentados aqui. Outros parâmetros são globais e compartilhados por todas as ferramentas. Para obter mais informações, consulte parâmetros de ferramenta.

Agentes: criar ou atualizar um subagente

Essa ferramenta cria ou atualiza um subagente em um recurso de agente SRE de destino. Especifique a assinatura, o agente e o nome para identificar o subagente. A ferramenta aplica alterações de forma idempotente, de modo que solicitações repetidas com os mesmos valores não criam duplicatas. Forneça os parâmetros necessários para criar ou atualizar o subagente.

Os prompts de exemplo incluem:

  • Crie um subagente com o nome 'subagent-01' no agente SRE 'sre-agent-prod'.
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Name Obrigatório O nome do item do Agente SRE.
Description Optional Uma descrição para o item do Agente SRE.
Instruções Optional Instruções para o subagente.
Ferramentas Optional Nomes de ferramentas a serem anexados. Há suporte para vários valores.
Transferências Optional Nomes de transferência de subagentes. Há suporte para vários valores.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
✅ ✅ ❌ ❌ ❌ ❌

Agentes: excluir um subagente

Essa ferramenta exclui um subagente de um recurso SRE Agent especificado.

Os prompts de exemplo incluem:

  • "Remova o subagente chamado 'telemetry-agent' do Agente SRE 'prod-sre' na assinatura '12345-abcde' com a confirmação definida como 'true'."
  • "Exclua o subagente 'backup-monitor' do Agente SRE 'staging-sre' na assinatura 'my-subscription-id' com a confirmação definida como 'true'."
  • "Exclua o subagente de nome 'subagent-01' do Agente SRE 'sre-agent-prod' com confirmação 'true'."
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Name Obrigatório O nome do item do Agente SRE.
Confirmar Obrigatório Confirme uma ação destrutiva.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
✅ ✅ ❌ ❌ ❌ ❌

Agentes: obter detalhes de configuração

Mostrar os detalhes de configuração de um agente SRE nomeado. Essa ferramenta retorna o ponto de extremidade, o estado de provisionamento, o local e as configurações do Agente SRE especificado. Você pode filtrar os resultados por grupo de recursos.

Os prompts de exemplo incluem:

  • "Mostre os detalhes do Agente SRE 'sre-agent-north' no grupo de recursos 'rg-sre-prod'."
  • "Verifique a configuração do agente SRE 'sre-agent-eastus' no grupo de recursos 'prod-rg'."
  • "Mostre o ponto de extremidade e o status de provisionamento do Agente SRE 'ops-agent-west' na assinatura especificada."
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Agentes: Listar recursos

Essa ferramenta lista os recursos do Azure SRE Agent. Você pode filtrar os resultados por grupo de recursos. Cada resultado inclui name, id, , location, resourceGroup, provisioningStatee endpoint. Se a ferramenta não encontrar recursos do Agente SRE, ela retornará uma lista vazia.

Os prompts de exemplo incluem:

  • Liste os recursos do Agente SRE do Azure na minha assinatura.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Ferramentas de agentes: criar ou atualizar ferramenta personalizada

Essa ferramenta cria ou atualiza uma ferramenta personalizada em um recurso de agente SRE de destino. Especifique o agente, o nome e o tipo de ferramenta. Se houver uma ferramenta com o nome especificado, essa ferramenta atualizará sua configuração; caso contrário, ele cria uma nova ferramenta. Forneça valores de configuração de acordo com a tabela de parâmetros.

Os prompts de exemplo incluem:

  • "Crie a ferramenta personalizada 'log-collector' no agente 'sre-agent-prod', na assinatura 'contoso-sub', usando o tipo de ferramenta 'collector'."
  • Crie uma ferramenta personalizada com o nome 'custom-kusto-tool', tipo de ferramenta 'KustoTool', no agente SRE 'sre-agent-prod'.
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Name Obrigatório O nome do item do Agente SRE.
Tipo de ferramenta Obrigatório O tipo de ferramenta personalizado, como KustoTool ou LinkTool.
Conector Optional O nome do conector usado pelas ferramentas Kusto.
Nome do banco de dados Optional O banco de dados utilizado pelas ferramentas Kusto.
Description Optional Uma descrição para o item do Agente SRE.
Parâmetros Optional Matriz JSON de definições de parâmetro de ferramenta.
Query Optional A consulta Kusto usada pelas ferramentas Kusto.
Modelo de URL Optional O modelo de URL para ferramentas de links.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
✅ ✅ ❌ ❌ ❌ ❌

Ferramentas de agentes: obter definição de ferramenta personalizada

Obtém uma definição de ferramenta personalizada de um recurso de agente SRE de destino. Essa ferramenta requer os parâmetros de agente e nome e retorna a definição de ferramenta personalizada para o agente e o nome especificados.

Os prompts de exemplo incluem:

  • "Obtenha a definição da ferramenta personalizada chamada 'deploy-helper' no Agente SRE 'sre-agent-prod'."
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Name Obrigatório O nome do item do Agente SRE.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Ferramentas de agentes: listar ferramentas

Essa ferramenta lista as ferramentas personalizadas em um recurso de agente SRE de destino. Ele retorna o nome, a versão e o status de cada ferramenta personalizada, para que você possa verificar implantações e solucionar problemas.

Os prompts de exemplo incluem:

  • Liste ferramentas personalizadas no SRE Agent 'sre-agent-prod'.
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Arquitetura: Planejar uma arquitetura

Planeje e gere uma arquitetura de agente para Engenharia de Confiabilidade de Site (SRE). Essa ferramenta analisa seus requisitos e produz um design estruturado para agentes, ferramentas, conectores e gatilhos. Você fornece requisitos e restrições de alto nível e essa ferramenta retorna responsabilidades de componente, padrões de interação, considerações de implantação, recomendações de segurança e controle de acesso e sugestões de observabilidade. Use a saída para orientar a implementação, a seleção de ferramentas e o planejamento de integração.

As saídas incluem:

  • Uma lista de componentes com responsabilidades e limites.
  • Definições de conector e gatilho para integrações.
  • Considerações sobre implantação e escalabilidade, incluindo recomendações regionais e de orquestração.
  • Diretrizes sobre segurança e controle de acesso baseado em funções (RBAC).
  • Padrões de observabilidade e resposta a incidentes, incluindo sugestões de monitoramento e alertas.

Os prompts de exemplo incluem:

  • "Planeje uma arquitetura de Agente SRE para os requisitos 'observabilidade multilocatário com triagem automatizada de incidentes e integração com Kusto'."
Parâmetro Obrigatório ou opcional Descrição
Requisitos Obrigatório Requisitos de arquitetura.
Conector do Kusto Optional Nome do conector do Kusto.
Tipo de gatilho Optional O tipo de gatilho, como manual ou baseado em agendamento.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Prompts comuns: criar ou atualizar um prompt

Esta ferramenta cria ou atualiza um prompt comum com nome no agente SRE. Ele salva modelos de prompt reutilizáveis, para que as equipes possam centralizar as diretrizes e reduzir a duplicação. A ferramenta retorna o objeto de prompt criado ou atualizado.

Os prompts de exemplo incluem:

  • "Crie um prompt comum chamado 'restart-service' com o conteúdo 'Descreva como reiniciar o serviço de aplicativo durante um incidente' no Agente SRE 'sre-agent-prod'."
Parâmetro Obrigatório ou opcional Descrição
Conteúdo Obrigatório O conteúdo do prompt.
Name Obrigatório O nome do item do Agente SRE.
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ❌ ❌ ❌

Prompts comuns: excluir um prompt

Esta ferramenta exclui permanentemente o prompt identificado pelo nome em um Agente SRE. Você confirma a exclusão antes que a ferramenta apague a definição do prompt. Esta ação não é reversível.

Os prompts de exemplo incluem:

  • "Exclua permanentemente o prompt comum chamado 'cpu-throttle-guidance' do Agente SRE 'sre-agent-westus' com confirmação 'true'."
Parâmetro Obrigatório ou opcional Descrição
Name Obrigatório O nome do item do Agente SRE.
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Confirmar Obrigatório Confirme uma ação destrutiva.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
✅ ✅ ❌ ❌ ❌ ❌

Prompts comuns: Obter o texto do prompt

Esta ferramenta exibe o texto completo de um prompt comum específico em um agente de Engenharia de Confiabilidade de Site (SRE). Você informa o nome e a ferramenta retorna o conteúdo do prompt para permitir inspeção ou auditoria durante depuração ou revisão.

Os prompts de exemplo incluem:

  • "Mostre o prompt comum chamado 'deploy-checklist' no Agente SRE 'sre-agent-westus'."
Parâmetro Obrigatório ou opcional Descrição
Name Obrigatório O nome do item do Agente SRE.
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Solicitações comuns: listar solicitações

Essa ferramenta lista todos os prompts comuns disponíveis em um Agente SRE. Ele retorna uma coleção com os nomes e as descrições dos prompts registrados. Os resultados ajudam você a descobrir os prompts disponíveis e a examinar suas descrições.

Os prompts de exemplo incluem:

  • "Informe os prompts comuns do Agente SRE 'sre-agent-prod'."
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Pesquisar Optional Filtro de pesquisa opcional.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Conectores: criar ou atualizar o conector do Kusto

Essa ferramenta cria ou atualiza um conector para o Azure Data Explorer (Kusto) em um recurso do Azure SRE Agent. O conector permite que o agente ingera e consulte dados de um cluster Azure Data Explorer.

Os prompts de exemplo incluem:

  • "Crie um conector Kusto no Agente SRE 'sre-agent-01' usando a URL do cluster 'https://my-resource.eastus.kusto.windows.net' e o nome 'kusto-connector-prod'."
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Cluster URL Obrigatório A URL do cluster do Azure Data Explorer.
Name Obrigatório O nome do item do Agente SRE.
Nome do banco de dados Optional O banco de dados utilizado pelas ferramentas Kusto.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
✅ ✅ ❌ ❌ ❌ ❌

Conectores: Criar ou atualizar conector

Essa ferramenta cria ou atualiza um conector em um recurso do agente SRE Azure. Especifique o agente, o nome do conector e o tipo de conector. Você também pode fornecer credenciais de conexão e configurações adicionais. Com êxito, essa ferramenta retorna o recurso do conector.

Siga as convenções de nomenclatura do Azure para nomes de recursos e verifique se as permissões de RBAC (controle de acesso baseado em função) permitem a atualização de conectores. Use nomes realistas, como sre-agent-prod para o agente e rg-sre-prod para o grupo de recursos.

Os prompts de exemplo incluem:

  • "Crie um conector MCP no SRE Agent 'sreagent-prod' com o nome 'mcp-connector' e digite 'http'."
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Name Obrigatório O nome do item do Agente SRE.
Tipo Obrigatório O tipo de conector MCP: stdio ou http.
Args Optional Argumentos para conectores MCP do tipo stdio.
Tipo de autenticação Optional O tipo de autenticação do conector HTTP MCP.
Bearer token env Optional Variável de ambiente que contém o token de portador.
Command Optional O comando utilizado para conectores MCP via stdio.
Ponto de extremidade Optional O ponto de extremidade do conector MCP baseado em HTTP.
Envs JSON Optional Objeto JSON de variáveis de ambiente para conectores stdio MCP.
Cabeçalhos JSON Optional Objeto JSON de cabeçalhos HTTP.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
✅ ✅ ✅ ❌ ✅ ❌

Conectores: excluir conector

Essa ferramenta exclui um conector de um recurso do agente SRE Azure.

Os prompts de exemplo incluem:

  • "Exclua o conector 'metrics-collector' do Agente SRE 'sre-agent-prod' com confirmação 'true'."
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Name Obrigatório O nome do item do Agente SRE.
Confirmar Obrigatório Confirme uma ação destrutiva.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
✅ ✅ ❌ ❌ ❌ ❌

Conectores: Obter detalhes do conector

Esta ferramenta obtém os detalhes de um conector que você configura em um recurso de Agente SRE do Azure. Você pode exibir as propriedades, a configuração e o status do conector para ajudar a solucionar problemas ou documentar o conector. Especifique os parâmetros de agente e nome para identificar o recurso do agente Azure SRE e o conector.

Os prompts de exemplo incluem:

  • "Mostre os detalhes do conector 'github-connector' no Agente SRE 'sre-agent-prod'."
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Name Obrigatório O nome do item do Agente SRE.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Conectores: listar conectores

Essa ferramenta lista os conectores que você configura em um recurso do agente SRE Azure. Ele retorna nomes de conector, tipos de conector e status de registro para que você possa examinar integrações e solucionar problemas.

Os prompts de exemplo incluem:

  • "Listar os conectores configurados no SRE Agent 'sreagent-prod'."
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Conectores: conector de teste

Essa ferramenta testa um conector e lista as ferramentas expostas pelo conector. Você pode verificar a conectividade do conector e inspecionar as ferramentas disponíveis, incluindo o nome e os recursos de cada ferramenta. Para testar um conector, forneça os parâmetros agent e name.

Os prompts de exemplo incluem:

  • "Teste o conector chamado 'my-connector' no Agente SRE 'sre-agent-prod' e liste as ferramentas disponíveis."
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Name Obrigatório O nome do item do Agente SRE.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ✅ ✅ ❌ ❌

Documentação: Obter documentação de referência

Esta ferramenta fornece documentação de referência sobre os conceitos do agente de Engenharia de Confiabilidade do Site (SRE). Você pode obter definições, detalhes de configuração e exemplos de uso para tópicos do Agente SRE, como alertas, resposta a incidentes, verificações de integridade e telemetria. Especifique o tópico para recuperar a entrada de referência de um tópico.

Os prompts de exemplo incluem:

  • "Mostre a documentação do Agente SRE para o tópico 'incident-response'."
Parâmetro Obrigatório ou opcional Descrição
Topic Obrigatório Tópico da documentação.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Memórias da documentação: Adicionar documento à base de dados de conhecimento

Esta ferramenta adiciona um documento identificado por nome à base de conhecimento do Agente SRE. Você fornece conteúdo em Markdown (*.md), e a ferramenta realiza a indexação para recuperação de conhecimento baseada em geração aumentada (RAG). Use nomes claros e descritivos para que você possa encontrar facilmente documentos.

Os prompts de exemplo incluem:

  • "Adicione o documento chamado 'incident-runbook' com o conteúdo 'Runbook: etapas para triagem de interrupção de serviço e contato com o plantão' à base de conhecimento do Agente SRE."
Parâmetro Obrigatório ou opcional Descrição
Conteúdo Obrigatório O conteúdo do documento a ser adicionado à base de dados de conhecimento.
Name Obrigatório O nome do item do Agente SRE.
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ❌ ❌ ❌ ❌ ❌

Memórias da documentação: excluir documento da base de dados de conhecimento

Especifique o documento pelo nome. Essa ferramenta exclui um documento da base de dados de conhecimento depois que você confirma. A exclusão é permanente e não pode ser desfeita. Confirme se o documento existe antes de executar essa ferramenta.

Os prompts de exemplo incluem:

  • "Exclua o documento da base de conhecimento chamado 'sre-kb-doc-01' do Agente SRE 'sre-agent-westus' com confirmação 'true'."
Parâmetro Obrigatório ou opcional Descrição
Name Obrigatório O nome do item do Agente SRE.
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Confirmar Obrigatório Confirme uma ação destrutiva.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
✅ ✅ ❌ ❌ ❌ ❌

Memórias da documentação: listar documentos indexados da base de dados de conhecimento

Essa ferramenta lista todos os documentos indexados da base de dados de conhecimento que um Agente SRE armazena na memória. Ele retorna cada nome de documento e seus metadados, sem filtro ou consulta de pesquisa. Navegar pela base de dados de conhecimento completa ajuda você a descobrir documentos disponíveis antes de executar pesquisas direcionadas.

Os prompts de exemplo incluem:

  • Obtenha uma lista completa de todos os documentos indexados da base de conhecimento armazenados na memória do SRE Agent 'sre-agent-prod', sem aplicar filtros.
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Memórias de documentação: Reindexar base de conhecimento

Essa ferramenta dispara um reindex de uma base de dados de conhecimento. Use-o para reprocessar documentos armazenados, atualizar inserções e recompilar índices de pesquisa para que os resultados da pesquisa reflitam alterações recentes de conteúdo e metadados. O tempo de reindexação depende do tamanho do conjunto de dados e da carga do servidor. Pode levar minutos ou mais. Após iniciar a ferramenta, monitore o progresso da reindexação usando os endpoints de gerenciamento do servidor.

Os prompts de exemplo incluem:

  • Reindexar os documentos da base de conhecimento do Agente SRE 'sre-agent-westus'.
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ❌ ❌ ❌ ❌ ❌

Memórias de documentação: pesquisar na base de conhecimento

Essa ferramenta pesquisa a base de dados de conhecimento do Agente SRE usando a pesquisa semântica e retorna os documentos mais relevantes para sua consulta. Essa ferramenta ajuda a localizar etapas de resolução de problemas, runbooks, análises pós-incidente e playbooks de monitoramento relacionados a incidentes ou alertas.

Os prompts de exemplo incluem:

  • "Pesquise a base de dados de conhecimento do Agente SRE em busca de 'latência de E/S de disco'."
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Query Obrigatório A consulta de pesquisa usada para localizar documentos relevantes da base de dados de conhecimento.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Hooks: excluir hook

Esta ferramenta exclui um hook de um recurso de Agente SRE do Azure.

Os prompts de exemplo incluem:

  • "Exclua o hook chamado 'backup-trigger' do Agente SRE 'sre-agent-prod' com confirmação 'true'."
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Name Obrigatório O nome do item do Agente SRE.
Confirmar Obrigatório Confirme uma ação destrutiva.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
✅ ✅ ❌ ❌ ❌ ❌

Ganchos: obter detalhes

Essa ferramenta retorna detalhes de um gancho que você configura em um recurso do agente SRE Azure. Você pode analisar a configuração do hook, consultar o status atual e validar as configurações de gatilho ou os pontos de extremidades de destino.

Os prompts de exemplo incluem:

  • "Mostre os detalhes do hook 'deploy-hook' no Agente SRE 'sre-agent-prod'."
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Name Obrigatório O nome do item do Agente SRE.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Hooks: listar hooks

Lista os ganchos configurados em um recurso do agente do SRE Azure. Use esta ferramenta para consultar os nomes dos hooks, seus tipos e o status atual deles para um agente específico. Use o resultado para verificar os hooks de implantação, monitoramento e limpeza associados ao Agent.

Os prompts de exemplo incluem:

  • Liste os hooks configurados para o SRE Agent 'sre-agent-prod'.
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Hooks: ativar thread de hook

Esta ferramenta habilita um hook sob demanda para uma thread em um recurso do Agente SRE do Azure. Ele dispara imediatamente as ações configuradas no hook.

Os prompts de exemplo incluem:

  • "Ative o hook 'health-check' na thread 'thread-42' do Agente SRE 'sreagent-prod'."
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Nome do gancho Obrigatório O nome do hook.
Thread ID Obrigatório O identificador da thread do Agente SRE.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
✅ ✅ ❌ ❌ ❌ ❌

Hooks: desativar thread de hook

Esta ferramenta desativa um hook sob demanda associado a uma thread em um recurso do Agente SRE do Azure. Você informa o agente, o nome do hook e o ID da thread para identificar o hook e a thread de destino. A ferramenta impede que o gancho seja executado no thread especificado sem remover a configuração do gancho. Você precisa das permissões apropriadas no recurso Azure SRE Agent para aplicar a alteração.

Os prompts de exemplo incluem:

  • "Desative o hook 'on-demand-restart' na thread com ID 'thread-7' do Agente SRE 'sre-agent-prod'."
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Nome do gancho Obrigatório O nome do hook.
Thread ID Obrigatório O identificador da thread do Agente SRE.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
✅ ✅ ❌ ❌ ❌ ❌

Hooks: listar estado da thread de hook

Esta ferramenta retorna o estado de ativação do hook para uma thread em um recurso do Agente SRE do Azure. Ele retorna se os ganchos estão habilitados, desabilitados ou pendentes para o thread especificado. Use os resultados para verificar a configuração do gancho e solucionar problemas de comportamento do thread.

Os prompts de exemplo incluem:

  • "Informe os estados de ativação do hook para a thread com ID 'thread-42' no Agente SRE 'sre-agent-prod'."
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Thread ID Obrigatório O identificador da thread do Agente SRE.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Incidentes: listar incidentes ativos

Esta ferramenta apresenta os incidentes ativos em um agente de Engenharia de Confiabilidade de Site (SRE). Ela retorna as threads de incidentes abertas contendo título, status, serviços afetados e informações da investigação. Use a saída para examinar investigações em andamento e ver quais serviços são afetados.

Os prompts de exemplo incluem:

  • "Informe os incidentes ativos no Agente SRE 'sre-agent-west'."
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Incidentes: Criar incidente

Use essa ferramenta para criar um thread de investigação de incidentes para um agente. Você pode registrar os detalhes do incidente, associar os serviços afetados e definir a gravidade para ajudar a priorizar a resposta. Especifique a descrição, os serviços, a gravidade e o título do incidente ao executar essa ferramenta.

Os prompts de exemplo incluem:

  • "Crie um incidente com o título 'Pico de latência do banco de dados', descrição 'Alta latência observada nas leituras do SQL', serviços 'payments-api, auth-service', severidade 'alta', agente 'sre-agent-westus'."
Parâmetro Obrigatório ou opcional Descrição
Description Obrigatório Uma descrição para o item do Agente SRE.
Serviços Obrigatório Nomes de serviço afetados.
Severity Obrigatório Gravidade do incidente: crítico, alto, médio ou baixo.
Título Obrigatório Título do incidente.
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ❌ ❌ ❌ ❌ ❌

Incidentes: Criar plano

Essa ferramenta cria e habilita um plano de resposta a incidentes que usa um filtro para definir incidentes de escopo e um manipulador para definir as etapas de resposta. Especifique metadados de plano, os serviços a serem monitorados, a gravidade, as etapas de resposta e uma condição de gatilho. Essa ferramenta valida a entrada e ativa o plano para que ele comece a lidar com incidentes correspondentes.

Os prompts de exemplo incluem:

  • "Crie e habilite um plano de resposta a incidentes com Nome 'db-failover-plan', Serviços 'payments-api', Severidade 'critical', Etapas 'notificar plantão;executar failover do banco de dados' e Condição de acionamento 'conexão com o banco de dados perdida'."
Parâmetro Obrigatório ou opcional Descrição
Name Obrigatório O nome do item do Agente SRE.
Serviços Obrigatório Nomes de serviço afetados.
Severity Obrigatório Gravidade do incidente: crítico, alto, médio ou baixo.
Etapas Obrigatório Etapas de resposta a incidentes.
Obrigatório Texto que dispara o plano de resposta a incidentes.
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Modo de agente Optional Modo de agente: autônomo ou revisão.
Escalonamento Optional Procedimento de escalonamento.
Runbook URL Optional URL do runbook.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ❌ ❌ ❌ ❌ ❌

Incidentes: Listar planos

Essa ferramenta lista os planos de resposta a incidentes configurados em um agente SRE. Você pode exibir o nome, a ID e o status de cada plano. Essas informações ajudam você a identificar planos ativos e a examinar a configuração.

Os prompts de exemplo incluem:

  • Liste os planos de resposta a incidentes configurados no agente SRE 'sre-agent-prod'.
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Incidentes: Conectar o agente ao PagerDuty

Conecte um agente de SRE (engenharia de confiabilidade do site) ao PagerDuty. Essa ferramenta cria um conector do PagerDuty que permite o alerta de incidentes e o gerenciamento de incidentes. O conector usa uma chave de API armazenada em uma variável de ambiente.

Os prompts de exemplo incluem:

  • "Conecte o Agente SRE 'sre-agent-prod' ao PagerDuty usando a variável de ambiente da chave de API 'PAGERDUTY_API_KEY' e o nome 'pagerduty-connector'."
Parâmetro Obrigatório ou opcional Descrição
Variável de ambiente da chave de API Obrigatório Variável de ambiente que contém a chave de API.
Name Obrigatório O nome do item do Agente SRE.
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Subdomínio Optional Subdomínio PagerDuty.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ❌ ✅ ❌

Incidentes: Configurar o conector do ServiceNow

Essa ferramenta cria um conector MCP do ServiceNow que permite a integração de gerenciamento de incidentes. Ele usa credenciais armazenadas em variáveis de ambiente e permite a criação, atualizações e resolução de incidentes entre o ServiceNow e o Agente SRE.

Os prompts de exemplo incluem:

  • "Conecte o Agente SRE ao ServiceNow com o tipo de autenticação 'basic', a URL da instância 'https://my-resource.service-now.com', o nome 'sre-agent-prod'."
Parâmetro Obrigatório ou opcional Descrição
Tipo de autenticação Obrigatório O tipo de autenticação do conector HTTP MCP.
URL da instância Obrigatório URL da instância do ServiceNow.
Name Obrigatório O nome do item do Agente SRE.
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Variável de ambiente da senha Optional Variável de ambiente que contém senha.
Env de token Optional Variável de ambiente que contém o token de portador.
Nome de usuário env Optional Variável de ambiente que contém o nome de usuário.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ❌ ✅ ❌

Tarefas agendadas: criar tarefa agendada

Essa ferramenta cria uma tarefa agendada para um agente SRE. Ele envia uma mensagem especificada na agenda que você define com uma expressão cron, para que o agente possa executar o trabalho automatizado. Você fornece os detalhes da tarefa ao criar a tarefa agendada.

Os prompts de exemplo incluem:

  • Agende uma tarefa recorrente no SRE Agent 'sre-agent-west' para ser executada toda segunda-feira com a expressão cron '0 9 * * 1', nome 'weekly-restart' e mensagem 'Reiniciar serviço'.
Parâmetro Obrigatório ou opcional Descrição
Expressão Cron Obrigatório A expressão cron usada para definir o agendamento.
Mensagem Obrigatório O prompt executado pelo agente no agendamento configurado.
Name Obrigatório O nome do item do Agente SRE.
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Description Optional Uma descrição para o item do Agente SRE.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ❌ ✅ ❌ ❌ ❌

Tarefas agendadas: excluir tarefa agendada

Essa ferramenta exclui uma tarefa agendada do Agente SRE.

Os prompts de exemplo incluem:

  • "Exclua a tarefa agendada 'task-12345' do Agente SRE 'sre-agent-west' com confirmação 'true'."
Parâmetro Obrigatório ou opcional Descrição
ID da Tarefa Obrigatório A ID da tarefa agendada.
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Confirmar Obrigatório Confirme uma ação destrutiva.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
✅ ❌ ❌ ❌ ❌ ❌

Tarefas agendadas: Obter tarefa agendada

Essa ferramenta recupera uma tarefa agendada do Agente SRE por ID da tarefa. Você pode exibir detalhes, como a configuração da tarefa e o status atual.

Os prompts de exemplo incluem:

  • "Exiba a tarefa agendada com o ID 'task-1234' no Agente SRE 'sre-agent-west'."
Parâmetro Obrigatório ou opcional Descrição
ID da Tarefa Obrigatório A ID da tarefa agendada.
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Tarefas agendadas: listar tarefas agendadas

Essa ferramenta lista as tarefas agendadas gerenciadas pelo Agente SRE. Você pode inspecionar trabalhos agendados, confirmar agendas e exibir metadados de tarefa, como status, tempo de execução e última execução. Esta ferramenta retorna uma lista somente para leitura de tarefas agendadas com campos como nome da tarefa, status, agendamento, próxima hora de execução e última hora de execução.

Os prompts de exemplo incluem:

  • "Liste as tarefas agendadas no SRE Agent 'sre-agent-01'."
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Tarefas agendadas: pausar a tarefa agendada

Interrompe temporariamente uma tarefa agendada de um agente de Engenharia de Confiabilidade de Site (SRE). Essa ferramenta retorna o status atualizado da tarefa e os metadados relacionados. Pausar tarefas agendadas para interromper temporariamente a atividade automatizada durante a manutenção ou solução de problemas.

Os prompts de exemplo incluem:

  • "Pause a tarefa agendada com o ID 'task-1234' no Agente SRE 'sre-agent-west'."
Parâmetro Obrigatório ou opcional Descrição
ID da Tarefa Obrigatório A ID da tarefa agendada.
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ❌ ❌ ❌

Tarefas agendadas: retomar a tarefa agendada

Essa ferramenta retoma uma tarefa agendada para um Agente SRE. Depois de executar a ferramenta, o agente retomará a execução da tarefa agendada de acordo com sua agenda.

Os prompts de exemplo incluem:

  • "Retome a tarefa agendada com o ID 'task-123' no Agente SRE 'sre-agent-west'."
Parâmetro Obrigatório ou opcional Descrição
ID da Tarefa Obrigatório A ID da tarefa agendada.
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ❌ ❌ ❌

Habilidades: Criar habilidade

Essa ferramenta cria ou atualiza uma habilidade personalizada em um recurso do Agente SRE de destino.

Os prompts de exemplo incluem:

  • Adicione uma nova habilidade com o nome 'auto-scale-skill' ao agente SRE 'sreagent-prod' com o conteúdo '{"type":"script","script":"scale.sh"}'.
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Conteúdo Obrigatório Conteúdo de habilidades.
Name Obrigatório O nome do item do Agente SRE.
Description Optional Uma descrição para o item do Agente SRE.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
✅ ✅ ❌ ❌ ❌ ❌

Skills: excluir skill

Essa ferramenta exclui uma habilidade personalizada de um recurso do Agente SRE.

Os prompts de exemplo incluem:

  • "Exclua a skill chamada 'error-logger' do Agente SRE 'sre-agent-west' com confirmação 'true'."
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Name Obrigatório O nome do item do Agente SRE.
Confirmar Obrigatório Confirme uma ação destrutiva.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
✅ ✅ ❌ ❌ ❌ ❌

Habilidades: Listar habilidades

Lista habilidades personalizadas em um recurso de agente SRE de destino. A ferramenta retorna detalhes para cada habilidade personalizada registrada no Agente SRE especificado, incluindo nome, versão e status. Use a saída para examinar ou auditar as configurações de habilidades personalizadas.

Os prompts de exemplo incluem:

  • "Informe todas as skills disponíveis no Agente SRE 'sre-agent-prod'."
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Tópicos: Criar tópico

Essa ferramenta cria um novo thread em um Agente de Engenharia de Confiabilidade do Site (SRE) e inicia uma conversa enviando a mensagem de abertura. Retorna a resposta inicial do agente.

Os prompts de exemplo incluem:

  • Inicie uma nova conversa com o agente SRE 'sre-agent-01' com a mensagem 'Investigue o aumento da latência no gateway de API'.
Parâmetro Obrigatório ou opcional Descrição
Mensagem Obrigatório A mensagem a ser enviada.
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ❌ ✅ ❌ ❌ ❌

Threads: Excluir tópico

Esta ferramenta remove uma thread de um agente de Engenharia de Confiabilidade de Site (SRE).

Os prompts de exemplo incluem:

  • "Exclua a thread com ID 'thread-12345' do Agente SRE 'sreagent-prod' com confirmação 'true'."
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Confirmar Obrigatório Confirme uma ação destrutiva.
Thread ID Obrigatório O identificador da thread do Agente SRE.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
✅ ❌ ❌ ❌ ❌ ❌

Threads: obter mensagens

Essa ferramenta obtém mensagens para um thread específico do Agente SRE e retorna o conteúdo e os metadados da mensagem, como carimbos de data/hora e identidade do remetente. Use as mensagens retornadas para examinar o histórico de conversas ou solucionar problemas de comportamento do agente.

Os prompts de exemplo incluem:

  • "Mostre as mensagens da thread com ID '42' no Agente SRE 'sre-agent-prod'."
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Thread ID Obrigatório O identificador da thread do Agente SRE.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Threads: modo YOLO

Essa ferramenta inicia uma investigação sobre o Agente SRE especificado e concede todas as aprovações pendentes, de modo que o agente prossiga sem portões de aprovação humana. A ferramenta registra ações de investigação e concede aprovações para auditoria.

Os prompts de exemplo incluem:

  • "Investigue usando a mensagem 'Investigar falha de serviço no frontend' no Agente SRE 'sre-agent-prod' no modo YOLO, concedendo automaticamente todas as aprovações pendentes."
Parâmetro Obrigatório ou opcional Descrição
Mensagem Obrigatório A mensagem a ser enviada.
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Iterações máximas Optional O número máximo de iterações de acompanhamento automático.
Segundos de tempo limite Optional O tempo limite da investigação, em segundos.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ❌ ✅ ❌ ❌ ❌

Threads: Investigar incidente

Investigue um problema ou incidente com um agente de SRE (Engenharia de Confiabilidade do Site). Use essa ferramenta para enviar uma mensagem de investigação e o agente faz perguntas de acompanhamento até que a investigação seja concluída. Você fornece os detalhes da investigação na mensagem. Inclua contexto relevante, como recursos afetados, marcas de data e hora, mensagens de erro, alterações recentes na configuração e etapas para reproduzir o problema. Mantenha as mensagens concisas e focadas para ajudar o agente a chegar a uma resolução com mais eficiência.

Os prompts de exemplo incluem:

  • "Investigue o seguinte problema com o agente SRE 'sre-agent-prod': mensagem 'API primária retornando 500 erros após a implantação'."
Parâmetro Obrigatório ou opcional Descrição
Mensagem Obrigatório A mensagem a ser enviada.
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Iterações máximas Optional O número máximo de iterações de acompanhamento automático.
Segundos de tempo limite Optional O tempo limite da investigação, em segundos.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ❌ ✅ ❌ ❌ ❌

Threads: listar threads de conversa do agente

Essa ferramenta lista os threads de chat do Agente SRE. Ele retorna uma lista somente de leitura de objetos de conversa, incluindo o ID da conversa, os participantes, os metadados e a mensagem mais recente, para que você possa revisar conversas ativas e anteriores.

Os prompts de exemplo incluem:

  • "Informe as threads ativas no Agente SRE 'sreagent-prod'."
Parâmetro Obrigatório ou opcional Descrição
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Threads: Enviar mensagem para o thread

Esta ferramenta envia uma mensagem para uma thread existente de um agente de Engenharia de Confiabilidade de Site (SRE). Ele posta a mensagem especificada no thread e retorna o estado atualizado do thread. Use mensagens concisas para adicionar contexto, atualizações de status ou notas de solução de problemas a um thread em andamento.

Os prompts de exemplo incluem:

  • "Envie a mensagem 'Reinicialização concluída, monitorando logs' para a thread com ID 'thread-12345' no agente 'sre-agent-westus'."
Parâmetro Obrigatório ou opcional Descrição
Mensagem Obrigatório A mensagem a ser enviada.
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.
Thread ID Obrigatório O identificador da thread do Agente SRE.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ❌ ✅ ❌ ❌ ❌

Fluxos de trabalho: aplicar e implantar fluxo de trabalho

Aplicar e implantar um fluxo de trabalho YAML em um agente SRE. Esta ferramenta carrega e ativa uma configuração YAML do ExtendedAgent ou ExtendedAgentTool no recurso Agente SRE informado.

Os prompts de exemplo incluem:

  • "Aplique o YAML do fluxo de trabalho com o conteúdo 'apiVersion: sre/v1\nkind: ExtendedAgent\nmetadata:\n name: deploy-workflow' ao Agente SRE 'sre-agent-prod'."
Parâmetro Obrigatório ou opcional Descrição
Conteúdo YAML Obrigatório Conteúdo YAML.
Agente Obrigatório O nome do recurso do Azure SRE Agent a ser usado como destino.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ❌ ❌ ❌

Fluxos de trabalho: gerar definição de fluxo de trabalho

Gere uma definição de fluxo de trabalho YAML para uma ferramenta ou agente de SRE (engenharia de confiabilidade de site) específico. Essa ferramenta cria uma configuração YAML validada para ExtendedAgent, KustoToole LinkTool recursos. O fluxo de trabalho gerado ajuda você a implantar e gerenciar ferramentas do Agente SRE de forma consistente entre ambientes.

Os prompts de exemplo incluem:

  • Gere um workflow YAML com a descrição 'Ferramenta de consulta Kusto para busca de incidentes', tipo 'tool', nome 'kusto-search-tool'.
Parâmetro Obrigatório ou opcional Descrição
Description Obrigatório Uma descrição para o item do Agente SRE.
Kind Obrigatório Tipo YAML: agente ou ferramenta.
Name Obrigatório O nome do item do Agente SRE.
Conector Optional O nome do conector usado pelas ferramentas Kusto.
Nome do banco de dados Optional O banco de dados utilizado pelas ferramentas Kusto.
Modelo ou tipo Optional Tipo de ferramenta, como KustoTool ou LinkTool.
Parâmetros Optional Parâmetros no formato nome:descrição.
Query Optional A consulta Kusto usada pelas ferramentas Kusto.
Ferramentas Optional Nomes de ferramentas a serem anexados. Há suporte para vários valores.
Transferências Optional Nomes de transferência de subagentes. Há suporte para vários valores.
Modelo de URL Optional O modelo de URL para ferramentas de links.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Fluxos de trabalho: validar fluxo de trabalho

Essa ferramenta valida o YAML do fluxo de trabalho do Agente SRE e sinaliza problemas comuns na estrutura e na sintaxe. Ele verifica se há YAML inválido, etapas malformadas, cadeias de caracteres incorretas run e chaves necessárias ausentes. Você fornece YAML contente a ferramenta retorna problemas identificados com números de linha e correções sugeridas. Consulte o exemplo a seguir para obter um erro típico que a ferramenta detecta.

Os prompts de exemplo incluem:

  • Valide o seguinte conteúdo YAML do workflow do agente SRE 'apiVersion: sre/v1\nkind: ExtendedAgent\nmetadata:\n name: deploy-workflow'.
Parâmetro Obrigatório ou opcional Descrição
Conteúdo YAML Obrigatório Conteúdo YAML.

Dicas para anotação de ferramentas:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Conteúdo relacionado

  • Last updated on