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.
Kunskapsindexkommandon kräver slutpunkten för ditt Microsoft Foundry-projekt. OpenAI-kommandon kräver resursnamnet och resursgruppen. Kommandot resource get kan visa resurser utan att ange ett resursnamn.
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 här. 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.
Cli-exempelkommando
azmcp foundryextensions knowledge index list \
--endpoint <endpoint>
| Parameter |
Type |
Required |
Description |
endpoint |
string |
Yes |
Slutpunkts-URL:en för projektet eller tjänsten Microsoft Foundry. Slutpunkten följer det här mönstret: https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>. |
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 vid slutpunkten https://my-example-resource.services.ai.azure.com/api/projects/my-project"
-
Filtrera efter tagg: "Lista kunskapsindex taggade med
security 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 projektet eller tjänsten Microsoft Foundry. Slutpunkten följer det här mönstret: https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>. |
Anteckningsverktygstips:
| Destruktiv |
Idempotent |
Öppen värld |
Skrivskyddad |
Secret |
Lokalt obligatoriskt |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
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.
Cli-exempelkommando
azmcp foundryextensions knowledge index schema \
--index <index> \
--endpoint <endpoint>
| Parameter |
Type |
Required |
Description |
index |
string |
Yes |
Namnet på kunskapsindexet. |
endpoint |
string |
Yes |
Slutpunkts-URL:en för projektet eller tjänsten Microsoft Foundry. Slutpunkten följer det här mönstret: https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>. |
Exempel på frågor är:
-
Visa indexschema: "Visa schemat för kunskapsindex vid
product-facts slutpunkten https://my-example-resource.services.ai.azure.com/api/projects/my-project"
| Parameter |
Obligatorisk eller valfri |
Description |
|
Index |
Required |
Namnet på kunskapsindexet. |
|
Slutpunkt |
Required |
Slutpunkts-URL:en för projektet eller tjänsten Microsoft Foundry. Slutpunkten följer det här mönstret: https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>. |
Anteckningsverktygstips:
| Destruktiv |
Idempotent |
Öppen värld |
Skrivskyddad |
Secret |
Lokalt obligatoriskt |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
OpenAI: Skapa chattavslutningar
Skapa chattavslutningar med hjälp av 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.
Cli-exempelkommando
azmcp foundryextensions openai chat-completions-create \
--resource-name <resource-name> \
--deployment <deployment> \
--message-array <message-array> \
--resource-group <resource-group> \
[--max-tokens <max-tokens>] \
[--temperature <temperature>] \
[--top-p <top-p>] \
[--frequency-penalty <frequency-penalty>] \
[--presence-penalty <presence-penalty>] \
[--stop <stop>] \
[--stream <stream>] \
[--seed <seed>] \
[--user <user>]
| Parameter |
Type |
Required |
Description |
resource-name |
string |
Yes |
Namnet på resursen Microsoft Foundry. |
deployment |
string |
Yes |
Namnet på distributionen. |
message-array |
string |
Yes |
JSON-matris med meddelanden i konversationen. Varje meddelande ska ha role och content egenskaper. |
resource-group |
string |
Yes |
Namnet på Azure-resursgruppen. |
max-tokens |
string |
No |
Det maximala antalet token som ska genereras i slutförandet. |
temperature |
string |
No |
Styr slumpmässighet i utdata. Lägre värden gör det mer deterministiskt. |
top-p |
string |
No |
Kontrollerar mångfald via kärnsampling (0,0 till 1,0). Standardvärdet är 1.0. |
frequency-penalty |
string |
No |
Bestraffar nya token beroende på deras frekvens (-2.0 till 2.0). Standardvärdet är 0. |
presence-penalty |
string |
No |
Straffar nya token utifrån deras förekomst (-2.0 till 2.0). Standardvärdet är 0. |
stop |
string |
No |
Upp till 4 sekvenser där API:et slutar generera ytterligare token. |
stream |
string |
No |
Om du vill strömma tillbaka partiella förlopp. Standardvärdet är false. |
seed |
string |
No |
Om det anges gör systemet ett bästa försök att sampla deterministiskt. |
user |
string |
No |
Användaridentifierare för spårning och övervakning av missbruk. |
Exempel på frågor är:
-
Enkel hälsning: "Skapa en chattkomplettering med meddelandearrayen
[{"role":"user","content":"Hello, how are you today?"}] med distributionen gpt-35-turbo på resursen openai-prod"
-
Med systemmeddelande: "Skapa en chattkomplettering med systemmeddelande
You are a helpful assistant och användarmeddelande Explain quantum computing med distributionen gpt-35-turbo på resursen openai-west"
-
Styr kreativiteten: "Generera en chattslutföring för
Write a creative story med distributionen gpt-4, temperaturen 0,8 och max 150 token på resursen ai-central"
-
Deterministiskt svar: "Skapa chattavslut med meddelande
List 5 facts about Mars med hjälp av distribution 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: system
You are a coding assistant, användare How do I create a function in Python?, assistent Here's how..., användare Can you show an example? som använder distribution gpt-4 på resursen dev-openai"
-
Med straff för upprepning: "Skapa slutförande för
Describe the benefits of cloud computing med distributionen gpt-35-turbo med frekvensstraff 0,5 och närvarostraff 0,3 för resursen ai-services-main"
-
Strömningssvar: "Generera strömmad chattslutföring för
Explain machine learning step by step med distribution gpt-4 med stream true på resurs openai-research"
-
Med stoppsekvenser: "Skapa ett slutförande för
Count from 1 to 10 med distributionen gpt-35-turbo med stoppsekvenser ['5', 'STOP'] på resursen ai-test"
-
Användarspårning: "Generera slutförande för
What is Azure AI? att använda distribution gpt-4 med användaridentifierare user-123 på resursen prod-openai"
-
Finjusterad styrning: "Skapa chattslutförande för
Summarize this article med distributionen gpt-35-turbo med temperatur 0,2, top_p 0,9, maximalt 200 token och AAD-autentisering på resursen secure-ai"
| Parameter |
Obligatorisk eller valfri |
Description |
|
Resursnamn |
Required |
Namnet på resursen Microsoft Foundry. |
|
Deployment |
Required |
Namnet på distributionen av Foundry-modellen. |
|
Meddelandematris |
Required |
JSON-matris med meddelanden i konversationen. Varje meddelande ska ha role och content egenskaper. |
|
Resursgrupp |
Required |
Namnet på Azure-resursgruppen. |
|
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 |
Användaridentifierare för spårning och övervakning av missbruk. |
Anteckningsverktygstips:
| Destruktiv |
Idempotent |
Öppen värld |
Skrivskyddad |
Secret |
Lokalt obligatoriskt |
| ❌ |
❌ |
❌ |
✅ |
❌ |
❌ |
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.
Cli-exempelkommando
azmcp foundryextensions openai embeddings-create \
--resource-name <resource-name> \
--deployment <deployment> \
--input-text <input-text> \
--resource-group <resource-group> \
[--user <user>] \
[--encoding-format <encoding-format>] \
[--dimensions <dimensions>]
| Parameter |
Type |
Required |
Description |
resource-name |
string |
Yes |
Namnet på resursen Microsoft Foundry. |
deployment |
string |
Yes |
Namnet på distributionen. |
input-text |
string |
Yes |
Indatatexten som ska generera inbäddningar för. |
resource-group |
string |
Yes |
Namnet på Azure-resursgruppen. |
user |
string |
No |
Användaridentifierare för spårning och övervakning av missbruk. |
encoding-format |
string |
No |
Formatet för att returnera inbäddningar i (float eller base64). |
dimensions |
string |
No |
Antalet dimensioner för inbäddningsutdata. Stöds endast i vissa modeller. |
Exempel på frågor är:
-
Grundläggande textbä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 hjälp av Azure OpenAI med distribution
text-embedding-3-large på resurs ai-services-prod i resursgruppen my-resource-group."
-
Inbäddning av dokument: "Generera inbäddningar för
Machine learning revolutionizes data analysis med hjälp av distribution ada-002 på resurs embedding-service i resursgruppen my-resource-group."
-
Flera meningar: "Skapa inbäddningar för texten
Cloud computing provides scalable infrastructure. It enables global accessibility. med hjälp av min inbäddningsdistribution i resursgruppen my-resource-group."
-
Med användarspårning: "Generera inbäddningar för
Natural language processing applications med hjälp av distribution text-embedding-3-small med användaridentifierare analytics-team i resursgruppen my-resource-group."
-
Specifika dimensioner: "Skapa inbäddningar för
Artificial intelligence transforms business operations med hjälp av distribution text-embedding-3-large med 1 536 dimensioner på resursen ai-central i resursgruppen my-resource-group."
-
Base64-format: "Generera inbäddningar för
Deep learning neural networks med hjälp av distribution ada-002 med base64-kodningsformat på resursen ml-services i resursgruppen my-resource-group."
-
Forskningstext: "Skapa vektorbäddningar för
Quantum computing demonstrates computational advantages in specific algorithms med hjälp av min textbäddningsdistribution i resursgruppen my-resource-group."
-
Produktbeskrivning: "Generera inbäddningar för
High-performance laptop with advanced graphics processing unit med hjälp av distribution text-embedding-3-small på resurs product-ai i resursgruppen my-resource-group."
-
Teknisk dokumentation: "Skapa inbäddningar för
API authentication requires valid credentials and proper authorization headers med hjälp av distribution ada-002 med float-kodning på resursen docs-embedding i resursgruppen my-resource-group."
| Parameter |
Obligatorisk eller valfri |
Description |
|
Resursnamn |
Required |
Namnet på resursen Microsoft Foundry. |
|
Deployment |
Required |
Namnet på distributionen av Foundry-modellen. |
|
Indatatext |
Required |
Indatatexten som ska generera inbäddningar för. |
|
Resursgrupp |
Required |
Namnet på Azure-resursgruppen. |
|
Användare |
Optional |
Användaridentifierare för spårning och övervakning av 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. |
Anteckningsverktygstips:
| Destruktiv |
Idempotent |
Öppen värld |
Skrivskyddad |
Secret |
Lokalt obligatoriskt |
| ❌ |
❌ |
❌ |
✅ |
❌ |
❌ |
OpenAI: Skapa slutföranden
Skapa textavslutningar 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 den här funktionen 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.
Cli-exempelkommando
azmcp foundryextensions openai create-completion \
--deployment <deployment> \
--prompt-text <prompt-text> \
--resource-name <resource-name> \
--resource-group <resource-group> \
[--max-tokens <max-tokens>] \
[--temperature <temperature>]
| Parameter |
Type |
Required |
Description |
deployment |
string |
Yes |
Namnet på distributionen. |
prompt-text |
string |
Yes |
Uppmaningstexten som ska skickas till slutförandemodellen. |
resource-name |
string |
Yes |
Namnet på resursen Microsoft Foundry. |
resource-group |
string |
Yes |
Namnet på Azure-resursgruppen. |
max-tokens |
string |
No |
Det maximala antalet token som ska genereras i slutförandet. |
temperature |
string |
No |
Styr slumpmässighet i utdata. Lägre värden gör det mer deterministiskt. |
Exempel på frågor är:
-
Grundläggande komplettering: "Skapa en komplettering med prompten
What is Azure? med min gpt-35-turbo distribution i resursgruppen my-resource-group"
-
Med temperaturkontroll: "Generera textkomplettering för
Explain machine learning med distributionen text-davinci-003 med temperaturen 0,3 i resursgruppen my-resource-group"
-
Begränsat antal token: "Skapa en generering med prompten
Write a summary i min gpt-4-distribution med högst 100 token i resursgruppen my-resource-group"
-
Kreativt skrivande: "Generera slutförande för
Tell me a story about AI med distributionen gpt-35-turbo, temperaturen 0,8 och högst 200 token i resursgruppen my-resource-group"
-
Teknisk förklaring: "Skapa slutförande med uppmaning
How does cloud computing work? med hjälp av min OpenAI-resurs ai-services-east och distribution gpt-4 i resursgruppen my-resource-group"
| Parameter |
Obligatorisk eller valfri |
Description |
|
Deployment |
Required |
Namnet på distributionen. |
|
Uppmaningstext |
Required |
Uppmaningstexten som ska skickas till slutförandemodellen. |
|
Resursnamn |
Required |
Namnet på resursen Microsoft Foundry. |
|
Resursgrupp |
Required |
Namnet på Azure-resursgruppen. |
|
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 |
Secret |
Lokalt obligatoriskt |
| ❌ |
❌ |
❌ |
✅ |
❌ |
❌ |
OpenAI: Lista modeller och distributioner
Lista Azure OpenAI-modelldistributioner i en Microsoft Foundry-resurs. Det här verktyget hämtar information om distribuerade modeller, inklusive modellnamn, versioner, funktioner och distributionsstatus.
Cli-exempelkommando
azmcp foundryextensions openai models-list \
--resource-name <resource-name> \
--resource-group <resource-group>
| Parameter |
Type |
Required |
Description |
resource-name |
string |
Yes |
Namnet på resursen Microsoft Foundry. |
resource-group |
string |
Yes |
Namnet på Azure-resursgruppen. |
Exempel på frågor är:
-
Visa alla modeller: "Visa en lista över alla distribuerade 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 distribueras i min
production-openai resurs i resursgruppen my-resource-group?"
-
Utvecklingskontroll: "Lista alla modelldistributioner i min
dev-ai-services resurs i resursgruppen my-resource-group."
-
Modellfunktioner: "Visa mig alla distribuerade 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 modeller som distribuerats i min
europe-openai resurs i resursgruppen my-resource-group."
-
Tjänstöversikt: "Ge mig en fullständig översikt över modelldistributioner i resursen
customer-ai i resursgruppen my-resource-group."
-
Modellversioner: "Visa alla distribuerade modellversioner i min
ai-services-main resurs i resursgruppen my-resource-group."
-
Resursgranskning: "Jag måste granska alla OpenAI-modelldistributioner i resursen
enterprise-ai i resursgruppen my-resource-group."
| Parameter |
Obligatorisk eller valfri |
Description |
|
Resursnamn |
Required |
Namnet på resursen Microsoft Foundry. |
|
Resursgrupp |
Required |
Namnet på Azure-resursgruppen. |
Anteckningsverktygstips:
| Destruktiv |
Idempotent |
Öppen värld |
Skrivskyddad |
Secret |
Lokalt obligatoriskt |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
Resurser: Hämta Foundry-resurs
Lista eller hämta Microsoft Foundry-resurser och returnera information på resursnivå, till exempel slutpunkts-URL, plats, SKU, typ och etableringstillstånd. Om du anger ett resursnamn returnerar verktyget den enskilda resursen. Annars returnerar den resursinventariet inom det aktuella omfånget. För inventering av modelldistributioner i en Foundry-resurs använder du verktyget OpenAI-modellista.
Cli-exempelkommando
azmcp foundryextensions resource get \
[--resource-name <resource-name>]
| Parameter |
Type |
Required |
Description |
resource-name |
string |
No |
Namnet på resursen Microsoft Foundry. |
Exempel på frågor är:
-
Hämta specifik resurs: "Visa mig information för Foundry-resursen
ai-foundry-prod "
-
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 foundry-resurs"
| Parameter |
Obligatorisk eller valfri |
Description |
|
Resursnamn |
Optional |
Namnet på resursen Microsoft Foundry. |
Anteckningsverktygstips:
| Destruktiv |
Idempotent |
Öppen värld |
Skrivskyddad |
Secret |
Lokalt obligatoriskt |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
Relaterat innehåll