Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
O Servidor MCP do Azure ajuda-o a gerir recursos do Azure SRE Agent, incluindo: ativar, adicionar, aplicar, criar, desativar, eliminar, gerar, obter, investigar, kusto, listar, mcp, mensagem, pagerduty, pausar, planear, reindexar, retomar, pesquisar, ServiceNow, testar, validar e yolo, através de instruções em linguagem natural.
O Azure SRE Agent é um assistente de fiabilidade alimentado por IA que ajuda as equipas a diagnosticar e resolver problemas de produção, reduzir o trabalho operacional e diminuir o tempo médio até à resolução (MTTR). Para mais informações, consulte Azure SRE Agent documentation.
Observação
Parâmetros de ferramenta: As ferramentas do Azure MCP Server definem parâmetros para os dados necessários para concluir tarefas. Alguns destes 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 da ferramenta.
Agentes: Criar ou atualizar um subagente
Esta ferramenta cria ou atualiza um subagente num recurso de Agente SRE direcionado. Especifique a subscrição, o agente e o nome para identificar o subagente. A ferramenta aplica alterações idempotentemente, para que pedidos repetidos com os mesmos valores não criem duplicados. Forneça os parâmetros necessários para criar ou atualizar o subagente.
Exemplos de prompts incluem:
- "Cria um subagente com o nome 'subagente-01' em SRE Agent 'sre-agent-prod'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Nome | Obrigatório | O nome do item do Agente SRE. |
| Description | Opcional | Uma descrição do item SRE Agent. |
| Instruções | Opcional | Instruções para o subagente. |
| Tools | Opcional | Nomes de ferramentas para anexar. São suportados múltiplos valores. |
| Transferências | Opcional | Nomes de transferência entre subagentes. São suportados múltiplos valores. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Agentes: Eliminar um subagente
Esta ferramenta remove um subagente de um recurso de Agente SRE especificado.
Exemplos de prompts incluem:
- "Apagar o subagente chamado 'agente de telemetria' do Agente SRE 'prod-sre' na subscrição '12345-abcde' com confirmar 'verdadeiro'."
- Elimine o subagente 'backup-monitor' do agente SRE 'staging-sre' da subscrição 'my-subscription-id' com confirmação 'true'.
- "Apagar o nome do subagente 'subagente-01' do Agente SRE 'sre-agent-prod' com confirmar 'verdadeiro'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Nome | Obrigatório | O nome do item do Agente SRE. |
| Confirmar | Obrigatório | Confirma uma operação destrutiva. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Agentes: Obtenha detalhes de configuração
Mostrar os detalhes de configuração de um Agente SRE nomeado. Esta ferramenta devolve o endpoint, estado de provisionamento, localização e definições para o Agente SRE especificado. Pode filtrar os resultados por grupo de recursos.
Exemplos de prompts incluem:
- Mostrar detalhes do Agente SRE 'sre-agent-north' no grupo de recursos 'rg-sre-prod'.
- "Verifica a configuração do Agente SRE 'sre-agent-eastus' no grupo de recursos 'prod-rg'."
- "Mostrar o endpoint e o estado de provisionamento para o SRE Agent 'ops-agent-west' através da subscrição especificada."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Agentes: Listar recursos
Esta ferramenta lista os recursos do Azure SRE Agent. Pode filtrar os resultados por grupo de recursos. Cada resultado inclui name, id, location, resourceGroup, provisioningState, e endpoint. Se a ferramenta não encontrar recursos do Agente SRE, devolve uma lista vazia.
Exemplos de prompts incluem:
- "Liste os recursos do Agente Azure SRE na minha subscrição."
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Ferramentas de agentes: Criar ou atualizar ferramentas personalizadas
Esta ferramenta cria ou atualiza uma ferramenta personalizada num recurso de Agente SRE alvo. Especifica o agente, nome e tipo de ferramenta. Se existir uma ferramenta com o nome especificado, essa ferramenta atualiza a sua configuração; caso contrário, cria uma nova ferramenta. Forneça valores de configuração de acordo com a tabela de parâmetros.
Exemplos de prompts incluem:
- "Crie a ferramenta personalizada 'log-collector' no agente 'sre-agent-prod' na subscrição 'contoso-sub' com o tipo de ferramenta 'collector'."
- "Crie uma ferramenta personalizada com o nome 'custom-kusto-tool', tipo de ferramenta 'KustoTool', no SRE Agent 'sre-agent-prod'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Nome | Obrigatório | O nome do item do Agente SRE. |
| Tipo de ferramenta | Obrigatório | O tipo de ferramenta personalizada, como KustoTool ou LinkTool. |
| Conector | Opcional | O nome do conector para as ferramentas Kusto. |
| Nome da base de dados | Opcional | A base de dados Kusto para as ferramentas Kusto. |
| Description | Opcional | Uma descrição do item SRE Agent. |
| Parâmetros | Opcional | Array JSON de definições de parâmetros de ferramenta. |
| Query | Opcional | A consulta Kusto para ferramentas Kusto. |
| modelo de URL | Opcional | O modelo de URL para ferramentas de links. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Ferramentas para agentes: Obtenha definição personalizada de ferramentas
Obtém uma definição personalizada de uma ferramenta de um recurso específico do Agente SRE. Esta ferramenta requer os parâmetros do agente e do nome e devolve a definição personalizada da ferramenta para o agente e nome especificados.
Exemplos de prompts incluem:
- "Obtenha a definição de nome de ferramenta personalizada 'deploy-helper' do SRE Agent 'sre-agent-prod'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Nome | Obrigatório | O nome do item do Agente SRE. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Ferramentas do agente: Listar ferramentas
Esta ferramenta lista ferramentas personalizadas num recurso direcionado para o SRE Agent. Devolve o nome, a versão e o estado de cada ferramenta personalizada, para que possas verificar implementações e resolver problemas.
Exemplos de prompts incluem:
- Liste as ferramentas personalizadas do agente SRE 'sre-agent-prod'.
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Arquitetura: Planeia uma arquitetura
Planeie e gere a arquitetura de um agente de engenharia de fiabilidade de sites (SRE). Esta ferramenta analisa os seus requisitos e produz um design estruturado para agentes, ferramentas, conectores e gatilhos. Fornece requisitos e restrições de alto nível, e esta ferramenta devolve responsabilidades de componentes, padrões de interação, considerações de implementação, recomendações de segurança e controlo de acessos, e sugestões de observabilidade. Use o resultado para orientar a implementação, seleção de ferramentas e planeamento da integração.
As saídas incluem:
- Uma lista de componentes com responsabilidades e limites.
- Definições de conectores e gatilhos para integrações.
- Considerações de implementação e escalabilidade, incluindo recomendações regionais e de orquestração.
- Orientações sobre segurança e controlo de acesso baseado em funções (RBAC).
- Observabilidade e padrões de resposta a incidentes, incluindo sugestões de monitorização e alerta.
Exemplos de prompts incluem:
- Planeie uma arquitetura de um agente SRE para os requisitos de "observabilidade multicliente com triagem automática de incidentes e integração com o Kusto".
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Requisitos | Obrigatório | Requisitos de arquitetura. |
| Conector Kusto | Opcional | Nome do conector Kusto. |
| Tipo de acionador | Opcional | Tipo de gatilho, como manual ou programado. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Prompts comuns: Crie ou atualize um prompt
Esta ferramenta cria ou atualiza um prompt comum com nome no Agente SRE. Guarda modelos de prompts reutilizáveis, permitindo que as equipas centralizem orientações e reduzam duplicações. A ferramenta devolve o objeto de prompt criado ou atualizado.
Exemplos de prompts incluem:
- "Crie um prompt comum com o nome 'reiniciar-serviço' e o conteúdo 'Descreva como reiniciar o serviço da aplicação durante um incidente' no SRE Agent 'sre-agent-prod'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Content | Obrigatório | O conteúdo do prompt. |
| Nome | Obrigatório | O nome do item do Agente SRE. |
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |
Prompts comuns: Apagar um prompt
Esta ferramenta remove permanentemente, de um Agente SRE, o prompt identificado pelo nome. Confirmas a eliminação antes de a ferramenta apagar a definição do prompt. Esta ação não é reversível.
Exemplos de prompts incluem:
- "Eliminar permanentemente o nome comum do prompt 'cpu-throttle-guidance' do Agente SRE 'sre-agent-westus' com confirmar 'verdadeiro'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Nome | Obrigatório | O nome do item do Agente SRE. |
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Confirmar | Obrigatório | Confirma uma operação destrutiva. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Prompts comuns: Obtenha texto de prompt
Esta ferramenta mostra o texto completo de um prompt comum específico identificado pelo nome num agente de engenharia de fiabilidade de sites (SRE). Introduz o nome, e esta ferramenta devolve-lhe o texto do prompt para que possa inspecionar ou auditar prompts para efeitos de depuração ou revisão.
Exemplos de prompts incluem:
- "Mostra-me o prompt comum com o nome 'deployment-checklist' no SRE Agent 'sre-agent-westus'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Nome | Obrigatório | O nome do item do Agente SRE. |
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Prompts comuns: Lista de prompts
Esta ferramenta lista todos os prompts comuns disponíveis num Agente SRE. Devolve uma coleção de nomes e descrições de prompts registados. Os resultados ajudam-no a descobrir os prompts disponíveis e a rever as suas descrições.
Exemplos de prompts incluem:
- Liste os prompts comuns para o agente SRE 'sre-agent-prod'.
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Pesquisar | Opcional | Filtro de pesquisa opcional. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Conectores: Criar ou atualizar o conector Kusto
Esta ferramenta cria ou atualiza um conector para o Azure Data Explorer (Kusto) num recurso Azure SRE Agent. O conector permite ao agente ingerir e consultar dados de um cluster do Azure Data Explorer.
Exemplos de prompts incluem:
- "Crie um conector Kusto no SRE Agent 'sre-agent-01' com URL do cluster 'https://my-resource.eastus.kusto.windows.net' e nomeie 'kusto-connector-prod'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Cluster URL | Obrigatório | O URL do cluster do Azure Data Explorer. |
| Nome | Obrigatório | O nome do item do Agente SRE. |
| Nome da base de dados | Opcional | A base de dados Kusto para as ferramentas Kusto. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Conetores: Criar ou atualizar conetor
Esta ferramenta cria ou atualiza um conector num recurso Azure SRE Agent. Especificas o agente, o nome do conector e o tipo de conector. Também pode fornecer credenciais de ligação e definições adicionais de configuração. Em caso de sucesso, esta ferramenta devolve o recurso do conector.
Siga as convenções de nomenclatura do Azure para nomes de recursos e assegure que as permissões de controlo de acesso baseado em funções (RBAC) permitam atualizações de conectores. Use nomes realistas, como sre-agent-prod para o agente e rg-sre-prod para o grupo de recursos.
Exemplos de prompts incluem:
- "Crie um conector MCP no SRE Agent 'sreagent-prod' com o nome 'mcp-connector' e tipo 'http'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Nome | Obrigatório | O nome do item do Agente SRE. |
| Type | Obrigatório | O tipo de conector MCP: stdio ou http. |
| Argumentos | Opcional | Argumentos a favor dos conectores stdio MCP. |
| Tipo de autenticação | Opcional | O tipo de autenticação do conector HTTP MCP. |
| Token portador env | Opcional | Variável de ambiente que contém o token portador. |
| Command | Opcional | O comando para conectores stdio MCP. |
| Ponto final | Opcional | O ponto final do conector HTTP MCP. |
| Envs JSON | Opcional | Objeto JSON de variáveis de ambiente para conectores MCP stdio. |
| Cabeçalhos JSON | Opcional | Objeto JSON dos cabeçalhos HTTP. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ | ✅ | ❌ |
Conectores: Eliminar conector
Esta ferramenta elimina um conector de um recurso do Azure SRE Agent.
Exemplos de prompts incluem:
- "Apagar o conector 'metrics-collector' do Agente SRE 'sre-agent-prod' com confirmar 'verdadeiro'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Nome | Obrigatório | O nome do item do Agente SRE. |
| Confirmar | Obrigatório | Confirma uma operação destrutiva. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Conectores: Obtenha detalhes dos conectores
Esta ferramenta recupera detalhes de um conector que configura num recurso Azure SRE Agent. Pode visualizar as propriedades, configuração e estado do conector para ajudar a diagnosticar ou documentar o conector. Especifique os parâmetros do agente e do nome para identificar o recurso do Agente Azure SRE e o conector.
Exemplos de prompts incluem:
- "Mostra os detalhes do conector 'github-connector' no SRE Agent 'sre-agent-prod'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Nome | Obrigatório | O nome do item do Agente SRE. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Conectores: Listar conectores
Esta ferramenta lista os conectores que configuras num recurso Azure SRE Agent. Devolve nomes de conectores, tipos de conectores e estado de registo para que possa rever integrações e resolver problemas.
Exemplos de prompts incluem:
- "Lista os conectores configurados no Agente SRE 'sreagent-prod'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Conectores: Conector de teste
Esta ferramenta testa um conector e lista as ferramentas que o conector expõe. Pode verificar a conectividade dos conectores e inspecionar as ferramentas disponíveis, incluindo o nome e as capacidades de cada ferramenta. Para testar um conector, indique os parâmetros agent e name.
Exemplos de prompts incluem:
- "Teste o nome do conector 'my-connector' no Agente SRE 'sre-agent-prod' e liste as suas ferramentas."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Nome | Obrigatório | O nome do item do Agente SRE. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ✅ | ✅ | ❌ | ❌ |
Documentação: Obtenha documentação de referência
Esta ferramenta devolve documentação de referência para os conceitos de Agente de Engenharia de Fiabilidade do Site (SRE). Pode obter definições, detalhes de configuração e exemplos de utilização para tópicos de SRE Agent, como alertas, resposta a incidentes, verificações de saúde e telemetria. Especifique o tema para obter a entrada de referência do tema.
Exemplos de prompts incluem:
- "Mostra-me a documentação do Agente SRE para o tema 'incidente-resposta'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Topic | Obrigatório | Tema de documentação. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Memórias de documentação: Adicionar documento à base de conhecimento
Esta ferramenta adiciona um documento à base de conhecimento do agente SRE pelo respetivo nome. Carrega conteúdo em Markdown (*.md) e a ferramenta indexa-o para recuperação de conhecimento com base em geração aumentada por recuperação (RAG). Use nomes claros e descritivos para encontrar facilmente os documentos.
Exemplos de prompts incluem:
- "Adicione um documento chamado 'incidente-runbook' com o conteúdo 'Runbook: passos para triagem de falhas de serviço e contacto de plantão' à base de conhecimento do Agente SRE."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Content | Obrigatório | O conteúdo do documento para adicionar à base de conhecimento. |
| Nome | Obrigatório | O nome do item do Agente SRE. |
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
Memórias de documentação: Eliminar documento da base de conhecimento
Especifique o documento pelo nome. Esta ferramenta elimina um documento da base de conhecimento depois de confirmar. A eliminação é permanente e não pode ser desfeita. Confirme que o documento existe antes de executar esta ferramenta.
Exemplos de prompts incluem:
- "Eliminar o nome do documento da base de conhecimento 'sre-kb-doc-01' do Agente SRE 'sre-agent-westus' com confirmar 'verdadeiro'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Nome | Obrigatório | O nome do item do Agente SRE. |
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Confirmar | Obrigatório | Confirma uma operação destrutiva. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Memórias de documentação: Listar documentos indexados da base de conhecimento
Esta ferramenta lista todos os documentos indexados da base de conhecimento que um Agente SRE armazena na memória. Devolve todos os nomes de documentos e os seus metadados, sem filtro de pesquisa ou consulta. Navegar pela base de conhecimento completa ajuda-o a descobrir documentos disponíveis antes de realizar pesquisas direcionadas.
Exemplos de prompts incluem:
- "Obtenha uma lista completa de todos os documentos indexados da base de conhecimento armazenados na memória 'sre-agent-prod' do SRE Agent sem filtragem."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Memórias de documentação: Reindexar a base de conhecimento
Esta ferramenta desencadeia um reíndice de uma base de conhecimento. Use-o para reprocessar documentos armazenados, atualizar embeddings e reconstruir índices de pesquisa para que os resultados reflitam alterações recentes no conteúdo e nos metadados. O tempo de reindexação depende do tamanho do conjunto de dados e da carga do servidor. Pode demorar minutos ou mais. Depois de iniciar a ferramenta, monitorize o progresso do reindex usando os endpoints de gestão do servidor.
Exemplos de prompts incluem:
- "Reindexe os documentos da base de conhecimento para o Agente SRE 'sre-agent-westus'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
Memórias de documentação: Pesquisar na base de conhecimento
Esta ferramenta pesquisa a base de conhecimento do SRE Agent usando pesquisa semântica e retorna os documentos mais relevantes para a sua consulta. Ajuda-te a encontrar passos para resolver problemas, procedimentos operacionais, análises pós-incidente e guias de monitorização relacionados com incidentes ou alertas.
Exemplos de prompts incluem:
- "Procure na base de conhecimento do Agente SRE por 'latência de entrada e saída do disco'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Query | Obrigatório | A consulta de pesquisa é usada para encontrar documentos relevantes da base de conhecimento. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Ganchos: Eliminar gancho
Esta ferramenta elimina um hook de um recurso do Azure SRE Agent.
Exemplos de prompts incluem:
- Eliminar o gancho com o nome 'backup-trigger' do agente SRE 'sre-agent-prod' com confirmação 'true'.
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Nome | Obrigatório | O nome do item do Agente SRE. |
| Confirmar | Obrigatório | Confirma uma operação destrutiva. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Ganchos: Obtenha detalhes
Esta ferramenta devolve detalhes de um hook que configura num recurso Azure SRE Agent. Pode rever a configuração do hook, verificar o seu estado atual e confirmar as definições de acionamento ou os pontos finais de destino.
Exemplos de prompts incluem:
- "Mostra-me os detalhes do gancho 'deploy-hook' no Agente SRE 'sre-agent-prod'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Nome | Obrigatório | O nome do item do Agente SRE. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Ganchos: Lista de ganchos
Lista ganchos configurados num recurso Azure SRE Agent. Use esta ferramenta para visualizar nomes de ganchos, tipos de ganchos e o seu estado atual para um agente específico. Utilize o resultado para inspecionar os hooks de implantação, monitorização e limpeza aplicáveis ao Agent.
Exemplos de prompts incluem:
- "Lista os ganchos configurados para o Agente SRE 'sre-agent-prod'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Ganchos: Ativar o fio do gancho
Esta ferramenta ativa um hook on-demand para um tópico num recurso do Azure SRE Agent. Isto aciona imediatamente as ações configuradas no hook.
Exemplos de prompts incluem:
- Ativar o gancho 'health-check' na thread 'thread-42' do Agente SRE 'sreagent-prod'.
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Nome do gancho | Obrigatório | O nome do gancho. |
| Thread ID | Obrigatório | O ID do tópico do Agente SRE. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Ganchos: Desativar o fio do anzol
Esta ferramenta desativa um hook on-demand para um thread num recurso do Azure SRE Agent. Forneces o agente, o nome do hook e o ID do thread para identificar o hook e o thread alvo. A ferramenta impede a execução do hook na thread especificada sem remover a configuração do hook. Precisas de permissões apropriadas no recurso Azure SRE Agent para aplicar a alteração.
Exemplos de prompts 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 |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Nome do gancho | Obrigatório | O nome do gancho. |
| Thread ID | Obrigatório | O ID do tópico do Agente SRE. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Ganchos: Listar o estado do fio do anzol
Esta ferramenta lista o estado de ativação do hook para um thread num recurso Azure SRE Agent. Devolve se os hooks estão ativados, desativados ou pendentes para a thread especificada. Use os resultados para verificar a configuração do hook e resolver o comportamento do thread.
Exemplos de prompts incluem:
- "Liste os estados de ativação do gancho para o ID de thread 'thread-42' no Agente SRE 'sre-agent-prod'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Thread ID | Obrigatório | O ID do tópico do Agente SRE. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Incidentes: Listar incidentes ativos
Esta ferramenta lista incidentes ativos num agente de engenharia de fiabilidade do site (SRE). Devolve tópicos de incidentes abertos com o título, estado, serviços afetados e detalhes da investigação. Use os resultados para rever investigações em curso e ver quais os serviços afetados.
Exemplos de prompts incluem:
- "Lista os incidentes ativos no SRE Agente 'sre-agent-west'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Incidentes: Criar incidente
Use esta ferramenta para criar um tópico de investigação de incidentes para um agente. Pode registar os detalhes do incidente, associar serviços afetados e definir a gravidade para ajudar a priorizar a resposta. Especifica a descrição do incidente, os serviços, a gravidade e o título quando executa esta ferramenta.
Exemplos de prompts incluem:
- Crie um incidente com o título 'Pico de latência da base de dados', descrição 'Alta latência observada nas leituras 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 do item SRE Agent. |
| Serviços | Obrigatório | Nomes de serviço afetados. |
| Severity | Obrigatório | Gravidade do incidente: crítica, alta, média ou baixa. |
| Título | Obrigatório | Título do incidente. |
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
Incidentes: Criar um plano
Esta ferramenta cria e ativa um plano de resposta a incidentes que utiliza um filtro para delimitar o âmbito dos incidentes e um processador para definir os passos da resposta. Especifique os metadados do plano, os serviços a monitorizar, a gravidade, os passos de resposta e uma condição de acionamento. Esta ferramenta valida a entrada e ativa o plano para começar a tratar incidentes emparelhados.
Exemplos de prompts incluem:
- "Criar e ativar plano de resposta a incidentes Nome 'db-failover-plan' Serviços 'payments-api' Gravidade 'crítico' Passos 'notificar em chamada; executar failover da base de dados' Condição de disparo 'ligação à base de dados perdida'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Nome | 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ítica, alta, média ou baixa. |
| Passos | Obrigatório | Passos de resposta a incidentes. |
| Condição do gatilho | Obrigatório | Texto que desencadeia o plano de resposta ao incidente. |
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Modo agente | Opcional | Modo agente: autónomo ou de revisão. |
| Escalamento | Opcional | Procedimento de escalonamento. |
| Runbook URL | Opcional | URL do Runbook. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
Incidentes: Lista de planos
Esta ferramenta lista planos de resposta a incidentes configurados num Agente SRE. Pode ver o nome, o ID e o estado de cada plano. Esta informação ajuda-o a identificar planos ativos e a rever a sua configuração.
Exemplos de prompts incluem:
- "Liste os planos de resposta a incidentes configurados no Agente SRE 'sre-agent-prod'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Incidentes: Associar o agente ao PagerDuty
Ligue um agente de engenharia de fiabilidade do site (SRE) ao PagerDuty. Esta ferramenta cria um conector PagerDuty que permite alertas e gestão de incidentes. O conector utiliza uma chave API armazenada numa variável de ambiente.
Exemplos de prompts incluem:
- "Ligue o SRE Agent 'sre-agent-prod' ao PagerDuty com a chave API env 'PAGERDUTY_API_KEY' e Nome 'pagerduty-connector'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| API key env | Obrigatório | Variável de ambiente que contém a chave API. |
| Nome | Obrigatório | O nome do item do Agente SRE. |
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Subdomínio | Opcional | Subdomínio PagerDuty. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ❌ | ✅ | ❌ |
Incidentes: Configurar o conector ServiceNow
Esta ferramenta cria um conector MCP ServiceNow que permite a integração na gestão de incidentes. Utiliza 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.
Exemplos de prompts incluem:
- "Liga o Agente SRE ao ServiceNow com tipo de autenticação 'basic', URL da instância 'https://my-resource.service-now.com', 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 ServiceNow. |
| Nome | Obrigatório | O nome do item do Agente SRE. |
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Password env | Opcional | Variável de ambiente que contém a palavra-passe. |
| Token env | Opcional | Variável de ambiente que contém o token de portador. |
| Nome de utilizador env | Opcional | Variável de ambiente que contém o nome de utilizador. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ❌ | ✅ | ❌ |
Tarefas agendadas: Criar tarefas agendadas
Esta ferramenta cria uma tarefa agendada para um Agente SRE. Envia uma mensagem especificada no horário que defines com uma expressão cron, para que o agente possa executar trabalho automatizado. Fornece os detalhes da tarefa quando cria a tarefa agendada.
Exemplos de prompts incluem:
- Agende uma tarefa recorrente no agente SRE 'sre-agent-west' que seja executada todas as segundas-feiras com a expressão cron '0 9 * * 1', nome 'weekly-restart' e mensagem 'Restart service'.
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Expressão de Cron | Obrigatório | A expressão cron para o agendamento. |
| Mensagem | Obrigatório | O prompt que o agente executa de acordo com a programação definida. |
| Nome | Obrigatório | O nome do item do Agente SRE. |
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Description | Opcional | Uma descrição do item SRE Agent. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
Tarefas agendadas: Eliminar tarefas agendadas
Esta ferramenta elimina uma tarefa agendada pelo Agente SRE.
Exemplos de prompts incluem:
- Elimine 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 | O ID da tarefa agendada. |
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Confirmar | Obrigatório | Confirma uma operação destrutiva. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
Tarefas agendadas: Obter tarefa agendada
Esta ferramenta recupera uma tarefa agendada do Agente SRE por ID de tarefa. Pode ver detalhes como a configuração da tarefa e o estado atual.
Exemplos de prompts incluem:
- "Mostra-me a tarefa agendada com o ID de tarefa 'task-1234' no SRE Agent 'sre-agent-west'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| ID da Tarefa | Obrigatório | O ID da tarefa agendada. |
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Tarefas agendadas: Liste tarefas agendadas
Esta ferramenta lista as tarefas agendadas que o Agente SRE gere. Pode inspecionar trabalhos agendados, confirmar agendamentos e visualizar metadados de tarefas como estado, próximo tempo de execução e último tempo de execução. Esta ferramenta devolve uma lista de tarefas agendadas apenas em leitura com campos para nome da tarefa, estado, agenda, próxima execução e última execução.
Exemplos de prompts incluem:
- "Liste as tarefas agendadas no Agente SRE 'sre-agent-01'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Tarefas agendadas: Pausar tarefas agendadas
Coloca em pausa uma tarefa agendada para um agente de engenharia de fiabilidade do site (SRE). Esta ferramenta devolve o estado atualizado da tarefa e os metadados relacionados. Pause as tarefas agendadas para interromper temporariamente a atividade automatizada durante a manutenção ou resolução de problemas.
Exemplos de prompts incluem:
- Pause a tarefa agendada com o ID de tarefa 'task-1234' no agente SRE 'sre-agent-west'.
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| ID da Tarefa | Obrigatório | O ID da tarefa agendada. |
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |
Tarefas agendadas: Retomar tarefas agendadas
Esta ferramenta retoma uma tarefa agendada para um Agente SRE. Depois de executar a ferramenta, o agente retoma a execução da tarefa agendada de acordo com o seu calendário.
Exemplos de prompts incluem:
- "Retomar a tarefa agendada com o ID de tarefa 'task-123' no SRE Agent 'sre-agent-west'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| ID da Tarefa | Obrigatório | O ID da tarefa agendada. |
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |
Competências: Criar competência
Esta ferramenta cria ou atualiza uma competência personalizada num recurso de Agente SRE direcionado.
Exemplos de prompts incluem:
- "Adicionar uma nova habilidade com o nome 'auto-scale-skill' ao SRE Agent 'sreagent-prod' com conteúdo '{"type":"script","script":"scale.sh"}'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Content | Obrigatório | Conteúdo de habilidades. |
| Nome | Obrigatório | O nome do item do Agente SRE. |
| Description | Opcional | Uma descrição do item SRE Agent. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Competências: Eliminar competência
Esta ferramenta elimina uma habilidade personalizada de um recurso SRE Agent.
Exemplos de prompts incluem:
- Elimina a habilidade com o nome 'error-logger' do Agente SRE 'sre-agent-west' com confirmação 'true'.
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Nome | Obrigatório | O nome do item do Agente SRE. |
| Confirmar | Obrigatório | Confirma uma operação destrutiva. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Competências: Lista de competências
Lista competências personalizadas num recurso direcionado para Agentes SRE. A ferramenta devolve detalhes de cada habilidade personalizada registada no Agente SRE especificado, incluindo nome, versão e estado. Use o resultado para rever ou auditar configurações personalizadas de competências.
Exemplos de prompts incluem:
- "Lista todas as competências disponíveis no SRE Agent 'sre-agent-prod'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Tópicos: Criar tópico
Esta ferramenta cria uma nova conversa com um agente de Engenharia de Fiabilidade de Sites (SRE) e inicia a conversa ao enviar a mensagem inicial. Devolve a resposta inicial do agente.
Exemplos de prompts incluem:
- "Inicie um novo tópico no SRE Agent 'sre-agent-01' com a mensagem 'Investigar aumento da latência no gateway da API'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Mensagem | Obrigatório | A mensagem a enviar. |
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
Tópicos: Eliminar tópico
Esta ferramenta elimina um tópico de agente de engenharia de fiabilidade do site (SRE).
Exemplos de prompts incluem:
- Eliminar a thread com o ID 'thread-12345' do Agente SRE 'sreagent-prod' com 'confirm' definido como 'true'.
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Confirmar | Obrigatório | Confirma uma operação destrutiva. |
| Thread ID | Obrigatório | O ID do tópico do Agente SRE. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
Tópicos: Receba mensagens
Esta ferramenta obtém as mensagens de uma conversa específica do Agente SRE e devolve o conteúdo e os metadados das mensagens, como marcas temporais e a identificação do remetente. Use as mensagens devolvidas para rever o histórico de conversas ou resolver o comportamento dos agentes.
Exemplos de prompts incluem:
- Mostrar mensagens do ID do tópico '42' no SRE Agent 'sre-agent-prod'.
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Thread ID | Obrigatório | O ID do tópico do Agente SRE. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Threads: modo YOLO
Esta ferramenta inicia uma investigação no Agente SRE especificado e concede todas as aprovações pendentes, permitindo que o agente prossiga sem etapas de aprovação humana. A ferramenta regista ações de investigação e concede aprovações para auditoria.
Exemplos de prompts incluem:
- "Investigar com a mensagem 'Investigar falha do serviço no frontend' no SRE Agent 'sre-agent-prod' em modo yolo, concedendo automaticamente todas as aprovações pendentes."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Mensagem | Obrigatório | A mensagem a enviar. |
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Iterações máximas | Opcional | O número máximo de iterações automáticas de seguimento. |
| Segundos de tempo morto | Opcional | O tempo limite da investigação em segundos. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
Tópicos: Investigar incidente
Investigue um problema ou incidente utilizando um agente de Site Reliability Engineering (SRE). Use esta ferramenta para enviar uma mensagem de investigação, e o agente faz perguntas de seguimento até a investigação terminar. Fornece os detalhes da investigação na mensagem. Inclua contexto relevante, como recursos afetados, marcas temporais, mensagens de erro, alterações recentes da configuração e passos para reproduzir o problema. Mantenha as mensagens concisas e focadas para ajudar o agente a chegar a uma resolução de forma mais eficiente.
Exemplos de prompts incluem:
- Investigue o seguinte problema com o agente SRE 'sre-agent-prod': mensagem de erro 'A API primária está a devolver erros 500 após a implementação'.
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Mensagem | Obrigatório | A mensagem a enviar. |
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Iterações máximas | Opcional | O número máximo de iterações automáticas de seguimento. |
| Segundos de tempo morto | Opcional | O tempo limite da investigação em segundos. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
Tópicos: Listar tópicos de chat de agentes
Esta ferramenta lista os tópicos de chat dos Agentes SRE. Devolve uma lista só de leitura de objetos de conversa que incluem o ID da conversa, os participantes, os metadados e a mensagem mais recente, para que possa rever conversas ativas e anteriores.
Exemplos de prompts incluem:
- "Lista os tópicos ativos no Agente SRE 'sreagent-prod'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Threads: Enviar mensagem para thread
Esta ferramenta envia uma mensagem para uma conversa existente de um agente de engenharia de fiabilidade do site (SRE). Publica a mensagem especificada na thread e devolve o estado atualizado da thread. Use mensagens concisas para adicionar contexto, atualizações de estado ou notas de resolução de problemas a um tópico em andamento.
Exemplos de prompts incluem:
- "Enviar mensagem 'Reiniciar concluído, monitorizar registos' para o ID do fio 'thread-12345' no agente 'sre-agent-westus'."
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Mensagem | Obrigatório | A mensagem a enviar. |
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
| Thread ID | Obrigatório | O ID do tópico do Agente SRE. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
Fluxos de trabalho: Aplicar e implementar fluxos de trabalho
Aplica e implementa um fluxo de trabalho YAML a um Agente SRE. Esta ferramenta carrega e ativa a configuração YAML do ExtendedAgent ou ExtendedAgentTool no recurso SRE Agent especificado.
Exemplos de prompts incluem:
- Aplique o YAML do fluxo de trabalho com o conteúdo 'apiVersion: sre/v1\nkind: ExtendedAgent\nmetadata:\n name: deploy-workflow' no SRE Agent 'sre-agent-prod'.
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Conteúdo YAML | Obrigatório | Conteúdo YAML. |
| Agent | Obrigatório | O nome do recurso Azure SRE Agent a utilizar como destino. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |
Fluxos de Trabalho: Gerar definição de fluxo de trabalho
Gerar uma definição de fluxo de trabalho em YAML para uma ferramenta ou um agente de engenharia de fiabilidade do site (SRE) com nome. Esta ferramenta cria configuração YAML validada para ExtendedAgent, KustoTool, e LinkTool recursos. O fluxo de trabalho gerado ajuda-o a implementar e gerir ferramentas SRE Agent de forma consistente em vários ambientes.
Exemplos de prompts incluem:
- Gerar um fluxo de trabalho YAML com a descrição 'ferramenta de consulta Kusto para pesquisa de incidentes', tipo 'ferramenta', nome 'kusto-search-tool'.
| Parâmetro | Obrigatório ou opcional | Descrição |
|---|---|---|
| Description | Obrigatório | Uma descrição do item SRE Agent. |
| Kind | Obrigatório | Tipo YAML: agente ou ferramenta. |
| Nome | Obrigatório | O nome do item do Agente SRE. |
| Conector | Opcional | O nome do conector para as ferramentas Kusto. |
| Nome da base de dados | Opcional | A base de dados Kusto para as ferramentas Kusto. |
| Modelo ou tipo | Opcional | Tipo de ferramenta, como KustoTool ou LinkTool. |
| Parâmetros | Opcional | Parâmetros como nome:descrição. |
| Query | Opcional | A consulta Kusto para ferramentas Kusto. |
| Tools | Opcional | Nomes de ferramentas para anexar. São suportados múltiplos valores. |
| Transferências | Opcional | Nomes de transferência de subagentes. São suportados múltiplos valores. |
| modelo de URL | Opcional | O modelo de URL para ferramentas de links. |
Dicas para anotação de ferramentas:
| Destrutivo | Idempotente | Mundo Aberto | Somente leitura | Secret | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Fluxos de Trabalho: Validar o fluxo de trabalho
Esta ferramenta valida o fluxo de trabalho do SRE Agent YAML e assinala problemas comuns na estrutura e sintaxe. Verifica se há YAML inválido, etapas malformadas, strings run incorretas e chaves obrigatórias em falta. Fornece YAML content, e a ferramenta devolve problemas identificados com números de linha e soluções sugeridas. Veja o seguinte exemplo para um erro típico que a ferramenta deteta.
Exemplos de prompts incluem:
- Validar o seguinte conteúdo YAML do fluxo de trabalho do SRE Agent '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 | Localidade obrigatória |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |