Partilhar via


Ferramentas de Armazenamento do Azure para a visão geral do Azure MCP Server

O Servidor MCP do Azure permite gerenciar recursos do Armazenamento do Azure, incluindo contas de armazenamento, contêineres, tabelas e blobs com prompts de linguagem natural.

O Armazenamento do Azure é a solução de armazenamento em nuvem da Microsoft para cenários modernos de armazenamento de dados.

Observação

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

Conta: Criar

Crie uma nova conta de Armazenamento do Azure.

Pré-requisitos: O contexto da conversa estabelece parâmetros globais (subscrição, grupo de recursos). O chamador deve ter o papel de Contribuidor da Conta de Armazenamento ou permissões equivalentes na subscrição alvo.

Exemplos de prompts incluem:

  • Criar conta de armazenamento: "Crie uma conta de armazenamento chamada 'mystorageaccount' no grupo de recursos 'meu-grupo-de recursos' na localização 'eastus'."
  • Com SKU: "Crie uma conta de armazenamento 'mydata' no grupo de recursos 'my-resource-group' na localização 'eastus' com Standard_GRS."
  • Ativar o Data Lake: "Crie uma conta de armazenamento 'datalakeacct' no grupo de recursos 'meu-grupo-de recursos' na localização 'westeurope' com o namespace hierárquico ativado."
Parâmetro Obrigatório ou opcional Description
Grupo de recursos Obrigatório O nome do grupo de recursos do Azure. O grupo de recursos é um contentor lógico para recursos Azure.
Conta de armazenamento Obrigatório O nome globalmente único da conta Azure Storage (3-24 caracteres, apenas letras minúsculas e números).
Localização Obrigatório A região Azure onde Azure cria a conta de armazenamento (por exemplo, eastus, westus2).
SKU Opcional A conta de armazenamento SKU. Valores válidos: Standard_LRS, Standard_GRS, Standard_RAGRS, Standard_ZRS, Premium_LRS, Premium_ZRS, Standard_GZRS, , . Standard_RAGZRS
Camada de acesso Opcional A camada de acesso padrão para armazenamento de blob. Valores válidos: Hot, Cool.
Permitir espaço de nomes hierárquico Opcional Se o namespace hierárquico (Data Lake Storage Gen2) deve ser habilitado para a conta de armazenamento.

Verificação de sucesso: A ferramenta devolve os detalhes da conta de armazenamento criada.

Dicas de anotação da ferramenta:

Destrutiva: ✅ | Idempotente: ❌ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Obrigatório: ❌

Conta: Obter detalhes

Recupera informações detalhadas sobre contas do Azure Storage, incluindo nome da conta, localização, SKU, tipo, estado hierárquico do namespace, definições apenas HTTPS e configuração de acesso público em blob. Se não fornecer um nome de conta específico, a ferramenta devolve os detalhes de todas as contas na subscrição.

Pré-requisitos: O contexto da conversa estabelece parâmetros globais (subscrição, autenticação). O chamador deve ter o papel de Leitor de Conta de Armazenamento ou permissões equivalentes.

Exemplos de prompts incluem:

  • Obtenha detalhes da conta de armazenamento: "Mostre-me os dados da conta de armazenamento 'mystorageaccount'."
  • Liste todas as contas: "Que contas de armazenamento estão na minha subscrição?"
  • Verificar propriedades: "Quais são as definições para a conta de armazenamento 'mydata'?"
Parâmetro Obrigatório ou opcional Description
Conta de armazenamento Opcional O nome globalmente único da conta Azure Storage (por exemplo, 'mystorageaccount').

Verificação de sucesso: Devolve JSON com propriedades da conta de armazenamento ou uma lista de todas as contas se não especificar um nome.

Dicas de anotação da ferramenta:

Destrutiva: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Obrigatório: ❌

Contêiner: Criar contêiner

Crie um contêiner de blob com acesso público de blob opcional.

Pré-requisitos: O contexto da conversa estabelece parâmetros globais (subscrição, autenticação). O chamador deve ter a função de Contribuidor de Dados do Blob de Armazenamento ou equivalente na conta de armazenamento.

Exemplos de prompts incluem:

  • Criar contentor: "Crie um contentor privado chamado 'mycontainer' na conta de armazenamento 'mystorageaccount'."
  • Com nível de acesso: "Crie um contentor de blob chamado 'logs' na conta de armazenamento 'mydata' com nível de acesso 'privado'."
Parâmetro Obrigatório ou opcional Description
Conta de armazenamento Obrigatório O nome globalmente único da conta Azure Storage (por exemplo, 'mystorageaccount').
Contentor Obrigatório O nome do contentor a criar dentro da conta de armazenamento.

Verificação de sucesso: A ferramenta devolve as propriedades do contentor criado.

Dicas de anotação da ferramenta:

Destrutiva: ✅ | Idempotente: ❌ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Obrigatório: ❌

Contentor: Obter detalhes do contentor

Liste todos os contentores de blob numa conta de armazenamento ou mostre detalhes de um contentor específico. Apresenta propriedades dos contentores, incluindo políticas de acesso, estado do arrendamento e metadados.

Pré-requisitos: O contexto da conversa estabelece parâmetros globais (subscrição, autenticação). O chamador deve ter a função de Leitor de Dados de Blob de Armazenamento ou equivalente na conta de armazenamento.

Exemplos de prompts incluem:

  • Obtenha detalhes do contentor: "Mostre-me detalhes sobre o contentor 'documentos' na conta de armazenamento 'mystorageaccount'."
  • Listar contentores: "Que contentores estão na conta de armazenamento 'media_files'?"
  • Verifique a política de acesso: "Verifique a política de acesso para o contentor 'user_data' na conta de armazenamento 'prodstore'."
Parâmetro Obrigatório ou opcional Description
Conta de armazenamento Obrigatório O nome globalmente único da conta Azure Storage.
Contentor Opcional O nome do contêiner. Se não especificares um nome, a ferramenta lista todos os contentores na conta de armazenamento.

Verificação de sucesso: Devolve JSON com propriedades do contentor ou uma lista de todos os contentores se não especificar um nome.

Dicas de anotação da ferramenta:

Destrutiva: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Obrigatório: ❌

Blob: Obter detalhes do blob

Listar blobs num contentor ou obter detalhes para um blob específico. Mostra propriedades do blob, incluindo metadados, tamanho, tempo da última modificação e propriedades de conteúdo.

Pré-requisitos: O contexto da conversa estabelece parâmetros globais (subscrição, autenticação). O chamador deve ter o papel de Leitor de Dados de Blob de Armazenamento ou equivalente na conta de armazenamento.

Exemplos de prompts incluem:

  • Obter detalhes de blob: "Mostre-me detalhes para 'file.txt' no contêiner 'documentos' na conta de armazenamento 'mystorageaccount'."
  • Lista de blobs: "Que blobs estão no contentor 'fotos' da conta de armazenamento 'mediafiles'?"
  • Metadados do blob: "Qual é o metadado de 'backup.zip' no contentor 'backups' na conta de armazenamento 'mydata'?"
Parâmetro Obrigatório ou opcional Description
Conta de armazenamento Obrigatório O nome globalmente único da conta Azure Storage (por exemplo, 'mystorageaccount').
Contentor Obrigatório O nome do contentor dentro da conta de armazenamento.
Blob Opcional O nome do blob dentro do contentor, incluindo o caminho completo (por exemplo, file.txt ou folder/file.txt). Se não especificares um nome, a ferramenta lista todos os blobs no contentor.

Verificação de sucesso: Devolve JSON com propriedades de blobs ou uma lista de todos os blobs se não especificares um nome.

Dicas de anotação da ferramenta:

Destrutiva: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Obrigatório: ❌

Blob: Carregar

Carrega um ficheiro local para um blob no Azure Storage se o blob não existir.

Pré-requisitos: O contexto da conversa estabelece parâmetros globais (subscrição, autenticação). O chamador deve ter o papel de Contribuidor de Dados do Blob de Armazenamento ou equivalente na conta de armazenamento. O ficheiro local deve existir e ser acessível.

Exemplos de prompts incluem:

  • Carregar ficheiro: "Carregar ficheiro local 'report.pdf' para o blob 'documents/report.pdf' no contentor 'documents' na conta de armazenamento 'mystorageaccount'."
  • Carregar e sobrescrever: "Carregar o ficheiro local 'data.csv' para o blob 'archive/data.csv' no contentor 'archive' na conta de armazenamento 'mydata', sobrescrevendo caso já exista'."
Parâmetro Obrigatório ou opcional Description
Conta de armazenamento Obrigatório O nome globalmente único da conta Azure Storage (por exemplo, mystorageaccount).
Contentor Obrigatório O nome do contentor dentro da conta de armazenamento.
Blob Obrigatório O nome do blob dentro do contentor, incluindo o caminho completo (por exemplo, file.txt ou folder/file.txt).
Caminho do arquivo local Obrigatório O caminho completo para o ficheiro local no seu sistema.

Verificação de sucesso: A ferramenta devolve o último tempo modificado, ETag e hash de conteúdo do blob carregado.

Dicas de anotação da ferramenta:

Destrutiva: ❌ | Idempotente: ❌ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Obrigatório: ✅