Beschikbare hulpprogramma's en voorbeeldprompts voor Foundry MCP Server (preview)

Deze referentiedocumentatie bevat 79 Foundry MCP Server-hulpprogramma's in 17 categorieën waarmee u agents, sessies, werksets, gegevenssets, evaluaties, modelimplementaties, continue evaluatie en meer kunt beheren, allemaal via gespreksprompts in plaats van API-aanroepen. Gebruik dit om elk hulpprogramma te verkennen en de voorbeeldprompts in uw eigen project uit te proberen.

Tip

Voltooi de installatie van Foundry MCP Server voordat u deze hulpprogramma's gebruikt.

Note

Deze functie is momenteel beschikbaar als openbare preview. Deze preview wordt aangeboden zonder een service level agreement en we raden deze niet aan voor productieworkloads. Bepaalde functies worden mogelijk niet ondersteund of hebben mogelijk beperkte mogelijkheden. Zie Aanvullende gebruiksvoorwaarden voor Microsoft Azure previews voor meer informatie.

Hoe hulpprogramma's werken

Wanneer u een prompt in natuurlijke taal typt in een MCP-compatibele client (bijvoorbeeld GitHub Copilot agentmodus), selecteert het taalmodel het juiste hulpprogramma en formuleert u de vereiste parameters namens u. U roept hulpprogramma's niet rechtstreeks aan. U beschrijft wat u wilt en het model vertaalt uw intentie in een tool-aanroep.

Elk hulpprogramma wordt geclassificeerd als gelezen (haalt informatie op) of schrijft (maakt, bijwerken of verwijdert resources). Schrijfbewerkingen zijn onmiddellijk van invloed op liveresources en facturering. Bekijk de aanbevolen beveiligingsprocedures voordat u schrijfbewerkingen uitvoert.

Permissions

Alle bewerkingen worden uitgevoerd met de machtigingen van de geverifieerde gebruiker via de stroom Microsoft Entra ID Aan-Behalf-Of. U hebt de volgende rollen nodig:

Bewerkingstype Minimale Azure rol Aantekeningen
Hulpmiddelen voor lezen Lezer van het Foundry-project of -account Voldoende voor het weergeven, uitvoeren van query's en bewaking.
Hulpprogramma's voor schrijven Inzender voor het Foundry-project of -account Vereist voor het maken, bijwerken en verwijderen van resources.
Beheerder voor voorwaardelijke toegang Beheerder voor voorwaardelijke toegang in Entra ID Alleen nodig als u toegangsbeleid op tenantniveau configureert.

Zie Toegangsbeheer op basis vanRole voor Microsoft Foundry voor meer informatie.

Sleutelidentificaties

Voor veel hulpprogramma's zijn resource-id's vereist. Het taalmodel extraheert deze uit uw promptcontext, maar het helpt om de indelingen te kennen:

Identificatie Format Waar vind ik het?
Resource-id voor foundry /subscriptions/{sub_id}/resourceGroups/{rg}/providers/Microsoft.CognitiveServices/accounts/{account} Azure portalpagina Properties
Projecteindpunt https://{account}.services.ai.azure.com/api/projects/{project} Pagina met details van foundry-project
Project resource-id /subscriptions/{sub_id}/resourceGroups/{rg}/providers/Microsoft.CognitiveServices/accounts/{account}/projects/{project} Azure portalpagina Properties

Agentbeheer

Beheer de volledige levenscyclus van agents in een Foundry-project, waaronder het maken, aanroepen, containerindeling en verwijderen.

Voorbeeldprompts:

  • "Vermeld alle agents in mijn Foundry-project."
  • 'Maak een nieuwe agent met de naam faq-agent met behulp van het model gpt-4o-mini'.
  • 'Hallo, hoe kunt u helpen?' aan mijn customer-support-agent."
  • "Start de container voor mijn gehoste agent triage-agent."
  • "Controleer de containerstatus op triage-agent."
  • "Toon het definitieschema van de agent voor promptagenten."
  • 'Verwijder het old-test-agent uit mijn project'.
Tool Toegang Description Sleutelinvoer Returns
agent_get read Geef alle agents in een Foundry-project weer of haal een specifieke agent op naam op. Agentnaam (optioneel) Agentlijst of definitie van één agent met model, instructies en configuratie van hulpprogramma's.
agent_update write Een agent maken, bijwerken of klonen. Gebruik agent_definition_schema_get dit om eerst het volledige definitieschema te detecteren. Agentnaam, model, instructies, hulpprogrammadefinities Definitie van agent gemaakt of bijgewerkt.
agent_invoke write Verzend een bericht naar een agent en ontvang een antwoord. Werkt voor zowel op prompts gebaseerde als gehoste containeragents. Agentnaam, berichttekst Antwoordbericht van agent.
agent_delete write Een agent permanent verwijderen. Voor gehoste agents wordt ook de container verwijderd. Agentnaam Bevestiging van verwijdering.
agent_container_control write Een gehoste agentcontainer starten of stoppen. Gebruik deze voordat u een gehoste agent aanroept. Agentnaam, actie (starten of stoppen) Status van containerbewerking.
agent_container_status_get read Controleer de huidige status van een gehoste agentcontainer (starten, uitvoeren, stoppen, mislukt, enzovoort). Agentnaam Huidige containerstatus.
agent_definition_schema_get read Retourneert het volledige JSON-schema voor agentdefinities, inclusief alle hulpprogrammatypen. Geen Volledig JSON-schema voor agentdefinities.

Gehoste agentsessies en -bestanden

Geïsoleerde rekensessies voor gehoste agents maken en beheren. Inspecteer logboeken en beheer bestanden in het bestandssysteem van elke sessie.

Voorbeeldprompts:

  • "Maak een sessie voor mijn gehoste agent data-analyst."
  • "Vermeld de sessies voor data-analyst en geef eerst de nieuwste weer."
  • "Stream maximaal 100 logboeklijnen van sessie analysis-2026."
  • 'Uploaden input.csv naar /data/input.csv in de sessie'.
  • 'Downloaden /data/results.csv van de sessie'.
  • 'Sessie verwijderen analysis-2026 en de rekenresources vrijgeven'.
Tool Toegang Description Sleutelinvoer Returns
session_create write Maak een nieuwe sessie voor een gehoste agent. Sessies bieden geïsoleerde rekenomgevingen voor agentuitvoering. Agentnaam, sessie-id (optioneel) Er is een sessie gemaakt met de id, status en vervaldatum.
session_get read Details ophalen voor een specifieke gehoste agentsessie. Agentnaam, sessie-id Sessiestatus, versie, aanmaaktijd en verlooptijd.
session_list read Lijst met sessies voor een gehoste agent met paginering en sortering. Agentnaam, limiet, volgorde en after of before pagineringscursor Sessielijst.
session_delete write Verwijder een gehoste agentsessie en laat de rekenresources los. Agentnaam, sessie-id Resultaat van bewerking.
session_logstream read Stream console-uitvoer van een gehoste agentsessie. Het antwoord wordt beperkt om niet-gebonden leesbewerkingen te voorkomen. Agentnaam, sessie-id, maximumregels (optioneel) Gestructureerde standaarduitvoer- en foutenlogboeken.
session_file_list read Bestanden en mappen weergeven op een pad in een gehoste agentsessie. Agentnaam, sessie-id, pad (optioneel) Bestands- en maplijst.
session_file_stat read Metagegevens ophalen voor een bestand of map in een gehoste agentsessie. Agentnaam, sessie-id, bestandspad Naam, grootte, mapindicator en laatste wijzigingstijd.
session_file_mkdir write Maak een map in een gehoste agentsessie. Agentnaam, sessie-id, pad, vlag voor create-parents (optioneel), machtigingsmodus (optioneel) Resultaat van bewerking.
session_file_upload write Upload met base64 gecodeerde inhoud naar een bestand in een gehoste agentsessie. Agentnaam, sessie-id, doelbestandspad, base64-inhoud Resultaat van bewerking.
session_file_download read Download een bestand van een gehoste agentsessie. Agentnaam, sessie-id, bestandspad Met Base64 gecodeerde bestandsinhoud.
session_file_delete write Een bestand of map verwijderen uit een gehoste agentsessie. Agentnaam, sessie-id, bestandspad, recursieve vlag (optioneel) Resultaat van bewerking.

Werksetbeheer

Werksets maken, ophalen, versie, bijwerken en verwijderen in een Foundry-project.

Voorbeeldprompts:

  • "Toon me de customer-support-tools werkset."
  • 'Download versie 2 van customer-support-tools'.
  • 'Maak een nieuwe versie van customer-support-tools'.
  • 'Versie 2 van customer-support-tools instellen als de standaardwaarde'.
  • 'Stel versie 1 van customer-support-tools als de standaardwaarde in en verwijder vervolgens versie 2.'
  • "Verwijder de old-support-tools werkset."

Toolboxversies zijn niet wijzigbaar. toolbox_version_create maakt ook de werkset als deze niet bestaat. Voor een bestaande werkset verandert het maken van een versie niet de standaardversie. Aanroepen toolbox_update met defaultVersion ingesteld op de nieuwe versie om deze te promoveren. Voordat u de huidige standaardversie verwijdert, stelt u een andere versie in als de standaardversie.

Tool Toegang Description Sleutelinvoer Returns
toolbox_get read Haal een werkset en de huidige standaardversie op. Werkset-id Werksetdetails.
toolbox_version_get read Werksetversies weergeven of een specifieke versie ophalen. Werkset-id, versie-id voor een specifieke versie Lijst of details van de werksetversie.
toolbox_version_create write Maak een onveranderbare werksetversie. Als de werkset niet bestaat, wordt dit hulpprogramma ook gemaakt. Werkset-id en versiegegevens De werksetversie is gemaakt.
toolbox_update write Een werkset maken of bijwerken, inclusief de standaardversie. Werkset-id, bijgewerkte werksetdetails, defaultVersion bij het wijzigen van de standaardinstelling Details van de werkset gemaakt of bijgewerkt.
toolbox_delete write Een werkset verwijderen. Werkset-id Bevestiging van verwijdering.
toolbox_version_delete write Verwijder een specifieke werksetversie. Als u de huidige standaardwaarde wilt verwijderen, stelt u eerst een andere versie in als de standaardwaarde. Werkset-id, versie-id Bevestiging van verwijdering.

Gegevenssetbeheer

Evaluatiegegevenssets maken, ophalen, versien en downloaden in een Foundry-project.

Voorbeeldprompts:

  • "Mijn klantenondersteuning uploaden Q& Een gegevensset van deze Azure Blob Storage URL.'
  • "Toon alle gegevenssets in mijn Foundry-project."
  • "Details ophalen voor de customer-support-qa gegevensset versie 2."
  • 'Alle versies van mijn product-reviews gegevensset weergeven'.
  • "Download-URL ophalen voor de nieuwste versie van customer-support-qa."
Tool Toegang Description Sleutelinvoer Returns
evaluation_dataset_create write Een gegevenssetversie maken of bijwerken op basis van een Azure Blob Storage-URI. Naam van gegevensset, versie Blob Storage URI Metagegevens van gegevenssets met naam, versie en URI.
evaluation_dataset_get read Haal een gegevensset op naam en versie op of vermeld alle gegevenssets in het project. Naam en versie van gegevensset (optioneel) Gegevenssetdetails of lijst met alle gegevenssets.
evaluation_dataset_versions_get read Alle versies van een specifieke gegevensset weergeven. Naam van de gegevensset Lijst met versienummers met metagegevens.
evaluation_dataset_sas_url_get read Haal een SAS-URL (Shared Access Signature) op voor het downloaden van de inhoud van een gegevenssetversie. De versie is standaard ingesteld op de meest recente versie. Naam van gegevensset, versie van gegevensset (optioneel) Inhouds-URL voor gegevenssets met korte levensduur.

Taken voor het genereren van gegevens

Zelfstandige taken voor het genereren van gegevens maken en beheren voor evaluatie of afstemming van gegevens. Genereer gegevens op basis van prompts, agents, traceringen, gegevenssets of geüploade bestanden.

Voorbeeldprompts:

  • "Genereer 100 vraag-en-antwoordvoorbeelden van deze prompt."
  • "Toon de status van de taak job-123voor het genereren van gegevens."
  • 'Taak voor het genereren van job-123gegevens annuleren'.
  • "De voltooide taak job-123voor het genereren van gegevens verwijderen."
Tool Toegang Description Sleutelinvoer Returns
data_generation_job_create write Start een zelfstandige taak voor het genereren van gegevens voor evaluatie of afstemming van gegevens. Taaknaam, generatietype, scenario, maximumvoorbeelden, implementatie van het generatiemodel en broninvoer Resultaat van bewerking.
data_generation_job_get read Eén taak voor het genereren van gegevens ophalen op id of taken voor het genereren van gegevens weergeven wanneer de id wordt weggelaten. Taak-id (optioneel) Taakgegevens of takenlijst.
data_generation_job_cancel write Annuleer een taak voor het genereren van gegevens. Job-ID Resultaat van bewerking.
data_generation_job_delete write Een taak voor het genereren van gegevens verwijderen. Job-ID Resultaat van bewerking.

Evaluatiebewerkingen

Voer batchevaluaties uit op agents of gegevenssets en vergelijk resultaten over uitvoeringen.

Voorbeeldprompts:

  • "Evalueer mijn customer-support-agent v2 met behulp van relevantie, groundedness en coherentie evaluators."
  • "Voer een batch-evaluatie uit op mijn JSONL-gegevensset met Geweld en HateUnfairness-evaluators."
  • "Genereer 50 synthetische testquery's en evalueer mijn agent ermee."
  • "Toon alle evaluatieuitvoeringen in mijn Foundry-project."
  • "Vergelijk run-baseline-123 tegen behandelingsuitvoeringen run-124 en run-125."
Tool Toegang Description Sleutelinvoer Returns
evaluation_agent_batch_eval_create write Maak een batch-evaluatieuitvoering die een specifieke agent aanroept. Ondersteunt ingebouwde en aangepaste evaluators, plus synthetische gegevensgeneratie. Agentnaam/versie, evaluatornamen, gegevensset (optioneel voor synthetische generatie), aantal synthetische query's (optioneel) Evaluatieuitvoerings-id en -status.
evaluation_dataset_batch_eval_create write Maak een batch-evaluatieuitvoering op basis van een JSONL-gegevensset. Ondersteunt ingebouwde en aangepaste evaluators. Naam/versie van gegevensset, evaluatornamen Evaluatieuitvoerings-id en -status.
evaluation_get read Lijst met evaluatiegroepen of uitvoeringen in het Foundry-project. Ingesteld isRequestForRuns op Waar op lijstuitvoeringen binnen een specifieke evaluatiegroep. Evaluatiegroep-id (optioneel), evaluatieuitvoerings-id (optioneel), isRequestForRuns vlag Lijst met evaluatiegroepen of uitvoeringen met status en scores of details voor een specifiek item.
evaluation_comparison_create write Maak vergelijkingsresultaten tussen een basislijn en een evaluatie van de behandeling. Id van basislijnuitvoering, behandelingsuitvoering-id's Vergelijkings-inzicht-id.
evaluation_comparison_get read Vergelijkingsinzichten voor evaluatie ophalen of vermelden. Vergelijkings-inzicht-id (optioneel) Vergelijkingsresultaten met statistische analyse.

Traceringsevaluatie

Voer gespreksevaluaties met meerdere paden uit over agenttraceringen of expliciet geselecteerde gesprekken en W3C-tracerings-id's.

Voorbeeldprompts:

  • "Evalueer maximaal vijf traceringen van customer-support-agent de afgelopen 24 uur voor geaardheid en voltooiing van taken."
  • "Evalueer deze gespreks-id's voor klanttevredenheid op gespreksniveau."
  • "Evalueer deze W3C-tracerings-id's met mijn aangepaste tone-check evaluator."
Tool Toegang Description Sleutelinvoer Returns
evaluation_agent_traces_batch_eval_create write Maak een batch-evaluatie met meerdere schakels over recente traceringen die zijn gesampleerd vanuit een agent. Hiermee maakt u een evaluatiegroep wanneer er geen evaluatiegroep is opgegeven. Evaluatornamen, agentnaam en versie- of agent-id, evaluatie-id (optioneel), tijdsbereik of lookback, maximale traceringen Evaluatieuitvoering.
evaluation_traces_batch_eval_create write Maak een batch-evaluatie met meerdere paden over traceringsgegevens die zijn geselecteerd door gespreks-id's of W3C-tracerings-id's. Hiermee maakt u een evaluatiegroep wanneer er geen evaluatiegroep is opgegeven. Evaluatornamen, brontype traceren, gespreks-id's of tracerings-id's, evaluatie-id (optioneel), evaluatieniveau (optioneel) Evaluatieuitvoering.

Evaluatiesuites

Evaluatiesuites maken, versien, uitvoeren, bijwerken en verwijderen die gegevenssets, doelagenten en evaluators groeperen. U kunt ook suites genereren op basis van prompts, agents, traceringen, gegevenssets of geüploade bestanden.

Voorbeeldprompts:

  • "Maak een evaluatiepakket met de naam support-quality voor mijn ondersteuningsgegevensset en -agent."
  • "Voer versie 2 van support-quality" uit.
  • "Werk de weergavenaam en tags voor versie 2 van support-qualitybij."
  • "Genereer een evaluatiepakket op basis van recente traceringen voor customer-support-agent."
  • "Toon alle generatietaken van de evaluatiesuite."
Tool Toegang Description Sleutelinvoer Returns
evaluation_suite_create write Maak een evaluatiesuiteversie die evaluators groeperen en kan verwijzen naar een gegevensset en doelagent. Suitenaam, evaluatornamen, gegevensset en doelagent (optioneel), evaluatie-instellingen (optioneel) Evaluatiesuiteversie.
evaluation_suite_get read Haal een evaluatiesuiteversie, lijstversies voor een suite of lijstsuites op. Suitenaam (optioneel), versie (optioneel), listVersions vlag en agentfilter (optioneel) Suitedetails, versielijst of suitelijst.
evaluation_suite_update write Werk de weergavenaam, beschrijving of tags bij voor een evaluatiesuiteversie. Suitenaam, versie, velden die moeten worden bijgewerkt Resultaat van bewerking.
evaluation_suite_run write Start een evaluatiesuiteuitvoering. Suitenaam, versie (optioneel), evaluatienaam (optioneel), evaluatieniveau (optioneel) Evaluatieuitvoering.
evaluation_suite_delete write Verwijder een evaluatiesuiteversie. De versie is standaard ingesteld op de meest recente versie. Suitenaam, versie (optioneel) Resultaat van bewerking.
evaluation_suite_generation_job_create write Start een generatietaak voor evaluatiesuites. Suitenaam, generatiemodelimplementatie, broninvoer, generatie-instellingen Generatietaak.
evaluation_suite_generation_job_get read Haal één generatietaak op basis van id of lijsttaken op wanneer de id wordt weggelaten. Taak-id (optioneel), limiet en vervolgtoken (optioneel) Taakdetails of takenlijst genereren.
evaluation_suite_generation_job_cancel write An evaluation suite generation job annuleren. Job-ID Resultaat van bewerking.
evaluation_suite_generation_job_delete write Een generatietaak voor evaluatiesuites verwijderen. Job-ID Resultaat van bewerking.

Evaluatorcatalogus

Blader door ingebouwde evaluators en beheer aangepaste evaluators voor gebruik in evaluatieuitvoeringen.

Voorbeeldprompts:

  • "Vermeld alle ingebouwde evaluators die beschikbaar zijn in mijn project."
  • "Toon me de volledige definitie van de coherence evaluator."
  • "Maak een aangepaste op prompt gebaseerde evaluator die reacties op een schaal van 1-5 heeft gebeld tone-check ."
  • "Werk de beschrijving van mijn tone-check evaluator bij."
  • "Verwijder versie 1 van mijn old-evaluator."
Tool Toegang Description Sleutelinvoer Returns
evaluator_catalog_get read Lijst met evaluators in de catalogus of haal de volledige definitie van een specifieke evaluator op. Filteren op ingebouwd of aangepast type. Naam van evaluator (optioneel), typefilter (ingebouwd of aangepast, optioneel) Lijst met evaluatoren of volledige evaluatordefinitie met scorelogica.
evaluator_catalog_create write Maak een aangepaste op prompts gebaseerde of op code gebaseerde evaluator. Naam van evaluator, type (prompt of code), definitie Metagegevens van evaluator gemaakt.
evaluator_catalog_update write Metagegevens bijwerken (weergavenaam, beschrijving, categorie) voor een bestaande aangepaste evaluator. Naam van evaluator, velden die moeten worden bijgewerkt Bijgewerkte metagegevens van evaluator.
evaluator_catalog_delete write Een specifieke versie van een aangepaste evaluator verwijderen. Naam van evaluator, versie Bevestiging van verwijdering.

Taken voor het genereren van evaluator

Genereer adaptief evaluators op basis van prompts, agents of gegevenssets en bewaak of annuleer de generatietaken.

Voorbeeldprompts:

  • 'Genereer een evaluator met de naam policy-compliance van deze beleidsprompt'.
  • 'Genereer opnieuw policy-compliance vanaf versie 2 van mijn ondersteuningsgegevensset met behulp van modelimplementatie gpt-4o'.
  • "Toon alle actieve evaluatorgeneratietaken."
  • "Taak voor het genereren van job-456evaluator annuleren."
Tool Toegang Description Sleutelinvoer Returns
evaluator_generation_job_create write Start een adaptieve evaluator-generatietaak. Als u een bestaande evaluatornaam opgeeft, wordt deze opnieuw gegenereerd op basis van bijgewerkte broninvoer. Modelimplementatie, evaluatornaam, prompt, agent of gegevenssetbroninvoer Generatietaak.
evaluator_generation_job_get read Haal één evaluator-generatietaak op op id of vermeld taken wanneer de id wordt weggelaten. Taak-id (optioneel), status- en agentfilters (optioneel), pagineringsinvoer (optioneel) Taakdetails of takenlijst genereren.
evaluator_generation_job_cancel write Annuleer een taak voor het genereren van een evaluator. Job-ID Resultaat van bewerking.

Modelcatalogus en details

Verken modellen in de foundry-modelcatalogus, haal modeldetails op en bepaal of een model kan worden geïmplementeerd in Managed Compute.

Voorbeeldprompts:

  • "Toon alle GPT-5.4 modellen die beschikbaar zijn in de catalogus."
  • "Vermeld alle Microsoft gepubliceerde modellen met MIT-licentie."
  • "Krijg gedetailleerde informatie en codevoorbeelden voor GPT-5-mini."
  • "Toon modellen die zijn geadverteerd voor Managed Compute."
  • "Details en implementatiesjablonen voor beheerde berekeningen ophalen voor openai--gpt-oss-20b."

Voor Managed Compute isManagedCompute identificeert u model_catalog_list een geadverteerd kandidaat. Bevestig de implementatiebaarheid met model_details_get: isFoundryManagedCompute is het gezaghebbende signaal en de opgeloste implementatiesjablonen identificeren de beschikbare implementatieopties en -accelerators.

Tool Toegang Description Sleutelinvoer Returns
model_catalog_list read Geef modellen uit de Foundry-modelcatalogus weer met optionele filters. Voor managed compute-kandidaten bevat isManagedComputehet antwoord . Trefwoorden zoeken, uitgever, licentietype, taaktype (alle optioneel) Lijst met modellen met naam, uitgever, licentie, mogelijkheden en catalogusimplementatie-indicatoren.
model_details_get read Volledige modeldetails en codevoorbeelden ophalen. Gebruik voor Managed Compute isFoundryManagedCompute om de implementeerbaarheid te bevestigen. Modelnaam of id Modelspecificaties, prijzen, ondersteunde regio's, codevoorbeelden en opgeloste implementatiesjablonen.

Modelimplementatiebeheer

Implementeer, inspecteer en verwijder modelimplementaties, inclusief beheerde compute-implementaties, in een Foundry-account.

Voorbeeldprompts:

  • "Gebruik model_deploy_azure_direct_model dit om GPT-5-mini te implementeren als production-chatbot met 20 capaciteitseenheden."
  • "Toon me al mijn huidige modelimplementaties."
  • 'Toon al mijn beheerde compute-implementaties'.
  • 'Gebruik model_deploy_managed_compute dit om te implementeren openai--gpt-oss-20b als gpt-oss-managed met behulp van de A100_80GB-implementatiesjabloon'.
  • "Verwijder de old-test-deployment gegevens die ik niet meer gebruik."

Kies expliciete hulpprogramma's voor elk implementatietype:

Implementatietype Maken of bijwerken
Foundry Models verkocht door Azure model_deploy_azure_direct_model
Beheerde rekenkracht model_deploy_managed_compute

Gebruik de afgeschafte model_deploy alias niet voor nieuwe aanroepen. Voor Managed Compute gebruikt model_catalog_list u eerst als kandidaat-signaal en roept u vervolgens aan model_details_get. Gebruik model_deploy_managed_compute alleen wanneer isFoundryManagedCompute dit is trueen geef een van de opgeloste implementatiesjablonen door. Gebruik model_deployment_get dit type om een van beide implementatietypen op te halen en model_deployment_delete om een van beide typen te verwijderen.

Tool Toegang Description Sleutelinvoer Returns
model_deploy_azure_direct_model write Een implementatie maken of bijwerken voor een Foundry-model dat wordt verkocht door Azure. Modelnaam, implementatienaam, capaciteitseenheden Implementatiedetails met eindpunt en ingerichte capaciteit.
model_deploy write Afgeschafte achterwaarts compatibele alias van model_deploy_azure_direct_model. Het heeft identieke invoer en gedrag. Modelnaam, implementatienaam, capaciteitseenheden Implementatiedetails met eindpunt en ingerichte capaciteit.
model_deploy_managed_compute write Maak een afzonderlijke Managed Compute-implementatie op basis van een registermodelasset en een oplossingsdistributiesjabloon. Implementatienaam, modelAssetId, ( acceleratorTypedeploymentTemplateoptioneel), instanceCount (optioneel), versionUpgradeOption (optioneel) Details van beheerde compute-implementatie.
model_deployment_get read Download implementaties van Foundry-modellen die worden verkocht door Azure- en Managed Compute-implementaties. Met een naam doorzoekt het hulpprogramma beide resourcetypen en kan beide worden geretourneerd wanneer ze die naam delen. Zonder een naam worden beide lijsten gecombineerd. Implementatienaam (optioneel) Implementatiedetails met Kind ingesteld op ADM of Managed.
model_deployment_delete write Verwijder een van beide implementatietypen. Het hulpprogramma controleert de implementaties van Foundry Models die door Azure eerst worden verkocht en vervolgens beheerde compute-implementaties. Naam van implementatie Bevestiging van verwijdering.

Modelanalyse en aanbevelingen

Vergelijk modelbenchmarks en krijg aanbevelingen om over te schakelen naar rendabelere of hoogwaardigere modellen.

Voorbeeldprompts:

  • "Toon me benchmarkgegevens voor alle beschikbare modellen."
  • "Vergelijk de benchmarkprestaties tussen GPT-5.4 en GPT-4."
  • "Vind modellen die vergelijkbaar zijn met mijn huidige GPT-4-implementatie."
  • "Welke modellen geven mij een betere kwaliteit/kostenverhouding dan wat ik nu gebruik?"
Tool Toegang Description Sleutelinvoer Returns
model_benchmark_get read Benchmarkgegevens ophalen voor Foundry-modellen. Modelfilters (optioneel) Benchmarkscores, nauwkeurigheid, kosten en latentiegegevens.
model_benchmark_subset_get read Haal benchmarkgegevens op voor specifieke modelnaam- en versieparen. Modelnaam en versieparen Benchmarkvergelijkingsgegevens voor opgegeven modellen.
model_similar_models_get read Vergelijkbare modellen zoeken op basis van implementatie- of modeldetails. Implementatienaam of modelnaam Lijst met vergelijkbare modellen met mogelijkheidsvergelijking.
model_switch_recommendations_get read Aanbevelingen voor modelswitchs ophalen op basis van benchmarkgegevens. Naam van huidige implementatie Aanbevolen modellen met een kwaliteits-/kostenanalyse.

Modelbewaking en -bewerkingen

Houd de implementatiestatus bij, bewaak metrische gegevens, controleer de afschaffingsstatus en bekijk het quotum voor quota, inclusief het quotum van de Managed Compute Accelerator.

Voorbeeldprompts:

  • "Toon de metrische aanvraaggegevens voor mijn production-chatbot implementatie."
  • 'Controleer of een van mijn implementaties afgeschafte modelversies gebruikt.'
  • "Quotagebruik weergeven in alle regio's voor mijn abonnement."
  • "Toon A100_80GB, H100_80GB, MI300_192GB en H200_141GB acceleratorquotum in VS - oost 2."
Tool Toegang Description Sleutelinvoer Returns
model_monitoring_metrics_get read Bewakingsgegevens ophalen (aanvragen, latentie, fouten, quotum) voor een modelimplementatie. Implementatienaam, tijdsbereik (optioneel) Aantal aanvragen, percentielen voor latentie, foutpercentages en tokengebruik.
model_deprecation_info_get read Ontvang implementatiegegevens verrijkt met afschaffings- en buitengebruikstellingsschema's. Implementatienaam (optioneel) Implementatiedetails met afschaffingsdatums en voorgestelde vervangingen.
model_quota_list read Vermeld het beschikbare implementatiequotum en -gebruik voor een abonnement in een regio, inclusief het quotum voor de managed compute-accelerator. Abonnement, regio Quotumlimieten, huidig gebruik en beschikbare capaciteit per modelfamilie of accelerator.

Projectverbindingen

Verbindingen met externe services (Azure OpenAI, Azure Blob Storage, zoeken en andere) beheren binnen een Foundry-project.

Voorbeeldprompts:

  • "Alle verbindingen in mijn Foundry-project weergeven."
  • "Toon me de details voor mijn azure-search verbinding."
  • "Welke verbindingstypen en verificatiemethoden worden ondersteund?"
  • "Maak een nieuwe AzureOpenAI-verbinding met de naam my-openai AAD-verificatie."
  • 'De verbinding uit mijn project verwijderen old-storage '.
Tool Toegang Description Sleutelinvoer Returns
project_connection_list read Alle verbindingen in een Foundry-project weergeven, met optioneel filteren op categorie of doel. Categoriefilter, doelfilter (beide optioneel) Lijst met verbindingen met naam, type en status.
project_connection_get read Haal een specifieke verbinding op naam op. Verbindingsnaam Verbindingsdetails, waaronder categorie, doel en verificatietype.
project_connection_list_metadata read Geef alle ondersteunde verbindingscategorieën en verificatietypen weer. Roep deze eerst aan om geldige waarden te detecteren. Geen Ondersteunde categorieën (bijvoorbeeld AzureOpenAI, AzureBlobStorage) en verificatietypen (bijvoorbeeld AAD, sleutel).
project_connection_create write Een projectverbinding maken of vervangen. Verbindingsnaam, categorie, doel, verificatietype Verbindingsgegevens gemaakt.
project_connection_update write Een bestaande projectverbinding bijwerken. Verbindingsnaam, velden die moeten worden bijgewerkt Bijgewerkte verbindingsgegevens.
project_connection_delete write Een projectverbinding op naam verwijderen. Verbindingsnaam Bevestiging van verwijdering.

Optimalisatie van prompts

Optimaliseer systeemprompts en ontwikkelaarsberichten voor betere LLM-prestaties.

Voorbeeldprompts:

  • "Optimaliseer mijn systeemprompt: 'U bent een nuttige klantenserviceagent' met behulp van gpt-5.4."
  • "Verbeter mijn agentinstructies om beknoptere antwoorden te krijgen."
  • "Verfijn mijn geoptimaliseerde prompt om ook vervolgvragen af te handelen."
Tool Toegang Description Sleutelinvoer Returns
prompt_optimize write Optimaliseer een ontwikkelaarsprompt (systeembericht) voor betere LLM-prestaties met behulp van de Azure OpenAI Prompt Optimizer. Prompttekst, doelmodel, verfijningsinstructies (optioneel) Geoptimaliseerde prompttekst met uitleg van wijzigingen.

Continue evaluatie

Continue evaluatie voor agents inschakelen, bewaken en beheren. Continue evaluatie evalueert automatisch agentreacties op doorlopende basis. Het hulpprogramma detecteert automatisch het type agent (prompt of gehost) en configureert het juiste evaluatiemechanisme: evaluatieregels voor promptagenten of geplande evaluatieuitvoeringen voor gehoste agents.

Voorbeeldprompts:

  • "Schakel continue evaluatie in voor mijn customer-support-agent gebruik van Relevantie- en Groundedness-evaluators."
  • "Stel continue evaluatie in voor mijn gehoste agent triage-agent om de 2 uur te worden uitgevoerd."
  • "Toon de continue evaluatieconfiguratie voor customer-support-agent."
  • "Schakel continue evaluatie voor mijn old-test-agentuit."
  • "Continue evaluatie bijwerken voor customer-support-agent voorbeeld 50% van antwoorden."
Tool Toegang Description Sleutelinvoer Returns
continuous_eval_create write Continue evaluatie voor een agent in- of bijwerken. Hiermee wordt automatisch de soort agent gedetecteerd en wordt het juiste evaluatiemechanisme geconfigureerd. Hiermee maakt u indien nodig de evaluatiegroep. Agentnaam, evaluatornamen, modelimplementatienaam (voor kwaliteits evaluators), ingeschakelde vlag, intervaluren (gehoste agents), samplingfrequentie (promptagenten), scenario (standaard of bedrijf) Doorlopende evaluatieconfiguratie met id-, status- en planningsgegevens.
continuous_eval_get read Continue evaluatieconfiguratie voor een agent ophalen. Retourneert alle configuraties of filtert op scenario voor promptagenten. Agentnaam, scenariofilter (optioneel) Lijst met configuraties voor continue evaluatie met de details, planning en status van de evaluator.
continuous_eval_delete write Verwijder een continue evaluatieconfiguratie voor een agent. Hiermee continuous_eval_get kunt u configuratie-id's vinden. Configuratie-id, agentnaam Bevestiging van verwijdering.

Voorbeeldwerkstromen

Modelimplementatie en optimalisatie:

  • 'Toon het gpt-5.6-sol model in de catalogus'.
  • 'Implementeren gpt-5.6-sol als customer-service-bot met 15 capaciteitseenheden'.
  • "Bewaak de latentie van de aanvraag voor mijn nieuwe implementatie."
  • "Kosteneffectievere alternatieven aanbevelen op basis van huidig gebruik."

Planning van beheerde rekenquota:

  • "Gebruik model_quota_list dit diagram om het quotum en het gebruik van mijn Managed Compute Accelerator weer te geven voor het abonnement <subscription-id> in VS - oost 2."
  • "Vergelijk de beschikbare exemplaren voor A100_80GB, H100_80GB, en MI300_192GB."H200_141GB
  • "Ik heb vier exemplaren nodig. Bepaal welke accelerators momenteel voldoende beschikbaar quotum hebben en herinner me eraan dat de beschikbaarheid van quota geen implementatiecapaciteit garandeert.
  • "Voordat een implementatie wordt uitgevoerd, geeft u de geselecteerde accelerator en het aantal exemplaren weer voor controle omdat Managed Compute factureerbare TOEGEWEZEN GPU-capaciteit toewijst."

Levenscyclus van beheerde compute-implementatie:

  • "Gebruik model_catalog_list dit om modellen te vinden die zijn geadverteerd voor Managed Compute, waar isManagedCompute is truedat."
  • "Gebruik openai--gpt-oss-20bmodel_details_get dit om te bevestigen dat isFoundryManagedCompute dit het is trueen om het bijbehorende registermodelAssetId, opgeloste implementatiesjablonen en accelerators weer te geven."
  • "Gebruik model_quota_list deze optie om de geselecteerde accelerator in VS - oost 2 te controleren vóór de implementatie."
  • "Controleer de implementatiesjabloon, accelerator en het aantal exemplaren met mij. Nadat ik de factureerbare toegewezen GPU-toewijzing heb bevestigd, gebruikt model_deploy_managed_compute u deze om te maken gpt-oss-managed-test met het registermodelAssetId, één opgelost deploymentTemplateen de goedgekeurde ."instanceCount
  • "Gebruik model_deployment_get dit om te controleren gpt-oss-managed-test en te controleren of het Kind is Managed."
  • "Wanneer het testen is voltooid en ik bevestig opschonen, gebruikt model_deployment_delete u om te verwijderen gpt-oss-managed-test."

Werkstroom voor agentevaluatie:

  • "Geef alle agents in mijn project weer."
  • "Evalueer mijn customer-support-agent v2 met behulp van relevantie, grondheid en veiligheids evaluators."
  • "Vergelijk mijn basislijnevaluatie met de nieuwe uitvoering."
  • "Toon de vergelijkingsresultaten met statistische significantie."

Installatie van continue evaluatie:

  • "Geef alle agents in mijn project weer."
  • "Schakel continue evaluatie in voor mijn customer-support-agent gebruik van Relevantie-, Groundedness- en Safety-evaluators met de bestaande gpt-5.6-luna implementatie."
  • "Toon de continue evaluatieconfiguratie voor customer-support-agent."
  • "Continue evaluatie bijwerken naar voorbeeld van 25% van antwoorden met maximaal 10 uitvoeringen per uur."

Resourcebeheer en opschonen:

  • 'Geef al mijn huidige implementaties en hun gebruik weer.'
  • 'Controleer welke implementaties gebruikmaken van afgeschafte modelversies.'
  • "Toon mijn quotumgebruik in alle regio's."
  • "Verwijder ongebruikte testimplementaties om capaciteit vrij te maken."

Preview-beperkingen

Foundry MCP Server bevindt zich in openbare preview. De volgende beperkingen zijn van toepassing:

  • Geen netwerkisolatie : Foundry MCP Server maakt gebruik van het openbare eindpunt https://mcp.ai.azure.com. Resources achter Azure Privékoppelingen zijn niet toegankelijk. Voor privé-MCP-connectiviteit bouwt u uw eigen MCP-server en verbindt u deze met agentservice met privénetwerken.
  • Gegevenslocatie : aanvragen en antwoorden kunnen worden verwerkt in datacenters van de EU of de VS. De server zelf slaat geen gegevens op, maar verwerking tussen regio's kan plaatsvinden.
  • Geen SLA : preview-functies bevatten geen service level agreement. Gebruik de server niet voor productieworkloads waarvoor gegarandeerde beschikbaarheid is vereist.
  • Hulpprogrammaset kan veranderen : hulpprogramma's, parameters en retourwaarden kunnen veranderen tijdens de preview-periode zonder kennisgeving.

Zie Aanvullende gebruiksvoorwaarden voor Microsoft Azure previews voor meer informatie.

Veelvoorkomende fouten

Fout Oorzaak Resolutie / Besluit
Toegang geweigerd Onvoldoende Azure RBAC-rol voor het Foundry-project of -account. Wijs ten minste Lezer toe voor leeshulpprogramma's of Inzender voor schrijfhulpprogramma's. Zie RBAC voor Microsoft Foundry.
Authenticatie mislukt Verlopen of ongeldig Entra ID token. Meld u af en weer aan bij uw Azure-account in Visual Studio Code of het hulpprogramma dat u gebruikt.
Quotum overschreden Onvoldoende capaciteit om een implementatie te maken of een evaluatie uit te voeren. Gebruik model_quota_list dit om het beschikbare quotum vóór de bewerking te controleren.
Resource is niet gevonden De opgegeven implementatie, gegevensset, agent of verbinding bestaat niet. Gebruik het bijbehorende get hulpprogramma of list hulpprogramma om de resourcenaam te controleren.
Privé-eindpunt niet bereikbaar Foundry-resources maken gebruik van Azure Private Links die de gehoste Foundry MCP-server niet kan bereiken. Verwijder beperkingen voor privé-eindpunten, gebruik SDK's/REST API's of gebruik een aangepaste MCP-server met privénetwerken van agentservice.

Zie Foundry MCP Server-beveiliging en aanbevolen procedures voor meer informatie over probleemoplossing.

Verwante inhoud

  • Last updated on