Azure MCP Server-verktyg för Microsoft Foundry-tillägg

Med Azure MCP Server kan du hantera resurser för Microsoft Foundry Extensions, inklusive att skapa chatt- och textavslut, generera inbäddningar, lista modeller och arbeta med kunskapsindex, med frågor om naturligt språk.

Microsoft Foundry är en plattform för att distribuera och hantera anpassade AI-modeller i Azure. Den tillhandahåller verktyg och tjänster för utbildning, finjustering, distribution och övervakning av AI-modeller i produktionsmiljöer.

När du ansluter till resursen Microsoft Foundry kräver Azure MCP-servern antingen endpoint eller gruppen resource för din Microsoft Foundry-resurs. För åtgärder som inte kräver en specifik resurs, till exempel att visa tillgängliga modeller, krävs varken slutpunkten eller resursgruppen.

Note

Tool-parametrar: Verktygen Azure MCP Server definierar parametrar för data som de behöver för att slutföra uppgifter. Vissa av dessa parametrar är specifika för varje verktyg och dokumenteras nedan. Andra parametrar är globala och delas av alla verktyg. Mer information finns i Verktygsparametrar.

Kunskap: Lista kunskapsindexer

Hämta en lista över kunskapsindex från Foundry:

  • Hitta kunskapsindex som skapats i Foundry-projekt.
  • Använd dessa index med AI-agenter för kunskapshämtning och RAG-program.
  • Listan uppdateras när du skapar nya index eller uppdaterar befintliga.

Exempel på frågor är:

  • Visa alla index: "Visa alla kunskapsindex vid slutpunkten "https://my-example-resource.services.ai.azure.com/api/projects/my-project"
  • Filtrera efter projekt: "Lista kunskapsindex vid slutpunkten 'https://my-example-resource.services.ai.azure.com/api/projects/support-bot'"
  • Sök efter namn: "Hitta kunskapsindexet med namnet "product-faqs" på slutpunkten 'https://my-example-resource.services.ai.azure.com/api/projects/my-project'
  • Filtrera efter tagg: "Lista kunskapsindex taggade med "säkerhet" vid slutpunkten 'https://my-example-resource.services.ai.azure.com/api/projects/my-project'"
  • Visa indexinformation: "Visa information för kunskapsindexet "customer-service" vid slutpunkten 'https://my-example-resource.services.ai.azure.com/api/projects/my-project'
Parameter Obligatorisk eller valfri Description
Slutpunkt Required Slutpunkts-URL:en för Foundry-projektet eller tjänsten i formatet https://<resource>.services.ai.azure.com/api/projects/<project-name>

Anteckningsverktygstips:

Destruktiv: ❌ | Idempotent: ✅ | Öppen värld: ❌ | Skrivskyddad: ✅ | Konfidentiell: ❌ | Kräver lokal anslutning: ❌

Kunskap: Hämta indexschema

Hämta den detaljerade schemakonfigurationen för ett specifikt kunskapsindex från Foundry.

Den här åtgärden visar omfattande information om strukturen och konfigurationen av ett kunskapsindex, inklusive fältdefinitioner, datatyper, sökbara attribut och andra schemaegenskaper. Använd den här schemainformationen för att förstå hur indexet strukturerar och indexerar dina data för sökning.

Exempel på frågor är:

  • Visa indexschema: "Visa schemat för kunskapsindexet "product-facts" vid slutpunkten 'https://my-example-resource.services.ai.azure.com/api/projects/my-project'
Parameter Obligatorisk eller valfri Description
Slutpunkt Required Slutpunkts-URL:en för Foundry-projektet eller tjänsten i formatet https://<resource>.services.ai.azure.com/api/projects/<project-name>
Index Required Namnet på kunskapsindexet.

Anteckningsverktygstips:

Destruktiv: ❌ | Idempotent: ✅ | Öppen värld: ❌ | Skrivskyddad: ✅ | Konfidentiell: ❌ | Kräver lokal anslutning: ❌

OpenAI: Skapa chattavslutningar

Skapa chattavslutningar med Azure OpenAI i Foundry. Skicka meddelanden till Azure OpenAI-chattmodeller som distribuerats i din Foundry-resurs och ta emot AI-genererade konversationssvar. Stöder konversationer med flera turer med meddelandehistorik, systeminstruktioner och anpassning av svar.

Exempel på frågor är:

  • Enkel hälsning: "Skapa en chatt med meddelandematrisen "[{"roll":"användare","innehåll":"Hej, hur mår du idag?"}]" med distributionen 'gpt-35-turbo' på resursen 'openai-prod'"
  • Med systemmeddelande: "Skapa en chatt med systemmeddelandet "Du är en användbar assistent" och användarmeddelandet "Förklara kvantberäkning" med distributionen "gpt-35-turbo" på resursen 'openai-west'"
  • Kontrollera kreativiteten: "Generera en chattavslutning för 'Skriv en kreativ berättelse' med distributionen 'gpt-4', med temperatur 0,8 och max 150 tokens på resursen 'ai-central'"
  • Deterministiskt svar: "Skapa chattavslut med meddelandet "Lista 5 fakta om Mars" med hjälp av distributionen "gpt-35-turbo" med temperatur 0,1 och seed 12345 på resursen 'ai-services-prod'"
  • Konversation med historik: "Fortsätt chattkomplettering med meddelanden: system 'Du är en kodningsassistent', användare 'Hur skapar jag en funktion i Python?', assistent 'Här är hur...', användare 'Kan du visa ett exempel?'" med hjälp av distributionen "gpt-4" på resursen 'dev-openai'"
  • Med påföljder för upprepning: "Skapa slutförande för 'Beskriv fördelarna med molnbaserad databehandling' med modellen 'gpt-35-turbo' med frekvenspåföljd 0,5 och närvaropåföljd 0,3 på resursen 'ai-services-main'"
  • Direktuppspelningssvar: "Generera slutförande av direktuppspelningschatt för "Förklara maskininlärning steg för steg" med distributionen "gpt-4" med strömmen true på resursen 'openai-research'"
  • Med stoppsekvenser: "Skapa en fullföljande sekvens för 'Räkna från 1 till 10' med implementationen 'gpt-35-turbo' med stoppsekvenser ['5', 'STOP'] på resursen 'ai-test'"
  • Användarespårning: "Generera slutförande för 'Vad är Azure AI?' genom att använda distributionen gpt-4 med användaridentifieraren user-123 på resursen prod-openai
  • Finjusterad kontroll: "Skapa en chattsammanfattning för 'Sammanfatta den här artikeln' med användning av distributionen 'gpt-35-turbo' med temperatur 0,2, top_p 0,9, maximalt antal tecken 200 och AAD-autentisering på resursen 'secure-ai'"
Parameter Obligatorisk eller valfri Description
Resursnamn Required Namnet på Azure OpenAI-resursen.
Deployment Required Namnet på distributionen av Foundry-modellen.
Meddelandematris Required Matris med meddelanden i konversationen (JSON-format). Varje meddelande ska ha role och content egenskaper.
Maximalt antal token Optional Det maximala antalet token som ska genereras i slutförandet.
Temperatur Optional Styr slumpmässighet i utdata. Lägre värden gör det mer deterministiskt.
Övre p Optional Kontrollerar mångfald via kärnsampling (0,0 till 1,0). Standard är 1.0.
Frekvensstraff Optional Bestraffar nya token beroende på deras frekvens (-2.0 till 2.0). Standard är 0.
Närvarostraff Optional Straffar nya token utifrån deras förekomst (-2.0 till 2.0). Standard är 0.
Stopp Optional Upp till 4 sekvenser där API:et slutar generera ytterligare token.
Stream Optional Om du vill strömma tillbaka partiella förlopp. Standard är false.
Frö Optional Om det anges gör systemet ett bästa försök att sampla deterministiskt.
Användare Optional Valfri användaridentifierare för spårningskontroll och missbruksövervakning.

Anteckningsverktygstips:

Destruktiv: ❌ | Idempotent: ❌ | Öppen värld: ❌ | Skrivskyddad: ✅ | Konfidentiell: ❌ | Kräver lokal anslutning: ❌

OpenAI: Skapa inbäddningar

Skapa inbäddningar med Azure OpenAI i Foundry. Generera vektorinbäddningar från text med Azure OpenAI-distributioner i foundry-resursen för semantisk sökning, likhetsjämförelser, klustring eller maskininlärning.

Exempel på frågor är:

  • Grundläggande textinbäddning: "Generera inbäddningar för texten 'Azure OpenAI Service' med hjälp av min 'text-embedding-ada-002'-distribution i resursgruppen 'my-resource-group'"
  • Skapa vektorinbäddningar: "Skapa vektorinbäddningar för min text med Azure OpenAI med distributionen 'text-embedding-3-large' på resursen 'ai-services-prod' i resursgruppen 'my-resource-group'"
  • Inbäddning av dokument: "Generera inbäddningar för "Maskininlärning revolutionerar dataanalys" med hjälp av distributionen 'ada-002' på resursen 'embedding-service' i resursgruppen 'my-resource-group'"
  • Flera meningar: "Skapa inbäddningar för texten "Molnbaserad databehandling tillhandahåller skalbar infrastruktur. Det möjliggör global tillgänglighet." använda min inbäddningsinstallation i resursgruppen "my-resource-group"
  • Med användarspårning: "Generera inbäddningar för "Program för bearbetning av naturligt språk" med hjälp av distributionen 'text-embedding-3-small' med användaridentifieraren 'analytics-team' i resursgruppen 'my-resource-group'"
  • Specifika dimensioner: "Skapa inbäddningar för 'Artificiell intelligens transformerar affärsverksamheter' med hjälp av deployment 'text-embedding-3-large' med 1 536 dimensioner på resursen 'ai-central' i resursgruppen 'my-resource-group'
  • Base64-format: "Generera inbäddningar för neurala djupinlärningsnätverk" med hjälp av distributionen "ada-002" med base64-kodningsformat på resursen 'ml-services' i resursgruppen 'my-resource-group'"
  • Forskningstext: "Skapa vektorbäddningar för 'Kvantdatorer demonstrerar beräkningsfördelar i specifika algoritmer' med min text-inbäddningsdistribution i resursgruppen 'my-resource-group'"
  • Produktbeskrivning: "Generera inbäddningar för bärbar dator med höga prestanda med avancerad grafikbearbetningsenhet" med hjälp av distributionen "text-embedding-3-small" på resursen "product-ai" i resursgruppen "my-resource-group""
  • Teknisk dokumentation: "Skapa inbäddningar för "API-autentisering kräver giltiga autentiseringsuppgifter och rätt auktoriseringshuvuden" med distributionen "ada-002" med float-kodning på resursen "docs-embedding" i resursgruppen "my-resource-group"
Parameter Obligatorisk eller valfri Description
Resursgrupp Required Namnet på resursgruppen Azure. Det här är en logisk container för Azure resurser.
Resursnamn Required Namnet på Azure OpenAI-resursen.
Deployment Required Namnet på distributionen av Foundry-modellen.
Indatatext Required Indatatexten som ska generera inbäddningar för.
Användare Optional Valfri användaridentifierare för spårningskontroll och missbruksövervakning.
Kodningsformat Optional Formatet för att returnera inbäddningar i (float eller base64).
Dimensioner Optional Antalet dimensioner för inbäddningsutdata. Stöds endast i vissa modeller.

Anteckningsverktygstips:

Destruktiv: ❌ | Idempotent: ❌ | Öppen värld: ❌ | Skrivskyddad: ✅ | Konfidentiell: ❌ | Kräver lokal anslutning: ❌

OpenAI: Skapa slutföranden

Skapa textslutningar med hjälp av Azure OpenAI i Foundry. Skicka en fråga eller uppmaning till Azure OpenAI-modeller som distribuerats i din Foundry-resurs och motta genererade textsvar. Använd detta när du behöver skapa slutföranden, hämta AI-genererat innehåll, generera svar på frågor eller skapa textavslut från Azure OpenAI baserat på en fråga om indata. Stöder anpassning med temperatur- och maxtoken.

Exempel på frågor är:

  • Basic completion: "Skapa ett slutförande med kommandot "Vad är Azure?" använda min "gpt-35-turbo"-utrullning i resursgruppen "my-resource-group"
  • Med temperaturkontroll: "Generera textavslut för "Förklara maskininlärning" med hjälp av distributionen "text-davinci-003" med temperatur 0,3 i resursgruppen "my-resource-group"
  • Begränsade token: "Skapa en slutföring med uppmaningen 'Skriv en sammanfattning' med hjälp av min 'gpt-4'-distribution med högst 100 token i resursgruppen 'my-resource-group'"
  • Kreativt skrivande: "Generera komplettering för "Berätta en historia om AI" med distribueringen "gpt-35-turbo" med temperatur 0,8 och maximalt antal token 200 i resursgrupp "my-resource-group""
  • Teknisk förklaring: "Skapa slutförande med uppmaningen "Hur fungerar molnbaserad databehandling?" använda min OpenAI-resurs "ai-services-east" och distributionen "gpt-4" i resursgruppen "my-resource-group"
Parameter Obligatorisk eller valfri Description
Resursgrupp Required Namnet på den Azure resursgrupp där AI-resursen finns.
Resursnamn Required Namnet på Azure OpenAI-resursen.
Deployment Required Namnet på distributionen.
Uppmaningstext Required Uppmaningstexten som ska skickas till slutförandemodellen.
Maximalt antal token Optional Det maximala antalet token som ska genereras i slutförandet.
Temperatur Optional Styr slumpmässighet i utdata. Lägre värden gör det mer deterministiskt.

Anteckningsverktygstips:

Destruktiv: ❌ | Idempotent: ❌ | Öppen värld: ❌ | Skrivskyddad: ✅ | Konfidentiell: ❌ | Kräver lokal anslutning: ❌

OpenAI: Lista modeller och distributioner

Visa en lista över alla tillgängliga OpenAI-modeller och distributioner i en Azure resurs. Det här verktyget hämtar information om distribuerade modeller, inklusive modellnamn, versioner, funktioner och distributionsstatus.

Exempel på frågor är:

  • Visa alla modeller: "Visa en lista över alla OpenAI-modeller i min ai-services-prod-resurs i resursgruppen "my-resource-group"
  • Kontrollera distributioner: "Visa alla distribuerade modeller och deras status i resursen "openai-east" i resursgruppen "my-resource-group"
  • Produktionsinventering: "Vilka modeller är tillgängliga i min "production-openai"-resurs i resursgruppen "my-resource-group"?"
  • Utvecklingskontroll: "Lista alla modeller och distributioner i min dev-ai-services-resurs i resursgruppen "my-resource-group"
  • Modellfunktioner: "Visa mig alla tillgängliga OpenAI-modeller med deras funktioner i resursen "ai-central" i resursgruppen "my-resource-group"
  • Distributionsstatus: "Vad är den aktuella statusen för alla distributioner i min "openai-west"-resurs i resursgruppen "my-resource-group"?"
  • Regionala modeller: "Lista alla tillgängliga modeller i min "europe-openai"-resurs i resursgruppen "my-resource-group""
  • Tjänstöversikt: "Ge mig en fullständig översikt över modeller och distributioner i resursen 'customer-ai' i resursgruppen 'my-resource-group'"
  • Modellversioner: "Visa mig alla modellversioner som är tillgängliga i min ai-services-main-resurs i resursgruppen "my-resource-group"
  • Resursgranskning: "Jag måste granska alla OpenAI-modeller och distributioner i resursen 'enterprise-ai' i resursgruppen 'my-resource-group'"
Parameter Obligatorisk eller valfri Description
Resursgrupp Required Namnet på resursgruppen Azure. Det här är en logisk container för Azure resurser.
Resursnamn Required Namnet på Azure OpenAI-resursen.

Anteckningsverktygstips:

Destruktiv: ❌ | Idempotent: ✅ | Öppen värld: ❌ | Skrivskyddad: ✅ | Konfidentiell: ❌ | Kräver lokal anslutning: ❌

Resurser: Hämta Foundry-resurs

Få detaljerad information om Foundry-resurser, inklusive slutpunkts-URL, plats, SKU och alla distribuerade modeller med deras konfiguration. Om ett specifikt resursnamn anges returnerar information endast för den resursen. Om inget resursnamn anges listar du alla Foundry-resurser i prenumerationen eller resursgruppen.

Exempel på frågor är:

  • Hämta specifik resurs: "Visa mig information om Foundry-prod-resursen "ai-foundry-prod" inklusive alla distribuerade modeller"
  • Lista alla resurser: "Vilka Foundry-resurser har jag i min prenumeration?"
  • Resurs med konfiguration: "Hämta slutpunkts-URL, plats och SKU-information för min "customer-ai-foundry"-gjuteriresurs"
Parameter Obligatorisk eller valfri Description
Resursnamn Optional Namnet på Azure OpenAI-resursen.

Anteckningsverktygstips:

Destruktiv: ❌ | Idempotent: ✅ | Öppen värld: ❌ | Skrivskyddad: ✅ | Konfidentiell: ❌ | Kräver lokal anslutning: ❌