Dela via


Azure AI Foundry-verktyg för Azure MCP Server

Med Azure MCP Server kan du hantera Azure-resurser, inklusive Azure AI Foundry-modeller och distributioner, med frågor om naturligt språk. Den här funktionen hjälper dig att snabbt hantera dina AI-modeller utan att behöva komma ihåg komplex syntax.

Azure AI 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. Med Azure AI Foundry kan du enklare införliva AI-funktioner i dina program.

När du ansluter till din Azure AI Foundry-resurs kräver Azure MCP-servern antingen slutpunkten eller resursgruppen för din Azure AI 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

Verktygsparametrar: Azure MCP Server-verktygen 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.

Agenter: Anslut och kör

Anslut till en specifik Azure AI-agent och kör en fråga. Det här kommandot returnerar agentens svar tillsammans med tråden och kör ID:t för potentiell utvärdering.

Exempel på frågor är:

  • Anslut till agenten: "Anslut till agentens supportrobot" och fråga om biljettstatus
  • Fråga specifik agent: "Fråga agenten 'sales-bot' för den senaste försäljningsrapporten"
  • Använd kontext: "Anslut till agenten 'hr-bot' med kontext från den senaste konversationen"
Parameter Obligatorisk eller valfri Description
Handläggare Required ID:t för agenten som ska interagera med.
Fråga Required Frågan som skickas till agenten.
Slutpunkt Required Slutpunkts-URL:en för Azure AI Foundry-projektet eller tjänsten.

Agenter: Utvärdera en agent

Kör agentutvärdering på agentdata. Kräver JSON-strängar för fråge-, svars- och verktygsdefinitioner.

Exempel på frågor är:

  • Utvärdera aktivitetsefterlevnad: "Utvärdera den fullständiga fråga och det svar jag fick från min agent för task_adherence"
  • Kontrollera avsiktsmatchning: "Utvärdera min agent svar för intent_resolution med hjälp av frågan om prisplaner"
  • Verifiera verktygets noggrannhet: "Analysera tool_call_accuracy av min försäljningsrobots svar på kundförfrågan"
  • Utvärdera agentprestanda: "Utvärdera min supportagents svar på den tekniska problemfrågan med hjälp av task_adherence"
  • Omfattande utvärdering: "Kör en utvärdering av hr-agentens hantering av den anställdas onboarding-fråga med alla svarsdata"
Parameter Obligatorisk eller valfri Description
Fråga Required Frågan som skickas till agenten.
Utvärderaren Required Namnet på utvärderaren som ska användas (intent_resolution, tool_call_accuracy, task_adherence).
Svar Optional Svaret från agenten.
Verktygsdefinitioner Optional Valfria verktygsdefinitioner som gjorts av agenten i JSON-format.
Slutpunkt Required Slutpunkts-URL:en för Azure AI Foundry-projektet eller tjänsten i formatet https://<resource>.services.ai.azure.com/api/projects/<project-name>.
Azure OpenAI-distribution Required Distributionsnamnet för Azure OpenAI-modellen som ska användas i utvärderingen.

Agenter: Lista agenter

Visa en lista över alla Azure AI-agenter i ett Azure AI Foundry-projekt. Visar agenter som kan användas för AI-arbetsflöden, utvärderingar och interaktiva uppgifter.

Exempel på frågor är:

  • Visa alla agenter: "Visa mig alla agenter i Azure AI Foundry"
  • Lista efter projekt: "Lista alla AI-agenter i mitt "customer-service"-projekt"
  • Kontrollera tillgängliga agenter: "Vilka agenter har jag konfigurerat i mitt Azure AI Foundry-konto?"
  • Agentinventering: "Jag behöver en fullständig lista över alla agenter i min Azure AI-miljö"
  • Hitta specifika agenter: "Visa mig alla chattrobotagenter som är tillgängliga i min Azure AI Foundry-resurs"
Parameter Obligatorisk eller valfri Description
Slutpunkt Required Slutpunkts-URL:en för Azure AI Foundry-projektet eller tjänsten i formatet https://<resource>.services.ai.azure.com/api/projects/<project-name>.

Agenter: Fråga och köra en agent

Fråga en agent och utvärdera dess svar i en enda åtgärd. Det här kommandot returnerar både agentsvaret och utvärderingsresultatet.

Exempel på frågor är:

  • Fråga och utvärdera: "Fråga agenten 'support-bot' om ärendestatus och utvärdera aktivitetsefterlevnad"
  • Enskild åtgärd: "Fråga agenten 'sales-bot' för den senaste försäljningsrapporten och kontrollera avsiktsmatchning"
  • Kombinerad åtgärd: "Anslut till agenten 'hr-bot', fråga om registrering och utvärdera anropsnoggrannhet för verktyg"
  • Fullständig cykel: "Fråga "marketing-bot" för kampanjidéer och utvärdera svaret för uppgiftsefterlevnad"
  • Kontroll från slutpunkt till slutpunkt: "Fråga 'devops-bot' om distributionsstatus och utvärdera avsiktsmatchning"
Parameter Obligatorisk eller valfri Description
Agent-ID Required ID:t för agenten som ska interagera med.
Fråga Required Frågan som skickas till agenten.
Slutpunkt Required Slutpunkts-URL:en för Azure AI Foundry-projektet eller tjänsten i formatet https://<resource>.services.ai.azure.com/api/projects/<project-name>
Utvärderarna Optional Listan över utvärderare som ska användas för utvärdering, avgränsad med kommatecken. Om det inte anges används alla utvärderare.
Azure OpenAI-slutpunkt Required Slutpunkts-URL:en för Azure OpenAI-tjänsten som ska användas i utvärderingen.
Azure OpenAI-distribution Required Distributionsnamnet för Azure OpenAI-modellen.

Kunskap: Lista kunskapsindex

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

  • Hitta kunskapsindex som skapats i Azure AI 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 i Azure AI Foundry"
  • Filtrera efter projekt: "Lista kunskapsindex i projektet "support-bot"
  • Sök efter namn: "Hitta kunskapsindexet med namnet 'product-faqs'"
  • Filtrera efter tagg: "Lista kunskapsindex taggade med "säkerhet" eller "onboarding""
  • Visa indexinformation: "Visa information för kunskapsindexet för kundtjänst, inklusive antal dokument och senast uppdaterat datum"
Parameter Obligatorisk eller valfri Description
Slutpunkt Required Slutpunkts-URL:en för Azure AI Foundry-projektet eller tjänsten i formatet https://<resource>.services.ai.azure.com/api/projects/<project-name>

Kunskap: Hämta indexschema

Hämta den detaljerade schemakonfigurationen för ett specifikt kunskapsindex från Azure AI 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 mig schemat för kunskapsindexet 'product-facts'"
Parameter Obligatorisk eller valfri Description
Slutpunkt Required Slutpunkts-URL:en för Azure AI Foundry-projektet eller tjänsten i formatet https://<resource>.services.ai.azure.com/api/projects/<project-name>
Index Required Namnet på kunskapsindexet.

Modeller: Lista tillgängliga modeller

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

Exempel på frågor är:

  • Visa alla modeller: "Visa alla tillgängliga AI-modeller i Azure AI Foundry"
  • Filtrera efter kostnadsfri användning: "Lista alla kostnadsfria modeller som är tillgängliga för prototyper i Azure AI Foundry som jag kan använda på lekplatsen"
  • Filtrera efter kostnadsfri användning: "Lista alla kostnadsfria modeller som är tillgängliga för prototyper i Azure AI Foundry"
  • Filtrera efter utgivare: "Visa modeller som publicerats av Microsoft i Azure AI Foundry"
  • Filtrera efter licens: "Vilka modeller med Apache-licens är tillgängliga i Azure AI Foundry?"
  • Sök efter namn: "Hitta lamamodellen i Azure AI Foundry"
Parameter Obligatorisk eller valfri Description
Sök efter gratis lekplats Optional Om värdet är true returneras en lista över modeller från Azure AI Foundry som du också kan använda med GitHub-slutpunkten för slutsatsdragning och GitHub PAT-token. Om det är falskt returneras en lista över modeller från Azure AI Foundry, oavsett GitHub-stöd. Mer information finns i GitHub-modeller.
Publisher Optional Ett filter för att ange utgivaren av de modeller som ska hämtas.
Licens Optional Ett filter för att ange licenstypen för de modeller som ska hämtas.
Modell Optional Namnet på modellen som ska sökas efter.

Modeller: Distribuera en modell

Distribuera en AI-modell till din Azure-miljö. Använd det här kommandot för att distribuera valda modeller från Azure AI Foundry och göra dem tillgängliga för användning i dina program.

Exempel på frågor är:

  • Distribuera med nödvändiga parametrar: "Distribuera GPT-4-modellen i OpenAI-format till mitt ai-services-konto i resursgruppen ai-projects med prenumerations dev-subscription"
  • Ange distributionsnamn: "Konfigurera en distribution med namnet textinbäddning för Ada-inbäddningsmodellen i mitt AI-tjänstkonto med Standard SKU"
  • Inkludera modellversion: "Distribuera version 2 av Llama-modellen från Meta till mitt Azure AI-tjänstkonto med skalningskapacitet på 3"
  • Distribuera till en specifik resursgrupp: "Skapa en distribution med namnet content-generation with GPT-4 model in my ai-central service in resource group ml-experiments"
  • Konfigurera skalning: "Distribuera Claude-modellen till min Azure AI-tjänst med automatisk skalning aktiverat och maximal kapacitet på 5"
Parameter Obligatorisk eller valfri Description
Deployment Required Namnet på distributionen av Azure AI Foundry-modellen.
Modell Required Namnet på den modell som ska distribueras.
Modellformat Required Modellens format (till exempel OpenAI, Meta, Microsoft).
Azure AI-tjänster Required Namnet på det Azure AI-tjänstkonto som ska distribueras till.
resursgrupp Required Namnet på den Azure-resursgrupp där modellen ska distribueras.
Modellversion Optional Den version av modellen som ska distribueras.
Modellkälla Optional Modellens källa.
Skalningstyp Optional Skalningstypen för distributionen.
Skala kapacitet Optional Skalningskapaciteten för distributionen.
SKU Optional SKU-namnet för distributionen.
SKU-kapacitet Optional SKU-kapaciteten för distributionen.

Modeller: Lista modelldistributioner

Lista modelldistributioner i ett Azure AI Foundry-projekt (Cognitive Services). Visar för närvarande distribuerade AI-modeller på projektnivå.

Exempel på frågor är:

  • Lista distributioner i produktion: "Visa alla modelldistributioner på min https://my-example-resource.openai.azure.com slutpunkt"
  • Kontrollera den specifika slutpunkten: "Vilka modeller distribueras för närvarande till https://my-example-resource.openai.azure.com slutpunkten?"
  • Visa regionala distributioner: "Lista alla distributioner i min https://my-example-resource.openai.azure.com slutpunkt"
  • Kontrollera distributionsstatus: "Visa status för alla modeller som distribuerats till vår https://my-example-resource.openai.azure.com slutpunkt"
  • Se aktiva modeller: "Vilka AI-modeller körs på vår https://my-example-resource.openai.azure.com slutpunkt just nu?"
Parameter Obligatorisk eller valfri Description
Slutpunkt Required Slutpunkts-URL:en för Azure AI Foundry-projektet eller tjänsten i formatet https://<resource>.services.ai.azure.com/api/projects/<project-name>

OpenAI: Skapa chattavslutningar

Skapa chattavslut med Hjälp av Azure OpenAI i AI Foundry. Skicka meddelanden till Azure OpenAI-chattmodeller som distribuerats i din AI 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 meddelandet "Hej, hur mår du idag?"
  • 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 "Write a creative story" using deployment 'gpt-4' with temperature 0.8 and max 150 tokens on resource '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 att slutföra chatten med meddelanden: systemet 'Du är en kodningsassistent', användaren 'Hur skapar jag en funktion i Python?', assistent 'Så här...', användaren '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 distributionen "gpt-35-turbo" med frekvensstraff 0,5 och närvarostraff 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 slutförande för antal från 1 till 10" med distributionen "gpt-35-turbo" med stoppsekvenser ['5', 'STOP'] på resursen 'ai-test'"
  • Användarspårning: "Generera slutförande för "Vad är Azure AI?" med hjälp av distributionen "gpt-4" med användaridentifieraren "user-123" på resursen "prod-openai""
  • Finjusterad kontroll: "Skapa chatten slutförd för "Sammanfatta den här artikeln" med distributionen "gpt-35-turbo" med temperatur 0,2, top_p 0,9, maxtoken 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 Azure AI 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 Straffar nya token baserat på deras frekvens (-2.0 till 2.0). Standard är 0.
Närvarostraff Optional Straffar nya token baserat på närvaro (-2.0 till 2.0). Standard är 0.
Stopp Optional Upp till 4 sekvenser där API:et slutar generera ytterligare token.
Ström 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.
User Optional Valfritt användaridentifierare för övervakning av spårning och missbruk.
Autentiseringstyp Optional Vilken typ av autentisering som ska användas. Alternativen är key (standard) eller aad.

OpenAI: Skapa inbäddningar

Skapa inbäddningar med Azure OpenAI i AI Foundry. Generera vektorinbäddningar från text med hjälp av Azure OpenAI-distributioner i din AI Foundry-resurs 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"
  • Skapa vektorinbäddningar: "Skapa vektorinbäddningar för min text med Azure OpenAI med distributionen 'text-embedding-3-large' på resursen 'ai-services-prod'"
  • Inbäddning av dokument: "Generera inbäddningar för "Maskininlärning revolutionerar dataanalys" med hjälp av distributionen 'ada-002' på resursen 'embedding-service'"
  • 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äddningsdistribution"
  • 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'"
  • Specifika dimensioner: "Skapa inbäddningar för "Artificiell intelligens omvandlar affärsåtgärder" med hjälp av distributionen "text-embedding-3-large" med 1 536 dimensioner på resursen 'ai-central'"
  • Base64-format: "Generera inbäddningar för "Neurala nätverk för djupinlärning" med hjälp av distributionen 'ada-002' med base64-kodningsformat på resursen 'ml-services'"
  • Forskningstext: "Skapa vektorbäddningar för kvantberäkning visar beräkningsfördelar i specifika algoritmer" med hjälp av min text-inbäddningsdistribution"
  • 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'"
  • Teknisk dokumentation: "Skapa inbäddningar för "API-autentisering kräver giltiga autentiseringsuppgifter och rätt auktoriseringshuvuden" med hjälp av distributionen "ada-002" med float-kodning på resursen "docs-embedding""
Parameter Obligatorisk eller valfri Description
Resursnamn Required Namnet på Azure OpenAI-resursen.
Deployment Required Namnet på distributionen av Azure AI Foundry-modellen.
Indatatext Required Indatatexten som ska generera inbäddningar för.
User Optional Valfritt användaridentifierare för övervakning av spårning och missbruk.
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.

OpenAI: Skapa slutföranden

Skapa textavslutningar med Hjälp av Azure OpenAI i AI Foundry. Skicka en fråga eller fråga till Azure OpenAI-modeller som distribuerats i din AI Foundry-resurs och ta emot 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:

  • Grundläggande slutförande: "Skapa ett slutförande med uppmaningen "Vad är Azure?" använda min "gpt-35-turbo"-distribution"
  • Med temperaturkontroll: "Generera textavslut för "Förklara maskininlärning" med hjälp av distributionen "text-davinci-003" med temperatur 0,3"
  • Begränsade token: "Skapa ett slutförande med kommandotolken "Skriv en sammanfattning" med hjälp av min gpt-4-distribution med max 100 tokens
  • Kreativt skrivande: "Generera slutförande för "Berätta en historia om AI" med hjälp av distributionen "gpt-35-turbo" med temperatur 0,8 och 200 maxtoken"
  • Teknisk förklaring: "Skapa slutförande med uppmaningen "Hur fungerar molnbaserad databehandling?" använda min OpenAI-resurs "ai-services-east" och distributionen "gpt-4""
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.
Fråga efter text 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.

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

Resurser: Hämta Foundry-resurs

Få detaljerad information om Azure AI 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 AI Foundry-resurser i prenumerationen eller resursgruppen.

Exempel på frågor är:

  • Hämta specifik resurs: "Visa mig information om Azure AI Foundry-prod-resursen "ai-foundry" inklusive alla distribuerade modeller"
  • Lista alla resurser: "Vilka Azure AI 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.