Herramientas del servidor MCP de Azure para Búsqueda de Azure AI

El servidor de Protocolo de contexto de modelo de Azure (MCP) le permite administrar recursos de Búsqueda de Azure AI, incluidos los servicios de búsqueda, los índices, los orígenes de conocimiento y las bases de conocimiento con mensajes de lenguaje natural.

Búsqueda de Azure AI (anteriormente Azure Cognitive Search) es un servicio de búsqueda en la nube que proporciona API y herramientas para compilar aplicaciones y agentes que siguen el patrón de generación aumentada de recuperación (RAG). Admite la recuperación de vectores y palabras clave, el reranking y la recuperación agente; para más información, consulte la documentación de Búsqueda de Azure AI.

Nota:

Cada base de conocimiento de Búsqueda de Azure AI expone un punto de conexión de MCP nativo para la recuperación directa. Para obtener más información, consulte Llamada al punto de conexión de MCP.

Nota:

Parámetros de herramienta: las herramientas del servidor MCP de Azure definen parámetros para los datos que necesitan para completar las tareas. Algunos de estos parámetros son específicos de cada herramienta y se documentan aquí. Otros parámetros son globales y compartidos por todas las herramientas. Para obtener más información, consulte Parámetros de la herramienta.

Obtener índice de búsqueda

Esta herramienta recupera información detallada sobre los índices de Búsqueda de Azure AI, incluidos el esquema de índice, los campos, los analizadores, los perfiles de puntuación y otras propiedades de índice. Cuando se proporciona un nombre de índice, devuelve propiedades para ese índice; sin un nombre de índice, devuelve todos los índices del servicio especificado.

Algunas solicitudes de ejemplo incluyen:

  • "Mostrarme los detalles del índice "products-index" en el servicio "my-search-service" de Búsqueda de Azure AI".
  • "Enumere todos los índices del servicio Búsqueda de Azure AI "enterprise-search".
  • ¿Qué campos están en el índice «users» del servicio «contoso-search»?
Parámetro Obligatorio u opcional Description
Servicio Obligatorio Nombre del servicio Búsqueda de Azure AI (por ejemplo, my-search-service).
Índice Opcional Nombre del índice de búsqueda en el servicio Búsqueda de Azure AI.

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secret Requisito local
❌ ✅ ❌ ✅ ❌ ❌

Índice de búsqueda por consultas

Esta herramienta ejecuta una consulta de búsqueda en un índice de Búsqueda de Azure AI y devuelve los documentos coincidentes y los metadatos de relevancia. Los resultados suelen incluir campos de documento, una puntuación de relevancia y los resaltados de texto que coincidan con la consulta.

Algunas solicitudes de ejemplo incluyen:

  • Busque el término "machine learning" en el índice "documents" del servicio "contoso-search".
  • Consulta el índice “products” en busca de “auriculares con cancelación de ruido” en el servicio Búsqueda de Azure AI “fabrikam-search”.
  • "Busque mi índice "content" en "my-search-service" para cualquier cosa que mencione "cambio climático".
Parámetro Obligatorio u opcional Description
Servicio Obligatorio Nombre del servicio Búsqueda de Azure AI (por ejemplo, my-search-service).
Índice Obligatorio Nombre del índice de búsqueda en el servicio Búsqueda de Azure AI.
Query Obligatorio La consulta de búsqueda que se ejecutará en el índice de Búsqueda de Azure AI.

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secret Requisito local
❌ ✅ ❌ ✅ ❌ ❌

Obtención de la base de conocimiento

Esta herramienta obtiene detalles de las bases de conocimiento de Búsqueda de Azure AI. Las bases de conocimiento encapsulan las funcionalidades de recuperación y razonamiento en uno o varios orígenes de conocimiento o índices. Si no proporciona un nombre de base de conocimiento, devuelve los detalles de todas las bases de conocimiento dentro del servicio especificado.

Algunas solicitudes de ejemplo incluyen:

  • "Enumere todas las bases de conocimiento en el servicio "my-search-service" de Búsqueda de Azure AI".
  • "Muéstrame las bases de conocimiento en el servicio "contoso-search".
  • Obtén los detalles de la base de conocimientos “support-agent” en el servicio Búsqueda de Azure AI “enterprise-search”.
Parámetro Obligatorio u opcional Description
Servicio Obligatorio Nombre del servicio Búsqueda de Azure AI (por ejemplo, my-search-service).
Knowledge Base Opcional Nombre de la base de conocimiento en el servicio Búsqueda de Azure AI.

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secret Requisito local
❌ ✅ ❌ ✅ ❌ ❌

Recuperación de la base de conocimiento

Esta herramienta ejecuta una operación de recuperación en una base de conocimiento de Búsqueda de Azure AI para buscar información relevante de sus orígenes de datos. Proporcione una consulta de un solo turno para la recuperación o uno o varios mensajes conversacionales en role:content formato. No se permite especificar tanto la consulta como los mensajes.

Algunas solicitudes de ejemplo incluyen:

  • Realiza una recuperación con la base de conocimientos support-agent en el servicio Búsqueda de Azure AI my-search-service para la consulta pasos para restablecer la contraseña.
  • Consultar la base de conocimiento "product-docs" en el servicio de búsqueda "contoso-search" para obtener información sobre "límites de tarifas de API".
  • Consulta la base de conocimientos "hr-policies" en el servicio de búsqueda "hr-search" sobre la "política de acumulación de vacaciones".
Parámetro Obligatorio u opcional Description
Servicio Obligatorio Nombre del servicio Búsqueda de Azure AI (por ejemplo, my-search-service).
Knowledge Base Obligatorio Nombre de la base de conocimiento en el servicio Búsqueda de Azure AI.
Query Opcional Consulta de lenguaje natural para la recuperación cuando no se proporciona un historial de mensajes conversacionales.
Messages Opcional Mensajes del historial de conversaciones pasados a la base de conocimiento. Cada entrada formateada como role:content, donde el rol es user o assistant (por ejemplo, user:What policies apply to archived invoices?).

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secret Requisito local
❌ ✅ ✅ ✅ ❌ ❌

Obtención del origen de conocimiento

Esta herramienta obtiene detalles de los orígenes de conocimiento de Búsqueda de Azure AI. Un origen de conocimiento puede apuntar a un índice de Búsqueda de Azure AI existente o representar datos externos (por ejemplo, un contenedor de almacenamiento de blobs) que Búsqueda de Azure AI ha indexado. Los orígenes de conocimiento son usados por las bases de conocimiento durante la recuperación de información. Si no proporciona un nombre de origen de conocimiento, devuelve los detalles de todos los orígenes de conocimiento del servicio especificado.

Algunas solicitudes de ejemplo incluyen:

  • "Enumere todos los orígenes de conocimiento en el servicio "my-search-service" de Búsqueda de Azure AI".
  • Mostrarme las fuentes de conocimiento en el servicio de búsqueda de Azure AI "contoso-search".
  • Consiga los detalles de la fuente de conocimiento «product-index» en el servicio de búsqueda «enterprise-search».
Parámetro Obligatorio u opcional Description
Servicio Obligatorio Nombre del servicio Búsqueda de Azure AI (por ejemplo, my-search-service).
Fuente de conocimiento Opcional Nombre del origen de conocimiento en el servicio Búsqueda de Azure AI.

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secret Requisito local
❌ ✅ ❌ ✅ ❌ ❌

Enumerar servicios de búsqueda

Esta herramienta enumera los servicios de Búsqueda de Azure AI en una suscripción y devuelve los detalles de cada servicio, incluidos el nombre, la ubicación, la SKU, el estado de aprovisionamiento y el punto de conexión.

Algunas solicitudes de ejemplo incluyen:

  • "Enumerar los servicios de Búsqueda de Azure AI en mi suscripción".
  • "¿Qué servicios de AI Search tengo?"
  • "Muéstrame mis recursos de Búsqueda de Azure AI".

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secret Requisito local
❌ ✅ ❌ ✅ ❌ ❌

Contenido relacionado

  • Last updated on