Compartir vía


Herramientas de Azure AI Search para azure MCP Server

Use azure MCP Server para administrar recursos de Azure AI Search, incluidos los servicios de búsqueda, los índices y las consultas con avisos de lenguaje natural. No es necesario recordar una sintaxis de comandos específica.

Azure AI Search (anteriormente Azure Cognitive Search) es un servicio de búsqueda en la nube que proporciona API y herramientas para crear aplicaciones y agentes que siguen el patrón de generación aumentada de recuperación (RAG) para conectar modelos de inteligencia artificial con datos externos, así como para escenarios más tradicionales, como la búsqueda de catálogos y documentos. Puede desempeñar el papel de una base de datos vectorial o de un sistema de recuperación completo con recuperación de vectores y palabras clave, reranking y compatibilidad con la recuperación agente más reciente.

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 a continuación. Otros parámetros son globales y compartidos por todas las herramientas. Para obtener más información, consulte Parámetros de la herramienta.

Índice: Obtener detalles del índice

Use azure MCP Server para recuperar información detallada sobre los índices de AI Search. Puede ver el esquema de índice, los campos, los analizadores, los perfiles de puntuación y otras propiedades de índice.

Algunas solicitudes de ejemplo incluyen:

  • Obtener detalles del índice: "Mostrar detalles del índice "products" en mi servicio "mysearchservice".
  • Ver esquema de índice: "¿Qué campos se encuentran en el índice "users"?"
  • Estructura de índice: "Describir el esquema del índice "documents" en mi servicio de búsqueda".
Parámetro Obligatorio u opcional Description
Servicio Obligatorio Nombre del servicio Azure AI Search (por ejemplo, my-search-service).
Índice Opcional Nombre del índice de búsqueda en el servicio Azure AI Search. Mostrará todos los índices si no se especifica.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Open World: ❌ | Solo lectura: ✅ | Secreto: ❌ | Local requerido: ❌

Índice: Índice de consulta

Use el servidor MCP de Azure para ejecutar consultas de búsqueda en un índice de AI Search. Esta característica le ayuda a encontrar contenido específico mediante términos de búsqueda.

Algunas solicitudes de ejemplo incluyen:

  • Consulta simple: "Buscar "aprendizaje automático" en el índice "documentos" del servicio "my-search-service".
  • Consulta de muestreo: "Datos de ejemplo que hablan de "ML" o "IA" o "ciencia de datos" en el índice "documentos" y me dicen lo que hablan".
  • Búsqueda de texto: "Buscar mi índice "contenido" en "my-search-service" para cualquier cosa que mencione "cambio climático".
Parámetro Obligatorio u opcional Description
Servicio Obligatorio Nombre del servicio Azure AI Search (por ejemplo, my-search-service).
Índice Obligatorio Nombre del índice de búsqueda en el servicio Azure AI Search.
Query Obligatorio Consulta de búsqueda que se va a ejecutar en el índice de Azure AI Search.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Open World: ❌ | Solo lectura: ✅ | Secreto: ❌ | Local requerido: ❌

Conocimiento: Obtención de la base de conocimiento

Obtiene los detalles de las bases de conocimiento de Azure AI Search. Las bases de conocimiento encapsulan las funcionalidades de recuperación y razonamiento en uno o varios orígenes de conocimiento o índices. Si no se proporciona un nombre específico de la base de conocimiento, el comando devuelve los detalles de todas las bases de conocimiento dentro del servicio especificado.

Algunas solicitudes de ejemplo incluyen:

  • Obtener detalles de la base de conocimiento: "Mostrar detalles de la base de conocimiento "soporte" en mi servicio de búsqueda.
  • Ver todas las bases de conocimiento: "Enumerar todas las bases de conocimiento en mi servicio de búsqueda de IA".
  • Información de la base de conocimiento: "¿Qué bases de conocimiento están disponibles en "my-search-service"?"
Parámetro Obligatorio u opcional Description
Servicio Obligatorio Nombre del servicio Azure AI Search (por ejemplo, my-search-service).
Knowledge base Opcional Nombre de la base de conocimiento en el servicio Azure AI Search.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Open World: ❌ | Solo lectura: ✅ | Secreto: ❌ | Local requerido: ❌

Conocimiento: Recuperación de una base de conocimiento

Ejecute una operación de recuperación mediante una base de conocimiento específica de Azure AI Search, buscando y consultando eficazmente los orígenes de datos subyacentes según sea necesario para encontrar información relevante. Proporcione una consulta para la recuperación de un solo turno o uno o varios mensajes conversacionales. No se permite especificar tanto la consulta como los mensajes.

Algunas solicitudes de ejemplo incluyen:

  • Recuperar con consulta: "Busque la base de conocimiento "support" en el servicio "my-search-service" para obtener información sobre la solución de problemas.
  • Recuperación conversacional: "Pregunte a la base de conocimiento "docs" en "help-search-service": ¿Cómo se configura la autenticación?"
  • Búsqueda de la base de conocimiento: "Consulte la base de conocimiento "products" en "retail-search-service" para obtener información de precios.
Parámetro Obligatorio u opcional Description
Servicio Obligatorio Nombre del servicio Azure AI Search (por ejemplo, my-search-service).
Knowledge base Obligatorio Nombre de la base de conocimiento en el servicio Azure AI Search.
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. Capaz de especificar varias entradas de mensajes. Cada entrada con role:contentformato , donde rol es user o assistant (por ejemplo, user:How many docs?).

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Open World: ✅ | Solo lectura: ✅ | Secreto: ❌ | Local requerido: ❌

Conocimientos: Obtener origen

Obtiene los detalles de los orígenes de conocimiento de Azure AI Search. Un origen de conocimiento puede apuntar directamente a un índice de Azure AI Search existente o puede representar datos externos (por ejemplo, un contenedor de almacenamiento de blobs) que Azure AI Search haya indexado internamente. Estas fuentes de conocimiento las usan las bases de conocimiento durante la recuperación. Si no se proporciona un nombre de origen de conocimiento específico, el comando devuelve los detalles de todos los orígenes de conocimiento del servicio especificado.

Algunas solicitudes de ejemplo incluyen:

  • Obtener detalles de origen: "Mostrar detalles del origen de conocimiento "documentos" en mi servicio de búsqueda".
  • Ver todos los orígenes: "Enumerar todos los orígenes de conocimiento en mi servicio de búsqueda de IA".
  • Información de origen: "¿Qué orígenes de conocimiento están configurados en "my-search-service"?"
Parámetro Obligatorio u opcional Description
Servicio Obligatorio Nombre del servicio Azure AI Search (por ejemplo, my-search-service).
Fuente de conocimiento Opcional Nombre del origen de conocimiento en el servicio Azure AI Search.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Open World: ❌ | Solo lectura: ✅ | Secreto: ❌ | Local requerido: ❌

Servicio: Enumerar servicios

Use azure MCP Server para enumerar todos los servicios de AI Search de una suscripción. Este comando proporciona información general rápida de los servicios de búsqueda.

Algunas solicitudes de ejemplo incluyen:

  • Enumerar servicios: "Enumerar todos mis servicios de BÚSQUEDA de IA en mi suscripción".
  • Mostrar servicios: "¿Qué servicios de búsqueda de IA tengo?"
  • Búsqueda de servicios: "Necesito ver mis recursos de Azure AI Search"

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Open World: ❌ | Solo lectura: ✅ | Secreto: ❌ | Local requerido: ❌