Met de Azure MCP-server kunt u resources voor Microsoft Foundry Extensions beheren, waaronder het maken van chat- en tekstvoltooiingen, het genereren van insluitingen, het weergeven van modellen en het werken met kennisindexen, met prompts voor natuurlijke taal.
Microsoft Foundry is een platform voor het implementeren en beheren van aangepaste AI-modellen in Azure. Het biedt hulpprogramma's en services voor het trainen, afstemmen, implementeren en bewaken van AI-modellen in productieomgevingen.
Voor kennisindexopdrachten is het eindpunt van uw Microsoft Foundry-project vereist. OpenAI-opdrachten vereisen de naam van de resource en de resourcegroep. Met de opdracht resource ophalen kunt u resources weergeven zonder een resourcenaam op te geven.
Note
Toolparameters: De hulpprogramma's van de 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.
Kennis: Kennisindexen vermelden
Haal een lijst met kennisindexen op uit Foundry:
- Zoek kennisindexen die zijn gemaakt in Foundry-projecten.
- Gebruik deze indexen met AI-agents voor het ophalen van kennis en RAG-toepassingen.
- De lijst wordt bijgewerkt wanneer u nieuwe indexen maakt of bestaande indexen bijwerkt.
Voorbeeld van CLI-opdracht
azmcp foundryextensions knowledge index list \
--endpoint <endpoint>
| Parameter |
Type |
Required |
Description |
endpoint |
string |
Ja |
De eindpunt-URL voor het Microsoft Foundry-project of -service. Het eindpunt volgt dit patroon: https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>. |
Voorbeelden van prompts zijn:
-
Alle indexen weergeven: "Toon alle kennisindexen op eindpunt
https://my-example-resource.services.ai.azure.com/api/projects/my-project"
-
Filteren op project: 'Kennisindexen op eindpunt
https://my-example-resource.services.ai.azure.com/api/projects/support-botvermelden'
-
Zoeken op naam: "Zoek de kennisindex met de naam
product-faqs op eindpunt https://my-example-resource.services.ai.azure.com/api/projects/my-project"
-
Filteren op tag: 'Kennisindexen vermelden die zijn getagd met
security eindpunt https://my-example-resource.services.ai.azure.com/api/projects/my-project'
-
Indexdetails weergeven: "Details weergeven voor de
customer-service kennisindex op eindpunt https://my-example-resource.services.ai.azure.com/api/projects/my-project"
| Parameter |
Verplicht of optioneel |
Description |
|
Eindpunt |
Required |
De eindpunt-URL voor het Microsoft Foundry-project of -service. Het eindpunt volgt dit patroon: https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>. |
Hints voor toolannotaties:
| Destructief |
Idempotent (onveranderlijk bij herhaald gebruik) |
Open wereld |
Alleen lezen |
Secret |
Lokaal vereist |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
Kennis: Indexschema ophalen
Haal de gedetailleerde schemaconfiguratie van een specifieke kennisindex op uit Foundry.
Deze bewerking bevat uitgebreide informatie over de structuur en configuratie van een kennisindex, waaronder velddefinities, gegevenstypen, doorzoekbare kenmerken en andere schema-eigenschappen. Gebruik deze schema-informatie om te begrijpen hoe de indexstructuren en indexen uw gegevens structureren voor zoekdoeleinden.
Voorbeeld van CLI-opdracht
azmcp foundryextensions knowledge index schema \
--index <index> \
--endpoint <endpoint>
| Parameter |
Type |
Required |
Description |
index |
string |
Ja |
De naam van de kennisindex. |
endpoint |
string |
Ja |
De eindpunt-URL voor het Microsoft Foundry-project of -service. Het eindpunt volgt dit patroon: https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>. |
Voorbeelden van prompts zijn:
-
Indexschema weergeven: 'Toon het schema voor kennisindex
product-facts op eindpunt https://my-example-resource.services.ai.azure.com/api/projects/my-project'
| Parameter |
Verplicht of optioneel |
Description |
|
Index |
Required |
De naam van de kennisindex. |
|
Eindpunt |
Required |
De eindpunt-URL voor het Microsoft Foundry-project of -service. Het eindpunt volgt dit patroon: https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>. |
Hints voor toolannotaties:
| Destructief |
Idempotent (onveranderlijk bij herhaald gebruik) |
Open wereld |
Alleen lezen |
Secret |
Lokaal vereist |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
OpenAI: Chatvoltooiing voltooien
Maak chatvoltooiingen met behulp van Azure OpenAI in Foundry. Berichten verzenden naar Azure OpenAI-chatmodellen die zijn geïmplementeerd in uw Foundry-resource en door AI gegenereerde gespreksreacties ontvangen. Ondersteunt meerledige gesprekken met berichtgeschiedenis, systeeminstructies en aanpassing van reacties.
Voorbeeld van CLI-opdracht
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 |
Ja |
De naam van de Microsoft Foundry-resource. |
deployment |
string |
Ja |
De naam van de implementatie. |
message-array |
string |
Ja |
JSON-matrix met berichten in het gesprek. Elk bericht moet zowel over role als content eigenschappen beschikken. |
resource-group |
string |
Ja |
De naam van de Azure-resourcegroep. |
max-tokens |
string |
Nee |
Het maximum aantal tokens dat moet worden gegenereerd tijdens de voltooiing. |
temperature |
string |
Nee |
Reguleert willekeurigheid in de uitvoer. Lagere waarden maken het deterministischer. |
top-p |
string |
Nee |
Controleert diversiteit via kernsampling (0,0 tot 1.0). De standaardwaarde is 1.0. |
frequency-penalty |
string |
Nee |
Bestraft nieuwe tokens op basis van hun frequentie (-2.0 tot 2.0). De standaardwaarde is 0. |
presence-penalty |
string |
Nee |
Bestraft nieuwe tokens op basis van aanwezigheid (-2.0 tot 2.0). De standaardwaarde is 0. |
stop |
string |
Nee |
Maximaal 4 reeksen waarbij de API stopt met het genereren van verdere tokens. |
stream |
string |
Nee |
Moet gedeeltelijke voortgang worden gestreamd? De standaardwaarde is vals. |
seed |
string |
Nee |
Indien opgegeven, doet het systeem er alles aan om deterministisch te samplen. |
user |
string |
Nee |
Gebruikers-id voor tracering en misbruikcontrole. |
Voorbeelden van prompts zijn:
-
Eenvoudige begroeting: "Een chatvoltooiing met berichtmatrix
[{"role":"user","content":"Hello, how are you today?"}] maken met behulp van implementatie gpt-35-turbo op resource openai-prod"
-
Met systeembericht: "Maak een chataanvulling met systeembericht
You are a helpful assistant en gebruikersbericht Explain quantum computing met behulp van uitrol gpt-35-turbo op hulpbron openai-west"
-
Creativiteit beheren: "Genereer een chataanvulling voor
Write a creative story met implementatie gpt-4, met een temperatuur van 0,8 en een maximum van 150 tokens voor resource ai-central"
-
Deterministisch antwoord: "Chatvoltooiing maken met bericht
List 5 facts about Mars met behulp van implementatie gpt-35-turbo met temperatuur 0.1 en seed 12345 op resource ai-services-prod"
-
Gesprek met chatgeschiedenis: "Chatvoltooiing voortzetten met berichten: systeem
You are a coding assistant, gebruiker How do I create a function in Python?, assistent Here's how..., gebruiker Can you show an example? met de implementatie gpt-4 op de resource dev-openai"
-
Met straffen voor herhaling: "Genereer een voltooiing voor
Describe the benefits of cloud computing met implementatie gpt-35-turbo met frequentiestraf 0,5 en aanwezigheidsstraf 0,3 voor resource ai-services-main"
-
Streamingreactie: "Genereer een streamende chatvoltooiing voor
Explain machine learning step by step met implementatie gpt-4 en stream ingesteld op true voor resource openai-research"
-
Met stopreeksen: "Voltooiing genereren voor
Count from 1 to 10 met implementatie gpt-35-turbo met stopreeksen ['5', 'STOP'] op de resource ai-test"
-
Gebruikerstracering: "Voltooiing genereren voor
What is Azure AI? met implementatie gpt-4 met gebruikers-id user-123 op resource prod-openai"
-
Nauwkeurige afstemming: "Een chataanvulling maken voor
Summarize this article met implementatie gpt-35-turbo met temperatuur 0.2, top_p 0.9, maximaal 200 tokens en AAD-verificatie voor resource secure-ai"
| Parameter |
Verplicht of optioneel |
Description |
|
Naam van bron |
Required |
De naam van de Microsoft Foundry-resource. |
|
Deployment |
Required |
De naam van de Foundry-modelimplementatie. |
|
Berichtmatrix |
Required |
JSON-matrix met berichten in het gesprek. Elk bericht moet zowel over role als content eigenschappen beschikken. |
|
Resourcegroep |
Required |
De naam van de Azure-resourcegroep. |
|
Maximum aantal tokens |
Optional |
Het maximum aantal tokens dat moet worden gegenereerd tijdens de voltooiing. |
|
Temperatuur |
Optional |
Reguleert willekeurigheid in de uitvoer. Lagere waarden maken het deterministischer. |
|
Bovenste p |
Optional |
Controleert diversiteit via kernsampling (0,0 tot 1.0). De standaardinstelling is 1.0. |
|
Frequentieboete |
Optional |
Bestraft nieuwe tokens op basis van hun frequentie (-2.0 tot 2.0). De standaardinstelling is 0. |
|
Aanwezigheidsstraf |
Optional |
Bestraft nieuwe tokens op basis van aanwezigheid (-2.0 tot 2.0). De standaardinstelling is 0. |
|
Stop |
Optional |
Maximaal vier reeksen waarbij de API stopt met het genereren van verdere tokens. |
|
Stream |
Optional |
Moet gedeeltelijke voortgang worden gestreamd? De standaardinstelling is false. |
|
Zaad |
Optional |
Indien opgegeven, zal het systeem zijn best doen om deterministisch te bemonsteren. |
|
User |
Optional |
Gebruikers-id voor tracering en misbruikcontrole. |
Hints voor toolannotaties:
| Destructief |
Idempotent (onveranderlijk bij herhaald gebruik) |
Open wereld |
Alleen lezen |
Secret |
Lokaal vereist |
| ❌ |
❌ |
❌ |
✅ |
❌ |
❌ |
OpenAI: insluitingen maken
Maak insluitingen met behulp van Azure OpenAI in Foundry. Genereer vector-insluitingen van tekst met behulp van Azure OpenAI-implementaties in uw Foundry-resource voor semantische zoekopdrachten, overeenkomsten, clustering of machine learning.
Voorbeeld van CLI-opdracht
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 |
Ja |
De naam van de Microsoft Foundry-resource. |
deployment |
string |
Ja |
De naam van de implementatie. |
input-text |
string |
Ja |
De invoertekst voor het genereren van insluitingen voor. |
resource-group |
string |
Ja |
De naam van de Azure-resourcegroep. |
user |
string |
Nee |
Gebruikers-id voor tracering en misbruikcontrole. |
encoding-format |
string |
Nee |
Het formaat waarin embeddings worden geretourneerd (float of base64). |
dimensions |
string |
Nee |
Het aantal dimensies voor de embedding-uitvoer. Alleen ondersteund in sommige modellen. |
Voorbeelden van prompts zijn:
-
Basistekst insluiten: 'Genereer insluitingen voor de tekst
Azure OpenAI Service met behulp van mijn text-embedding-ada-002 implementatie in de resourcegroep my-resource-group'.
-
Vector-embeddings maken: "Vector-embeddings voor mijn tekst maken met Azure OpenAI met implementatie
text-embedding-3-large op resource ai-services-prod in resourcegroep my-resource-group."
-
Document insluiten: 'Genereer insluitingen voor
Machine learning revolutionizes data analysis met behulp van implementatie ada-002 op resource embedding-service in resourcegroep my-resource-group'.
-
Meerdere zinnen: 'Insluitingen voor de tekst
Cloud computing provides scalable infrastructure. It enables global accessibility. maken met behulp van mijn insluitingsimplementatie in de resourcegroep my-resource-group'.
-
Met het bijhouden van gebruikers: "Genereer insluitingen voor
Natural language processing applications met behulp van implementatie text-embedding-3-small met gebruikers-id analytics-team in resourcegroep my-resource-group."
-
Specifieke dimensies: 'Maak insluitingen voor
Artificial intelligence transforms business operations met behulp van implementatie text-embedding-3-large met 1536 dimensies op de resource ai-central in de resourcegroep my-resource-group'.
-
Base64-indeling: 'Genereer insluitingen voor
Deep learning neural networks met behulp van implementatie ada-002 met base64-coderingsindeling voor resource ml-services in resourcegroep my-resource-group'.
-
Onderzoekstekst: "Maak vectorinsluitingen voor
Quantum computing demonstrates computational advantages in specific algorithms met behulp van mijn implementatie van tekstinsluitingen in resourcegroep my-resource-group."
-
Productbeschrijving: "Genereer insluitingen voor
High-performance laptop with advanced graphics processing unit met behulp van implementatie text-embedding-3-small op resource product-ai in resourcegroep my-resource-group."
-
Technische documentatie: "Maak embeddings voor
API authentication requires valid credentials and proper authorization headers met implementatie ada-002 met floating-point-codering op resource docs-embedding in resourcegroep my-resource-group."
| Parameter |
Verplicht of optioneel |
Description |
|
Naam van bron |
Required |
De naam van de Microsoft Foundry-resource. |
|
Deployment |
Required |
De naam van de Foundry-modelimplementatie. |
|
Invoertekst |
Required |
De invoertekst voor het genereren van insluitingen voor. |
|
Resourcegroep |
Required |
De naam van de Azure-resourcegroep. |
|
User |
Optional |
Gebruikers-id voor tracering en misbruikcontrole. |
|
Encoderingsformaat |
Optional |
De indeling voor het retourneren van embeddings in (float of base64). |
|
Dimensies |
Optional |
Het aantal dimensies voor de embedding-uitvoer. Alleen ondersteund in sommige modellen. |
Hints voor toolannotaties:
| Destructief |
Idempotent (onveranderlijk bij herhaald gebruik) |
Open wereld |
Alleen lezen |
Secret |
Lokaal vereist |
| ❌ |
❌ |
❌ |
✅ |
❌ |
❌ |
OpenAI: Voltooiingen maken
Maak tekstvoltooiingen met behulp van Azure OpenAI in Foundry. Stuur een prompt of vraag naar Azure OpenAI-modellen die zijn geïmplementeerd in uw Foundry-resource en ontvang gegenereerde tekstantwoorden. Gebruik deze functie wanneer u voltooiingen moet maken, AI-gegenereerde inhoud wilt ophalen, antwoorden op vragen wilt genereren of tekstvoltooiingen wilt genereren van Azure OpenAI op basis van een invoerprompt. Ondersteunt aanpassingen met temperatuur- en maximumtokens.
Voorbeeld van CLI-opdracht
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 |
Ja |
De naam van de implementatie. |
prompt-text |
string |
Ja |
De prompttekst die naar het voltooiingsmodel moet worden verzonden. |
resource-name |
string |
Ja |
De naam van de Microsoft Foundry-resource. |
resource-group |
string |
Ja |
De naam van de Azure-resourcegroep. |
max-tokens |
string |
Nee |
Het maximum aantal tokens dat moet worden gegenereerd tijdens de voltooiing. |
temperature |
string |
Nee |
Reguleert willekeurigheid in de uitvoer. Lagere waarden maken het deterministischer. |
Voorbeelden van prompts zijn:
-
Basisvoltooiing: 'Maak een voltooiing met de prompt
What is Azure? met behulp van mijn gpt-35-turbo implementatie in resourcegroep my-resource-group'
-
Met temperatuurinstelling: "Genereer tekstaanvulling voor
Explain machine learning met implementatie text-davinci-003 met temperatuur 0,3 in resourcegroep my-resource-group"
-
Beperkte tokens: 'Maak een voltooiing met prompt
Write a summary met behulp van mijn gpt-4 implementatie met maximaal 100 tokens in de resourcegroep my-resource-group'
-
Creatief schrijven: "Genereer een aanvulling voor
Tell me a story about AI met implementatie gpt-35-turbo met een temperatuur van 0,8 en maximaal 200 tokens in resourcegroep my-resource-group"
-
Technische uitleg: "Voltooiing maken met prompt
How does cloud computing work? met behulp van mijn OpenAI-resource ai-services-east en implementatie gpt-4 in resourcegroep my-resource-group"
| Parameter |
Verplicht of optioneel |
Description |
|
Deployment |
Required |
De naam van de implementatie. |
|
Prompttekst |
Required |
De prompttekst die naar het voltooiingsmodel moet worden verzonden. |
|
Naam van bron |
Required |
De naam van de Microsoft Foundry-resource. |
|
Resourcegroep |
Required |
De naam van de Azure-resourcegroep. |
|
Maximum aantal tokens |
Optional |
Het maximum aantal tokens dat moet worden gegenereerd tijdens de voltooiing. |
|
Temperatuur |
Optional |
Reguleert willekeurigheid in de uitvoer. Lagere waarden maken het deterministischer. |
Hints voor toolannotaties:
| Destructief |
Idempotent (onveranderlijk bij herhaald gebruik) |
Open wereld |
Alleen lezen |
Secret |
Lokaal vereist |
| ❌ |
❌ |
❌ |
✅ |
❌ |
❌ |
OpenAI: modellen en implementaties vermelden
Vermeld Azure OpenAI-modelimplementaties in een Microsoft Foundry-resource. Met dit hulpprogramma wordt informatie opgehaald over geïmplementeerde modellen, waaronder modelnamen, versies, mogelijkheden en implementatiestatus.
Voorbeeld van CLI-opdracht
azmcp foundryextensions openai models-list \
--resource-name <resource-name> \
--resource-group <resource-group>
| Parameter |
Type |
Required |
Description |
resource-name |
string |
Ja |
De naam van de Microsoft Foundry-resource. |
resource-group |
string |
Ja |
De naam van de Azure-resourcegroep. |
Voorbeelden van prompts zijn:
-
Alle modellen weergeven: "Geef alle geïmplementeerde OpenAI-modellen weer in mijn
ai-services-prod-resource in de resourcegroep my-resource-group."
-
Implementaties controleren: "Toon me alle geïmplementeerde modellen en hun status in resource
openai-east in resourcegroep my-resource-group."
-
Productie-inventaris: "Welke modellen worden geïmplementeerd in mijn
production-openai resource in resourcegroep my-resource-group?"
-
Ontwikkelingscontrole: 'Alle modelimplementaties in mijn
dev-ai-services resource weergeven in resourcegroep my-resource-group'.
-
Modelmogelijkheden: 'Toon alle geïmplementeerde OpenAI-modellen met hun mogelijkheden in resource
ai-central in resourcegroep my-resource-group'.
-
Implementatiestatus: "Wat is de huidige status van alle implementaties in mijn
openai-west hulpbron in resourcengroep my-resource-group?"
-
Regionale modellen: 'Alle modellen weergeven die zijn geïmplementeerd in mijn
europe-openai resource in resourcegroep my-resource-group'.
-
Serviceoverzicht: "Geef me een volledig overzicht van modelimplementaties in resourcegroep
customer-aimy-resource-group."
-
Modelversies: "Toon alle geïmplementeerde modelversies in mijn
ai-services-main resource in de resourcegroep my-resource-group."
-
Resource-audit: "Ik moet alle OpenAI-modelimplementaties controleren in resource
enterprise-ai in resourcegroep my-resource-group."
| Parameter |
Verplicht of optioneel |
Description |
|
Naam van bron |
Required |
De naam van de Microsoft Foundry-resource. |
|
Resourcegroep |
Required |
De naam van de Azure-resourcegroep. |
Hints voor toolannotaties:
| Destructief |
Idempotent (onveranderlijk bij herhaald gebruik) |
Open wereld |
Alleen lezen |
Secret |
Lokaal vereist |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
Resources: Haal de Foundry-resource op
Vermeld of haal Microsoft Foundry-resources op en retourneer details op resourceniveau, zoals eindpunt-URL, locatie, SKU, soort en inrichtingsstatus. Als u een resourcenaam opgeeft, retourneert het hulpprogramma die ene resource. Anders retourneert het de inventaris van resources binnen het toepassingsbereik. Voor de inventaris van modelimplementatie in een Foundry-resource gebruikt u het hulpprogramma voor de lijst met OpenAI-modellen.
Voorbeeld van CLI-opdracht
azmcp foundryextensions resource get \
[--resource-name <resource-name>]
| Parameter |
Type |
Required |
Description |
resource-name |
string |
Nee |
De naam van de Microsoft Foundry-resource. |
Voorbeelden van prompts zijn:
-
Specifieke resource ophalen: "Toon me de details van de
ai-foundry-prod Foundry-resource"
-
Geef alle resources weer: 'Welke Foundry-resources heb ik in mijn abonnement?'
-
Resource met configuratie: "Haal de eindpunt-URL, locatie en SKU-gegevens voor mijn
customer-ai-foundry foundry-resource op"
| Parameter |
Verplicht of optioneel |
Description |
|
Naam van bron |
Optional |
De naam van de Microsoft Foundry-resource. |
Hints voor toolannotaties:
| Destructief |
Idempotent (onveranderlijk bij herhaald gebruik) |
Open wereld |
Alleen lezen |
Secret |
Lokaal vereist |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
Verwante inhoud