Ferramentas do Azure MCP Server para Pesquisa de IA do Azure

O Azure Model Context Protocol (MCP) Server permite-lhe gerir recursos de pesquisa Azure AI, incluindo serviços de pesquisa, índices, fontes de conhecimento e bases de conhecimento com prompts em linguagem natural.

Pesquisa de IA do Azure (anteriormente Azure Cognitive Search) é um serviço de pesquisa na nuvem que fornece APIs e ferramentas para construir aplicações e agentes que seguem o padrão Retrieval Augmented Generation (RAG). Suporta a recuperação por vetores e palavras-chave, reclassificação e recuperação agentiva; para mais informações, consulte a documentação do Pesquisa de IA do Azure.

Observação

Cada base de conhecimento Pesquisa de IA do Azure expõe um endpoint MCP nativo para recuperação direta. Para mais informações, consulte Aceder ao endpoint MCP.

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 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.

Obter índice de pesquisa

Esta ferramenta recupera informações detalhadas sobre os índices do Pesquisa de IA do Azure, incluindo o esquema do índice, campos, analisadores, perfis de pontuação e outras propriedades de índice. Quando fornece um nome de índice, ele devolve propriedades para esse índice; sem um nome de índice, devolve todos os índices do serviço especificado.

Exemplos de prompts incluem:

  • Mostre-me os detalhes do índice 'products-index' no serviço 'my-search-service' do Pesquisa de IA do Azure.
  • Listar todos os índices do serviço 'enterprise-search' do Pesquisa de IA do Azure.
  • "Que campos estão no índice de 'utilizadores' no serviço 'contoso-search'?"
Parâmetro Obrigatório ou opcional Description
Serviço Obrigatório O nome do serviço Pesquisa de IA do Azure (por exemplo, my-search-service).
Índice Opcional O nome do índice de pesquisa no serviço Pesquisa de IA do Azure.

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Localidade obrigatória
❌ ✅ ❌ ✅ ❌ ❌

Índice de pesquisa de consulta

Esta ferramenta executa uma consulta de pesquisa num índice Pesquisa de IA do Azure e devolve os documentos correspondentes e os metadados de relevância. Os resultados normalmente incluem campos de documento, uma pontuação de relevância e quaisquer realces de texto que correspondam à consulta.

Exemplos de prompts incluem:

  • Pesquise por 'aprendizagem automática' no índice de 'documentos' do meu serviço 'contoso-search'.
  • Pesquisar no índice 'produtos' por 'auscultadores com cancelamento de ruído' no serviço Pesquisa de IA do Azure 'fabrikam-search'.
  • "Pesquise no meu índice de 'conteúdo' em 'meu-serviço-de pesquisa' por qualquer coisa que mencione 'alterações climáticas'."
Parâmetro Obrigatório ou opcional Description
Serviço Obrigatório O nome do serviço Pesquisa de IA do Azure (por exemplo, my-search-service).
Índice Obrigatório O nome do índice de pesquisa no serviço Pesquisa de IA do Azure.
Consulta Obrigatório A consulta de pesquisa a ser executada no índice do Pesquisa de IA do Azure.

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Localidade obrigatória
❌ ✅ ❌ ✅ ❌ ❌

Obter uma base de conhecimento

Esta ferramenta obtém detalhes para as bases de conhecimento do Pesquisa de IA do Azure. As bases de conhecimento encapsulam recursos de recuperação e raciocínio em uma ou mais fontes ou índices de conhecimento. Se não fornecer o nome da base de conhecimento, ela retorna detalhes de todas as bases de conhecimento dentro do serviço especificado.

Exemplos de prompts incluem:

  • "Liste todas as bases de conhecimento no serviço Pesquisa de IA do Azure 'my-search-service'."
  • "Mostra-me as bases de conhecimento no serviço 'contoso-search'."
  • Obtenha os detalhes da base de conhecimento 'support-agent' no serviço 'enterprise-search' do Pesquisa de IA do Azure.
Parâmetro Obrigatório ou opcional Description
Serviço Obrigatório O nome do serviço Pesquisa de IA do Azure (por exemplo, my-search-service).
Base de conhecimento Opcional O nome da base de dados de conhecimento dentro do serviço Pesquisa de IA do Azure.

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Localidade obrigatória
❌ ✅ ❌ ✅ ❌ ❌

Obter da base de conhecimento

Esta ferramenta executa uma operação de recuperação numa base de conhecimento Pesquisa de IA do Azure para encontrar informação relevante das suas fontes de dados. Forneça uma consulta de um único turno para recuperação ou uma ou mais mensagens conversacionais no formato role:content. Não é permitido especificar consultas e mensagens.

Exemplos de prompts incluem:

  • Realize uma recuperação com a base de conhecimento 'support-agent' no serviço Pesquisa de IA do Azure 'my-search-service' para a consulta 'etapas de redefinição de palavra-passe'.
  • Solicite à base de conhecimento 'product-docs' no serviço de pesquisa 'contoso-search' para obter informações sobre 'limites de utilização da API'.
  • "Consultar a base de conhecimento 'hr-policies' no serviço de pesquisa 'hr-search' sobre 'política de acumulação de férias'."
Parâmetro Obrigatório ou opcional Description
Serviço Obrigatório O nome do serviço Pesquisa de IA do Azure (por exemplo, my-search-service).
Base de conhecimento Obrigatório O nome da base de dados de conhecimento dentro do serviço Pesquisa de IA do Azure.
Consulta Opcional Consulta em linguagem natural para recuperação quando um histórico de mensagens conversacionais não é fornecido.
Messages Opcional As mensagens do histórico de conversas foram passadas para a base de conhecimento. Cada entrada formatada como role:content, onde a função é user ou assistant (por exemplo, user:What policies apply to archived invoices?).

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Localidade obrigatória
❌ ✅ ✅ ✅ ❌ ❌

Obter fonte de conhecimento

Esta ferramenta obtém detalhes das fontes de conhecimento Pesquisa de IA do Azure. Uma fonte de conhecimento pode apontar para um índice existente do Pesquisa de IA do Azure ou representar dados externos (por exemplo, um contentor de armazenamento de blobs) que o Pesquisa de IA do Azure indexou. As fontes de conhecimento são usadas pelas bases de conhecimento durante o processo de consulta. Se não fornecer um nome da fonte de conhecimento, ele retorna detalhes de todas as fontes de conhecimento no serviço especificado.

Exemplos de prompts incluem:

  • "Liste todas as fontes de conhecimento no serviço Pesquisa de IA do Azure 'my-search-service'."
  • "Mostra-me as fontes de conhecimento no serviço Pesquisa de IA do Azure 'contoso-search'."
  • "Obtenha os detalhes da fonte de conhecimento 'product-index' no serviço de pesquisa 'enterprise-search'."
Parâmetro Obrigatório ou opcional Description
Serviço Obrigatório O nome do serviço Pesquisa de IA do Azure (por exemplo, my-search-service).
Fonte de conhecimento Opcional O nome da fonte de conhecimento no serviço Pesquisa de IA do Azure.

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Localidade obrigatória
❌ ✅ ❌ ✅ ❌ ❌

Serviços de pesquisa por listas

Esta ferramenta lista os serviços Pesquisa de IA do Azure numa subscrição e devolve detalhes de cada serviço, incluindo nome, localização, SKU, estado de provisionamento e endpoint.

Exemplos de prompts incluem:

  • "Listar os serviços de Pesquisa de IA do Azure na minha subscrição."
  • "Que serviços de Pesquisa por IA tenho?"
  • "Mostra-me os meus recursos de Pesquisa de IA do Azure."

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Localidade obrigatória
❌ ✅ ❌ ✅ ❌ ❌

Conteúdo relacionado

  • Last updated on