Ferramentas do Servidor MCP do Azure para Pesquisa de IA do Azure 

O servidor MCP (Protocolo de Contexto de Modelo do Azure) permite gerenciar recursos do Pesquisa de IA do Azure , incluindo serviços de pesquisa, índices, fontes de conhecimento e bases de dados de conhecimento com prompts de linguagem natural.

O Pesquisa de IA do Azure  (antigo Azure Cognitive Search) é um serviço de pesquisa em nuvem que fornece APIs e ferramentas para a criação de aplicativos e agentes que seguem o padrão rag (geração aumentada de recuperação). Ele dá suporte à recuperação de vetor e palavra-chave, reclassificação e recuperação agêntica; para obter mais informações, consulte a documentação do Pesquisa de IA do Azure .

Observação

Cada base de conhecimento da Pesquisa de IA do Azure disponibiliza um ponto de extremidade MCP nativo para recuperação direta. Para obter mais informações, consulte Acessar o ponto de extremidade MCP.

Observação

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.

Obter índice de pesquisa

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

Os prompts de exemplo incluem:

  • "Mostre-me os detalhes do índice 'products-index' no serviço 'my-search-service' do Pesquisa de IA do Azure ."
  • Liste todos os índices do serviço Pesquisa de IA do Azure  'enterprise-search'.
  • "Quais são os campos presentes no índice 'users' 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 Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Índice de pesquisa de consulta

Essa ferramenta executa uma consulta de pesquisa em um índice do Pesquisa de IA do Azure  e retorna os documentos correspondentes e metadados de relevância. Normalmente, os resultados incluem campos de documento, uma pontuação de relevância e quaisquer realces de texto que correspondam à consulta.

Os prompts de exemplo incluem:

  • "Pesquise por 'machine learning' no índice 'documents' do meu serviço 'contoso-search'."
  • "Consulte o índice 'products' para 'noise-canceling headphones' no serviço da Pesquisa de IA do Azure 'fabrikam-search'."
  • "Pesquise meu índice de 'conteúdo' em 'my-search-service' para qualquer coisa que mencione 'mudanças 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 que será executada no índice da Pesquisa de IA do Azure.

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Obter base de dados de conhecimento

Essa ferramenta obtém detalhes das bases de dados de conhecimento do Pesquisa de IA do Azure . As bases de dados de conhecimento encapsulam recursos de recuperação e raciocínio em uma ou mais fontes de conhecimento ou índices. Se você não fornecer um nome de base de dados de conhecimento, ele retornará detalhes para todas as bases de dados de conhecimento dentro do serviço especificado.

Os prompts de exemplo incluem:

  • "Liste todas as bases de dados de conhecimento no serviço do Pesquisa de IA do Azure  'my-search-service'."
  • "Mostre-me as bases de dados de conhecimento no serviço 'contoso-search'."
  • "Obtenha os detalhes da base de conhecimento 'support-agent' no serviço da Pesquisa de IA do Azure '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).
Base de conhecimento Opcional O nome da base de dados de conhecimento no serviço Pesquisa de IA do Azure .

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Recuperar da base de conhecimento

Essa ferramenta executa uma operação de recuperação em uma base de conhecimento do Pesquisa de IA do Azure  para encontrar informações relevantes de suas fontes de dados. Forneça uma consulta de turno único para recuperação ou uma ou mais mensagens de conversa no formato role:content. A especificação de consultas e mensagens não é permitida.

Os prompts de exemplo incluem:

  • "Execute uma recuperação com a base de conhecimento 'support-agent' no serviço da Pesquisa de IA do Azure 'my-search-service' para a consulta 'password reset steps'."
  • "Solicite à base de conhecimento 'product-docs' no serviço de pesquisa 'contoso-search' a recuperação de informações sobre 'API rate limits'."
  • "Consulte a base de conhecimento 'hr-policies' no serviço de pesquisa 'hr-search' sobre a 'vacation accrual policy'."
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 no serviço Pesquisa de IA do Azure .
Consulta Opcional Consulta de linguagem natural para recuperação quando um histórico de mensagens de conversa não é fornecido.
Messages Opcional Mensagens de histórico de conversas transferidas 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 Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ✅ ✅ ✅ ❌ ❌

Obter fonte de conhecimento

Essa ferramenta obtém detalhes das fontes de conhecimento do 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 contêiner de armazenamento de blobs) indexados pelo Pesquisa de IA do Azure . As fontes de conhecimento são utilizadas pelas bases de conhecimento durante a recuperação. Se você não fornecer um nome de fonte de conhecimento, ele retornará detalhes para todas as fontes de conhecimento no serviço especificado.

Os prompts de exemplo incluem:

  • "Liste todas as fontes de conhecimento no serviço do Pesquisa de IA do Azure  'my-search-service'."
  • "Mostre-me as fontes de conhecimento no serviço 'contoso-search' do Pesquisa de IA do Azure ."
  • "Obtenha os detalhes da fonte de dados 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 Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Listar serviços de pesquisa

Essa ferramenta lista os serviços do Pesquisa de IA do Azure  em uma assinatura e retorna detalhes para cada serviço, incluindo nome, local, SKU, estado de provisionamento e ponto de extremidade.

Os prompts de exemplo incluem:

  • "Liste os serviços do Pesquisa de IA do Azure  na minha assinatura."
  • "Quais serviços de Pesquisa de IA eu tenho?"
  • "Mostre-me meus recursos do Pesquisa de IA do Azure ."

Dicas de anotação da ferramenta:

Destrutivo Idempotent Mundo Aberto Somente leitura Secret Local Obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Conteúdo relacionado

  • Last updated on