Azure MCP Server-hulpprogramma's voor Azure AI Zoeken

Met de MCP-server (Azure Model Context Protocol) kunt u Azure AI Zoeken-resources beheren, waaronder zoekservices, indexen, kennisbronnen en knowledge bases met prompts in natuurlijke taal.

Azure AI Zoeken (voorheen Azure Cognitive Search) is een cloudzoekservice die API's en hulpprogramma's biedt voor het bouwen van toepassingen en agents die het RAG-patroon (Retrieval Augmented Generation) volgen. Het ondersteunt vector- en trefwoorden ophalen, rerankeren en agentisch ophalen; Zie de documentatie voor Azure AI Zoeken voor meer informatie.

Opmerking

Elke Azure AI Zoeken-knowledge base maakt een systeemeigen MCP-eindpunt beschikbaar voor direct ophalen. Zie Het MCP-eindpunt aanroepen voor meer informatie.

Opmerking

Hulpprogrammaparameters: de Hulpprogramma's van Azure MCP Server definiëren parameters voor gegevens die ze nodig hebben om taken uit te voeren. Sommige van deze parameters zijn specifiek voor elk hulpprogramma en worden hier beschreven. Andere parameters zijn globaal en worden gedeeld door alle hulpprogramma's. Zie Hulpprogrammaparameters voor meer informatie.

Zoekindex ophalen

Met dit hulpprogramma wordt gedetailleerde informatie opgehaald over Azure AI Zoeken-indexen, waaronder indexschema, velden, analysefuncties, scoreprofielen en andere indexeigenschappen. Wanneer u een indexnaam opgeeft, worden eigenschappen voor die index geretourneerd; zonder een indexnaam retourneert deze alle indexen in de opgegeven service.

Voorbeelden van prompts zijn:

  • "Toon mij de details van de index "products-index" in de Azure AI Zoeken-service "my-search-service"."
  • "Alle indexen weergeven in de Azure AI Zoeken-service 'enterprise-search'.
  • "Welke velden bevinden zich in de index 'users' in service 'contoso-search'?
Kenmerk Verplicht of optioneel Description
Service Verplicht De naam van de Azure AI Zoeken-service (bijvoorbeeld my-search-service).
Index Optioneel De naam van de zoekindex in de Azure AI Zoeken-service.

Hints voor aantekening van hulpprogramma's:

Destructief Idempotent (onveranderlijk bij herhaald gebruik) Open wereld Alleen lezen Secret Lokaal vereist
❌ ✅ ❌ ✅ ❌ ❌

Zoekindex voor query's

Met dit hulpprogramma wordt een zoekquery uitgevoerd op basis van een Azure AI Zoeken-index en worden de overeenkomende documenten en relevantiemetagegevens geretourneerd. Resultaten zijn meestal documentvelden, een relevantiescore en eventuele tekstpunten die overeenkomen met de query.

Het hulpprogramma selecteert automatisch alleen-trefwoorden of hybride zoekopdrachten op basis van het schema van de doelindex. Er is geen parameter om beide gedragingen af te dwingen:

  • Trefwoorden zoeken: als de index geen vectorvelden heeft, verzendt het hulpprogramma de querytekst als een lexicale (trefwoord) zoekopdracht en retourneert overeenkomsten die zijn gerangschikt op traditionele tekstrelevantie.
  • Hybride zoekopdracht: Als de index een of meer vectorvelden heeft die gebruikmaken van een vectorzoekprofiel met een geconfigureerde vectorizer, verzendt het hulpprogramma uw querytekst als een lexicale query en een vectorquery. Azure AI Zoeken voert zowel zoekopdrachten uit als voegt de twee gerangschikte resultatensets samen met behulp van Recicimaal Rank Fusion (RRF) om één gecombineerde rangschikking te produceren.

Hybride zoekopdrachten werken alleen wanneer de index vectorvelden definieert, deze velden verwijzen naar een vectorzoekprofiel en de vectorizer van het profiel volledig is geconfigureerd (bijvoorbeeld een Azure OpenAI-insluitingsimplementatie) zodat Azure AI Zoeken uw querytekst tijdens de query kan converteren naar een vector. Als de vectorizer van een vectorveld niet is geconfigureerd of niet bereikbaar is, kan de query mislukken in plaats van op de achtergrond terug te vallen op zoekopdrachten met alleen trefwoorden.

Dit hulpprogramma biedt geen ondersteuning voor het aanvragen van alleen vectorzoekopdrachten: deze bevat altijd uw querytekst als lexicale query naast vectorquery's, zodat u het trefwoordgedeelte van een hybride query niet kunt overslaan. Het biedt ook geen ondersteuning voor multimodale vectorzoekopdrachten (afbeeldingen of audio). Met de optionele parameters queryType en semanticConfiguration kunt u de lexicale querysyntaxis (simple of full) kiezen of kiezen voor semantische rangschikking van de resultaten, maar ze veranderen niets aan de vraag of de automatische hybride vectorzoekopdracht die hier wordt beschreven, wordt toegepast.

Voorbeelden van prompts zijn:

  • "Zoek naar 'machine learning' in de index 'documenten' van mijn 'contoso-search'-service."
  • Voer een query uit op de index 'products' voor 'noise-canceling hoofdtelefoons' in de Azure AI Zoeken-service 'fabrikam-search'.
  • "Zoek in mijn 'content'-index in 'my-search-service' naar alles wat 'klimaatverandering' noemt."
  • Zoek in de index 'products-vectorized' in 'contoso-search' naar 'comfortabele waterdichte wandelschoenen'.

Als products-vectorized vectorvelden met een geconfigureerde vectorizer zijn geactiveerd, activeert deze prompt hybride zoekopdracht: het hulpprogramma retourneert resultaten gerangschikt op RRF, waarbij producten worden gecombineerd waarvan de tekst overeenkomt met de trefwoorden met producten die conceptueel vergelijkbaar zijn (bijvoorbeeld 'geïsoleerde trailschoenen'), zelfs zonder een exacte trefwoordovereenkomst.

Kenmerk Verplicht of optioneel Description
Service Verplicht De naam van de Azure AI Zoeken-service (bijvoorbeeld my-search-service).
Index Verplicht De naam van de zoekindex in de Azure AI Zoeken-service.
Vraag Verplicht De zoekquery die moet worden uitgevoerd op basis van de Azure AI Zoeken-index.
Querytype Optioneel De queryverwerking die moet worden gebruikt. simple maakt gebruik van de eenvoudige querysyntaxis ( full standaard) maakt gebruik van de volledige Lucene-querysyntaxis en semantic past semantische classificatie toe naast elke automatische hybride vectorzoekopdracht. semantic vereist dat de index een semantische configuratie heeft.
Semantische configuratie Optioneel De semantische configuratie die moet worden gebruikt wanneer querytypesemantic is. Als u dit weglaat, wordt de standaard-semantische configuratie van de index gebruikt.

Hints voor aantekening van hulpprogramma's:

Destructief Idempotent (onveranderlijk bij herhaald gebruik) Open wereld Alleen lezen Secret Lokaal vereist
❌ ✅ ❌ ✅ ❌ ❌

Kennisbank ophalen

Dit hulpprogramma haalt details op voor Azure AI Zoeken-knowledge bases. Knowledge bases bevatten mogelijkheden voor het ophalen en redeneren van gegevens over een of meer kennisbronnen of indexen. Als u geen knowledge base-naam opgeeft, worden er details geretourneerd voor alle knowledge bases binnen de opgegeven service.

Voorbeelden van prompts zijn:

  • Geef een overzicht van alle kennisbanken in de Azure AI Zoeken-service 'my-search-service'.
  • Toon mij de kennisbanken in de service 'contoso-search'.
  • Haal de details op van kennisbank 'support-agent' in de Azure AI Zoeken-service 'enterprise-search'.
Kenmerk Verplicht of optioneel Description
Service Verplicht De naam van de Azure AI Zoeken-service (bijvoorbeeld my-search-service).
Kennisbasis Optioneel De naam van de knowledge base in de Azure AI Zoeken-service.

Hints voor aantekening van hulpprogramma's:

Destructief Idempotent (onveranderlijk bij herhaald gebruik) Open wereld Alleen lezen Secret Lokaal vereist
❌ ✅ ❌ ✅ ❌ ❌

Ophalen uit knowledge base

Met dit hulpprogramma wordt een ophaalbewerking uitgevoerd op basis van een Azure AI Zoeken-knowledge base om relevante informatie uit de bijbehorende gegevensbronnen te vinden. Geef een eenmalige query op voor retrieval, of een of meer gespreksberichten in role:content-indeling. Het opgeven van zowel query's als berichten is niet toegestaan.

Voorbeelden van prompts zijn:

  • 'Voer een ophaalbewerking uit met knowledge base 'support-agent' in de Azure AI Zoeken-service 'my-search-service' voor de query 'stappen voor wachtwoordherstel'.
  • "Vraag de Knowledge Base 'product-docs' in de zoekservice 'contoso-search' om informatie over API-frequentielimieten op te halen."
  • 'Query uitvoeren op knowledge base 'hr-policies' in zoekservice 'hr-search' over 'vakantietoerekeningsbeleid'.
Kenmerk Verplicht of optioneel Description
Service Verplicht De naam van de Azure AI Zoeken-service (bijvoorbeeld my-search-service).
Kennisbasis Verplicht De naam van de knowledge base in de Azure AI Zoeken-service.
Vraag Optioneel Query in natuurlijke taal voor ophalen wanneer er geen gespreksberichtgeschiedenis wordt opgegeven.
Messages Optioneel Berichten over gespreksgeschiedenis die zijn doorgegeven aan de Knowledge Base. Elke vermelding die is opgemaakt als role:content, waarbij de rol user of assistant is (bijvoorbeeld user:What policies apply to archived invoices?).

Hints voor aantekening van hulpprogramma's:

Destructief Idempotent (onveranderlijk bij herhaald gebruik) Open wereld Alleen lezen Secret Lokaal vereist
❌ ✅ ✅ ✅ ❌ ❌

Kennisbron ophalen

Dit hulpprogramma haalt details op van Azure AI Zoeken-kennisbronnen. Een kennisbron kan verwijzen naar een bestaande Azure AI Zoeken-index of externe gegevens vertegenwoordigen (bijvoorbeeld een blobopslagcontainer) die azure AI Search heeft geïndexeerd. Kennisbronnen worden gebruikt door knowledge bases tijdens het ophalen. Als u geen naam voor een kennisbron opgeeft, worden er details geretourneerd voor alle kennisbronnen in de opgegeven service.

Voorbeelden van prompts zijn:

  • "Vermeld alle kennisbronnen in de Azure AI Zoeken-service 'my-search-service'.
  • 'Toon de kennisbronnen in de Azure AI Zoeken-service 'contoso-search'.
  • Haal de details op van de kennisbron 'product-index' in zoekdienst 'enterprise-search'.
Kenmerk Verplicht of optioneel Description
Service Verplicht De naam van de Azure AI Zoeken-service (bijvoorbeeld my-search-service).
Kennisbron Optioneel De naam van de kennisbron in de Azure AI Zoeken-service.

Hints voor aantekening van hulpprogramma's:

Destructief Idempotent (onveranderlijk bij herhaald gebruik) Open wereld Alleen lezen Secret Lokaal vereist
❌ ✅ ❌ ✅ ❌ ❌

Zoekservices weergeven

Dit hulpprogramma bevat Azure AI Zoeken-services in een abonnement en retourneert details voor elke service, waaronder naam, locatie, SKU, inrichtingsstatus en eindpunt.

Voorbeelden van prompts zijn:

  • De Azure AI Zoeken-services in mijn abonnement op een rijtje zetten.
  • "Welke AI Search-services heb ik?"
  • Toon mij mijn Azure AI Zoeken-resources.

Hints voor aantekening van hulpprogramma's:

Destructief Idempotent (onveranderlijk bij herhaald gebruik) Open wereld Alleen lezen Secret Lokaal vereist
❌ ✅ ❌ ✅ ❌ ❌

Verwante inhoud

  • Last updated on