Strumenti disponibili e richieste di esempio per il server MCP Foundry (anteprima)

Questo riferimento documenta 79 Strumenti server MCP Foundry in 17 categorie che consentono di gestire agenti, sessioni, casella degli strumenti, set di dati, valutazioni, distribuzioni di modelli, valutazione continua e altro ancora, tramite prompt di conversazione anziché chiamate API. Usarlo per esplorare ogni strumento e provare le richieste di esempio nel proprio progetto.

Tip

Prima di usare questi strumenti, completare la configurazione del server MCP Foundry.

Note

Questa funzionalità è attualmente disponibile in anteprima pubblica. Questa anteprima viene fornita senza un contratto di servizio e non è consigliabile per i carichi di lavoro di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero avere funzionalità limitate. Per altre informazioni, vedere Condizioni per l'utilizzo Microsoft Azure anteprime.

Funzionamento degli strumenti

Quando si digita un prompt in linguaggio naturale in un client conforme a MCP (ad esempio, GitHub Copilot modalità agente), il modello linguistico seleziona lo strumento appropriato e formula i parametri necessari per conto dell'utente. Non si chiamano direttamente gli strumenti, si descrive ciò che si vuole e il modello converte la finalità in una chiamata allo strumento.

Ogni strumento viene classificato come letto (recupera informazioni) o scrittura (crea, aggiorna o elimina le risorse). Le operazioni di scrittura influiscono immediatamente sulle risorse attive e sulla fatturazione. Esaminare le procedure consigliate per la sicurezza prima di eseguire operazioni di scrittura.

Permissions

Tutte le operazioni vengono eseguite con le autorizzazioni dell'utente autenticato tramite il flusso Microsoft Entra ID on-Behalf-Of. Sono necessari i ruoli seguenti:

Tipo di operazione Ruolo minimo Azure Note
Leggere gli strumenti Lettore nel progetto o nell'account Foundry Sufficiente per elencare, eseguire query e monitorare.
Strumenti di scrittura Collaboratore per il progetto o l'account Foundry Obbligatorio per la creazione, l'aggiornamento e l'eliminazione di risorse.
Amministratore dell'accesso condizionale Amministratore di accesso condizionale in Entra ID È necessario solo se si configurano criteri di accesso a livello di tenant.

Per altre informazioni, vedere Controllo degli accessi in base al ruolo per Microsoft Foundry.

Identificatori di chiave

Molti strumenti richiedono identificatori di risorsa. Il modello linguistico estrae questi dati dal contesto del prompt, ma consente di conoscere i formati:

Identificatore Formato Dove trovarla
ID risorsa Foundry /subscriptions/{sub_id}/resourceGroups/{rg}/providers/Microsoft.CognitiveServices/accounts/{account} Azure portale Proprietà pagina
Endpoint del progetto https://{account}.services.ai.azure.com/api/projects/{project} Pagina dei dettagli del progetto Foundry
ID risorsa Project /subscriptions/{sub_id}/resourceGroups/{rg}/providers/Microsoft.CognitiveServices/accounts/{account}/projects/{project} Azure portale Proprietà pagina

Gestione degli agenti

Gestire il ciclo di vita completo degli agenti in un progetto Foundry, tra cui creazione, chiamata, orchestrazione dei contenitori ed eliminazione.

Prompt di esempio:

  • "Elencare tutti gli agenti nel mio progetto Foundry."
  • "Creare un nuovo agente denominato faq-agent usando il modello gpt-4o-mini".
  • "Send 'Hello, how can you help?' alla mia customer-support-agent".
  • "Avviare il contenitore per l'agente triage-agentospitato".
  • "Controllare lo stato del contenitore per triage-agent".
  • "Mostra lo schema di definizione dell'agente per gli agenti prompt".
  • "Elimina il dal old-test-agent mio progetto."
Tool Access Description Input delle chiavi Restituzioni
agent_get leggere Elencare tutti gli agenti in un progetto Foundry o ottenere un agente specifico in base al nome. Nome agente (facoltativo) Elenco di agenti o definizione di un singolo agente con modello, istruzioni e configurazione degli strumenti.
agent_update scrivi Creare, aggiornare o clonare un agente. Usare agent_definition_schema_get per individuare prima lo schema di definizione completo. Nome agente, modello, istruzioni, definizioni degli strumenti Definizione dell'agente creata o aggiornata.
agent_invoke scrivi Inviare un messaggio a un agente e ottenere una risposta. Funziona sia per gli agenti contenitore basati su prompt che per gli agenti contenitore ospitati. Nome agente, testo del messaggio Messaggio di risposta dell'agente.
agent_delete scrivi Eliminare definitivamente un agente. Per gli agenti ospitati, questo elimina anche il contenitore. Nome agente Conferma dell'eliminazione.
agent_container_control scrivi Avviare o arrestare un contenitore dell'agente ospitato. Usare prima di richiamare un agente ospitato. Nome agente, azione (avvio o arresto) Stato dell'operazione contenitore.
agent_container_status_get leggere Controllare lo stato corrente di un contenitore dell'agente ospitato (Avvio, Esecuzione, Arrestato, Non riuscito e così via). Nome agente Stato corrente del contenitore.
agent_definition_schema_get leggere Restituisce lo schema JSON completo per le definizioni degli agenti, inclusi tutti i tipi di strumento. Nessuno Schema JSON completo per le definizioni degli agenti.

Sessioni e file dell'agente ospitato

Creare e gestire sessioni di calcolo isolate per gli agenti ospitati. Esaminare i log e gestire i file nel file system di ogni sessione.

Prompt di esempio:

  • "Creare una sessione per l'agente data-analystospitato".
  • "Elencare le sessioni per data-analyst e mostrare prima il più recente".
  • "Trasmettere fino a 100 righe di log dalla sessione analysis-2026".
  • "Carica input.csv in /data/input.csv nella sessione".
  • "Scarica /data/results.csv dalla sessione".
  • "Eliminare la sessione analysis-2026 e rilasciare le risorse di calcolo."
Tool Access Description Input delle chiavi Restituzioni
session_create scrivi Creare una nuova sessione per un agente ospitato. Le sessioni forniscono ambienti di calcolo isolati per l'esecuzione dell'agente. Nome agente, ID sessione (facoltativo) Sessione creata con ID, stato e scadenza.
session_get leggere Ottenere i dettagli per una sessione specifica dell'agente ospitato. Nome agente, ID sessione Stato sessione, versione, ora di creazione e scadenza.
session_list leggere Elencare le sessioni per un agente ospitato con impaginazione e ordinamento. Nome dell'agente, limite, ordine e after cursore before di paginazione Elenco di sessioni.
session_delete scrivi Eliminare una sessione dell'agente ospitato e rilasciare le risorse di calcolo. Nome agente, ID sessione Risultato dell'operazione.
session_logstream leggere Output della console di flusso da una sessione dell'agente ospitato. La risposta è limitata per impedire letture non associate. Nome agente, ID sessione, righe massime (facoltativo) Output standard strutturato ed eventi del log degli errori.
session_file_list leggere Elencare file e directory in un percorso in una sessione dell'agente ospitato. Nome agente, ID sessione, percorso (facoltativo) Elenco di file e directory.
session_file_stat leggere Ottenere i metadati per un file o una directory in una sessione dell'agente ospitato. Nome agente, ID sessione, percorso file Nome, dimensioni, indicatore di directory e ora dell'ultima modifica.
session_file_mkdir scrivi Creare una directory in una sessione dell'agente ospitato. Nome agente, ID sessione, percorso, flag create-parents (facoltativo), modalità di autorizzazione (facoltativo) Risultato dell'operazione.
session_file_upload scrivi Caricare contenuto con codifica Base64 in un file in una sessione dell'agente ospitato. Nome agente, ID sessione, percorso del file di destinazione, contenuto base64 Risultato dell'operazione.
session_file_download leggere Scaricare un file da una sessione dell'agente ospitato. Nome agente, ID sessione, percorso file Contenuto di file con codifica Base64.
session_file_delete scrivi Eliminare un file o una directory da una sessione dell'agente ospitato. Nome agente, ID sessione, percorso file, flag ricorsivo (facoltativo) Risultato dell'operazione.

Gestione della casella degli strumenti

Creare, recuperare, aggiornare ed eliminare le caselle degli strumenti in un progetto Foundry.

Prompt di esempio:

  • "Mostrami la customer-support-tools casella degli strumenti".
  • "Ottenere la versione 2 di customer-support-tools".
  • "Creare una nuova versione di customer-support-tools".
  • "Impostare la versione 2 di customer-support-tools come predefinita".
  • "Impostare la versione 1 di customer-support-tools come predefinita, quindi eliminare la versione 2".
  • "Elimina la old-support-tools casella degli strumenti".

Le versioni della casella degli strumenti non sono modificabili. toolbox_version_create crea anche la casella degli strumenti se non esiste. Per una casella degli strumenti esistente, la creazione di una versione non modifica la versione predefinita. Chiamare toolbox_update con defaultVersion impostato sulla nuova versione per alzarla di livello. Prima di eliminare la versione predefinita corrente, impostare un'altra versione come predefinita.

Tool Access Description Input delle chiavi Restituzioni
toolbox_get leggere Recuperare una casella degli strumenti e la relativa versione predefinita corrente. Identificatore della casella degli strumenti Dettagli della casella degli strumenti.
toolbox_version_get leggere Elencare le versioni della casella degli strumenti o recuperare una versione specifica. Identificatore della casella degli strumenti, identificatore della versione per una versione specifica Elenco o dettagli della versione della casella degli strumenti.
toolbox_version_create scrivi Creare una versione non modificabile della casella degli strumenti. Se la casella degli strumenti non esiste, questo strumento lo crea anche. Dettagli dell'identificatore e della versione della casella degli strumenti Versione della casella degli strumenti creata.
toolbox_update scrivi Creare o aggiornare una casella degli strumenti, inclusa la versione predefinita. Identificatore della casella degli strumenti, dettagli della casella degli strumenti aggiornati, defaultVersion quando si modifica il valore predefinito Dettagli della casella degli strumenti creati o aggiornati.
toolbox_delete scrivi Eliminare una casella degli strumenti. Identificatore della casella degli strumenti Conferma dell'eliminazione.
toolbox_version_delete scrivi Eliminare una versione specifica della casella degli strumenti. Per eliminare il valore predefinito corrente, impostare prima un'altra versione come predefinita. Identificatore della casella degli strumenti, identificatore della versione Conferma dell'eliminazione.

Gestione dei set di dati

Creare, recuperare, versione e scaricare set di dati di valutazione in un progetto Foundry.

Prompt di esempio:

  • "Carica domande e risposte del supporto clienti Set di dati da questo URL di Archiviazione BLOB di Azure."
  • "Mostra tutti i set di dati nel progetto Foundry".
  • "Ottenere i dettagli per il customer-support-qa set di dati versione 2".
  • "Elencare tutte le versioni del set product-reviews di dati".
  • "Ottenere un URL di download per la versione più recente di customer-support-qa".
Tool Access Description Input delle chiavi Restituzioni
evaluation_dataset_create scrivi Creare o aggiornare una versione del set di dati da un URI Archiviazione BLOB di Azure. Nome del set di dati, versione, URI gestione rete virtuale di Azure Metadati del set di dati con nome, versione e URI.
evaluation_dataset_get leggere Ottenere un set di dati in base al nome e alla versione oppure elencare tutti i set di dati nel progetto. Nome e versione del set di dati (facoltativo) Dettagli del set di dati o elenco di tutti i set di dati.
evaluation_dataset_versions_get leggere Elencare tutte le versioni di un set di dati specifico. Nome del set di dati Elenco di numeri di versione con metadati.
evaluation_dataset_sas_url_get leggere Ottenere un URL di firma di accesso condiviso (SAS) di breve durata per scaricare il contenuto di una versione del set di dati. Per impostazione predefinita, la versione è la più recente. Nome del set di dati, versione del set di dati (facoltativo) URL del contenuto del set di dati di breve durata.

Processi di generazione dei dati

Creare e gestire processi di generazione di dati autonomi per la valutazione o l'ottimizzazione dei dati. Generare dati da prompt, agenti, tracce, set di dati o file caricati.

Prompt di esempio:

  • "Generare 100 esempi di domande e risposte di valutazione da questa richiesta".
  • "Mostra lo stato del processo job-123di generazione dei dati ".
  • "Annullare il processo job-123di generazione dei dati ".
  • "Eliminare il processo job-123di generazione dei dati completato ".
Tool Access Description Input delle chiavi Restituzioni
data_generation_job_create scrivi Avviare un processo di generazione dei dati autonomo per la valutazione o l'ottimizzazione dei dati. Nome del processo, tipo di generazione, scenario, esempi massimi, distribuzione del modello di generazione e input di origine Risultato dell'operazione.
data_generation_job_get leggere Ottenere un processo di generazione dei dati in base all'ID o elencare i processi di generazione dei dati quando l'ID viene omesso. ID processo (facoltativo) Dettagli processo o elenco di processi.
data_generation_job_cancel scrivi Annullare un processo di generazione dei dati. ID lavoro Risultato dell'operazione.
data_generation_job_delete scrivi Eliminare un processo di generazione dei dati. ID lavoro Risultato dell'operazione.

Operazioni di valutazione

Eseguire valutazioni batch su agenti o set di dati e confrontare i risultati tra le esecuzioni.

Prompt di esempio:

  • "Valutare la mia customer-support-agent v2 usando gli analizzatori di pertinenza, suolo e coerenza."
  • "Eseguire una valutazione batch nel set di dati JSONL con gli analizzatori Di violenza e HateUnfairness".
  • "Generare 50 query di test sintetici e valutare l'agente con loro."
  • "Mostra tutte le esecuzioni di valutazione nel progetto Foundry".
  • "Confrontare run-baseline-123 con le esecuzioni di trattamento run-124 e run-125."
Tool Access Description Input delle chiavi Restituzioni
evaluation_agent_batch_eval_create scrivi Creare un'esecuzione di valutazione batch che chiama un agente specifico. Supporta analizzatori predefiniti e personalizzati, oltre alla generazione di dati sintetici. Nome/versione dell'agente, nomi dell'analizzatore, set di dati (facoltativo per la generazione sintetica), numero di query sintetiche (facoltativo) ID e stato dell'esecuzione della valutazione.
evaluation_dataset_batch_eval_create scrivi Creare un'esecuzione di valutazione batch su un set di dati JSONL. Supporta analizzatori predefiniti e personalizzati. Nome/versione del set di dati, nomi dell'analizzatore ID e stato dell'esecuzione della valutazione.
evaluation_get leggere Elencare i gruppi di valutazione o le esecuzioni nel progetto Foundry. Impostare isRequestForRuns su true per elencare le esecuzioni all'interno di un gruppo di valutazione specifico. ID gruppo di valutazione (facoltativo), ID esecuzione valutazione (facoltativo), isRequestForRuns flag Elenco di gruppi di valutazione o esecuzioni con stato e punteggi o dettagli per un elemento specifico.
evaluation_comparison_create scrivi Creare risultati di confronto tra le esecuzioni di valutazione di base e di trattamento. ID esecuzione di base, ID esecuzione trattamento ID di informazioni dettagliate sul confronto.
evaluation_comparison_get leggere Ottenere o elencare informazioni dettagliate sul confronto di valutazione. ID informazioni dettagliate confronto (facoltativo) Risultati del confronto con l'analisi statistica.

Analisi delle tracce

Eseguire valutazioni di conversazione a più turni sulle tracce dell'agente o selezionare in modo esplicito conversazioni e ID traccia W3C.

Prompt di esempio:

  • "Valutare fino a cinque tracce dalle customer-support-agent ultime 24 ore per il completamento delle attività e le attività a terra".
  • "Valutare questi ID di conversazione per la soddisfazione dei clienti a livello di conversazione".
  • "Valutare questi ID di traccia W3C con l'analizzatore personalizzato tone-check ."
Tool Access Description Input delle chiavi Restituzioni
evaluation_agent_traces_batch_eval_create scrivi Creare una valutazione batch a più turni sulle tracce recenti campionate da un agente. Crea un gruppo di valutazione quando non ne viene fornito uno. Nomi dell'analizzatore, nome dell'agente e ID versione o ID agente, ID di valutazione (facoltativo), intervallo di tempo o lookback, tracce massime Esecuzione della valutazione.
evaluation_traces_batch_eval_create scrivi Creare una valutazione batch a più turni sui dati di traccia selezionati dagli ID conversazione o dagli ID traccia W3C. Crea un gruppo di valutazione quando non ne viene fornito uno. Nomi dell'analizzatore, tipo di origine di traccia, ID di conversazione o ID traccia, ID di valutazione (facoltativo), livello di valutazione (facoltativo) Esecuzione della valutazione.

Pacchetti di valutazione

Creare, versione, eseguire, aggiornare ed eliminare gruppi di valutazione che raggruppano set di dati, agenti di destinazione e analizzatori. È anche possibile generare pacchetti da prompt, agenti, tracce, set di dati o file caricati.

Prompt di esempio:

  • "Creare una suite di valutazione denominata support-quality per il set di dati di supporto e l'agente."
  • "Eseguire la versione 2 di support-quality".
  • "Aggiornare il nome visualizzato e i tag per la versione 2 di support-quality".
  • "Generare una suite di valutazione da tracce recenti per customer-support-agent."
  • "Mostra tutti i processi di generazione della suite di valutazione".
Tool Access Description Input delle chiavi Restituzioni
evaluation_suite_create scrivi Creare una versione della suite di valutazione che raggruppa gli analizzatori e può fare riferimento a un set di dati e a un agente di destinazione. Nome della suite, nomi dell'analizzatore, set di dati e agente di destinazione (facoltativo), impostazioni di valutazione (facoltativo) Versione della suite di valutazione.
evaluation_suite_get leggere Ottenere una versione della suite di valutazione, elencare le versioni per una suite o un elenco di pacchetti. Nome della suite (facoltativo), versione (facoltativo), listVersions flag e filtro agente (facoltativo) Dettagli della suite, elenco delle versioni o elenco di suite.
evaluation_suite_update scrivi Aggiornare il nome visualizzato, la descrizione o i tag in una versione del gruppo di valutazione. Nome della suite, versione, campi da aggiornare Risultato dell'operazione.
evaluation_suite_run scrivi Avviare un'esecuzione di un gruppo di valutazione. Nome della suite, versione (facoltativo), nome di valutazione (facoltativo), livello di valutazione (facoltativo) Esecuzione della valutazione.
evaluation_suite_delete scrivi Eliminare una versione della suite di valutazione. Per impostazione predefinita, la versione è la più recente. Nome suite, versione (facoltativo) Risultato dell'operazione.
evaluation_suite_generation_job_create scrivi Avviare un processo di generazione della suite di valutazione. Nome della suite, distribuzione del modello di generazione, input di origine, impostazioni di generazione Processo di generazione.
evaluation_suite_generation_job_get leggere Ottenere un processo di generazione di un gruppo di valutazione in base all'ID o elencare i processi quando l'ID viene omesso. ID processo (facoltativo), token di limite e di continuazione (facoltativo) Dettagli del processo di generazione o elenco di processi.
evaluation_suite_generation_job_cancel scrivi Annullare un processo di generazione di un gruppo di valutazione. ID lavoro Risultato dell'operazione.
evaluation_suite_generation_job_delete scrivi Eliminare un processo di generazione della suite di valutazione. ID lavoro Risultato dell'operazione.

Catalogo dell'analizzatore

Esplorare gli analizzatori predefiniti e gestire gli analizzatori personalizzati da usare nelle esecuzioni di valutazione.

Prompt di esempio:

  • "Elencare tutti gli analizzatori predefiniti disponibili nel progetto."
  • "Mostrami la definizione completa dell'analizzatore coherence ".
  • "Creare un analizzatore personalizzato basato su prompt denominato tone-check che assegna punteggi alle risposte su una scala da 1 a 5".
  • "Aggiornare la descrizione dell'analizzatore tone-check ."
  • "Eliminare la versione 1 del mio old-evaluator".
Tool Access Description Input delle chiavi Restituzioni
evaluator_catalog_get leggere Elencare gli analizzatori nel catalogo o ottenere la definizione completa di un analizzatore specifico. Filtrare in base al tipo predefinito o personalizzato. Nome analizzatore (facoltativo), filtro del tipo (predefinito o personalizzato, facoltativo) Elenco di analizzatori o definizione dell'analizzatore completo con logica di assegnazione dei punteggi.
evaluator_catalog_create scrivi Creare un analizzatore personalizzato basato su prompt o basato su codice. Nome dell'analizzatore, tipo (prompt o codice), definizione Metadati dell'analizzatore creati.
evaluator_catalog_update scrivi Aggiornare i metadati (nome visualizzato, descrizione, categoria) per un analizzatore personalizzato esistente. Nome dell'analizzatore, campi da aggiornare Metadati dell'analizzatore aggiornati.
evaluator_catalog_delete scrivi Eliminare una versione specifica di un analizzatore personalizzato. Nome dell'analizzatore, versione Conferma dell'eliminazione.

Processi di generazione dell'analizzatore

Generare analizzatori in modo adattivo da prompt, agenti o set di dati e monitorare o annullare i processi di generazione.

Prompt di esempio:

  • "Generare un analizzatore denominato policy-compliance da questo prompt dei criteri".
  • "Rigenerare policy-compliance dalla versione 2 del set di dati di supporto usando la distribuzione gpt-4odel modello ".
  • "Mostra tutti i processi di generazione dell'analizzatore in esecuzione".
  • "Annullare il processo job-456di generazione dell'analizzatore".
Tool Access Description Input delle chiavi Restituzioni
evaluator_generation_job_create scrivi Avviare un processo di generazione dell'analizzatore adattivo. Specificando un nome dell'analizzatore esistente, viene rigenerato dagli input di origine aggiornati. Distribuzione del modello, nome dell'analizzatore, prompt, agente o input dell'origine del set di dati Processo di generazione.
evaluator_generation_job_get leggere Ottenere un processo di generazione dell'analizzatore in base all'ID o elencare i processi quando l'ID viene omesso. ID processo (facoltativo), filtri di stato e agente (facoltativo), input di paginazione (facoltativo) Dettagli del processo di generazione o elenco di processi.
evaluator_generation_job_cancel scrivi Annullare un processo di generazione dell'analizzatore. ID lavoro Risultato dell'operazione.

Catalogo e dettagli del modello

Esplorare i modelli nel catalogo dei modelli Foundry, ottenere i dettagli del modello e determinare se un modello può essere distribuito in Calcolo gestito.

Prompt di esempio:

  • "Mostra tutti i modelli GPT-5.4 disponibili nel catalogo."
  • "Elencare tutti i modelli pubblicati Microsoft con licenza MIT".
  • "Ottenere informazioni dettagliate ed esempi di codice per GPT-5-mini".
  • "Mostra i modelli annunciati per managed compute".
  • "Ottenere i dettagli di calcolo gestito e i modelli di distribuzione per openai--gpt-oss-20b".

Per Managed Compute, isManagedCompute in model_catalog_list identifica un candidato annunciato. Verificare la distribuibilità con model_details_get: isFoundryManagedCompute è il segnale autorevole e i modelli di distribuzione risolti identificano le opzioni e gli acceleratori di distribuzione disponibili.

Tool Access Description Input delle chiavi Restituzioni
model_catalog_list leggere Elencare i modelli dal catalogo dei modelli Foundry con filtri facoltativi. Per i candidati di calcolo gestito, la risposta include isManagedCompute. Parole chiave di ricerca, editore, tipo di licenza, tipo di attività (tutti facoltativi) Elenco di modelli con nome, editore, licenza, funzionalità e indicatori di distribuzione del catalogo.
model_details_get leggere Ottenere i dettagli completi del modello e gli esempi di codice. Per il calcolo gestito, usare isFoundryManagedCompute per confermare la distribuibilità. Nome o ID del modello Specifiche del modello, prezzi, aree supportate, esempi di codice e modelli di distribuzione risolti.

Gestione della distribuzione dei modelli

Distribuire, esaminare e rimuovere distribuzioni di modelli, incluse le distribuzioni di calcolo gestito, in un account Foundry.

Prompt di esempio:

  • "Usare model_deploy_azure_direct_model per distribuire GPT-5-mini come production-chatbot con 20 unità di capacità".
  • "Mostra tutte le distribuzioni del modello corrente".
  • "Mostra tutte le distribuzioni di calcolo gestito".
  • "Usare model_deploy_managed_compute per eseguire la distribuzione openai--gpt-oss-20b come gpt-oss-managed usando il relativo modello di distribuzione A100_80GB".
  • "Elimina l'oggetto old-test-deployment che non uso più."

Scegliere gli strumenti espliciti per ogni tipo di distribuzione:

Tipo di distribuzione Creazione o aggiornamento
Foundry Models venduto da Azure model_deploy_azure_direct_model
Calcolo gestito model_deploy_managed_compute

Non usare l'alias deprecato model_deploy per le nuove chiamate. Per Il calcolo gestito usare model_catalog_list prima di tutto come segnale candidato, quindi chiamare model_details_get. Usare model_deploy_managed_compute solo quando isFoundryManagedCompute è truee passare uno dei modelli di distribuzione risolti. Usare model_deployment_get per recuperare uno dei tipi di distribuzione e model_deployment_delete per eliminare uno dei due tipi.

Tool Access Description Input delle chiavi Restituzioni
model_deploy_azure_direct_model scrivi Creare o aggiornare una distribuzione per un modello Foundry venduto da Azure. Nome del modello, nome della distribuzione, unità di capacità Dettagli della distribuzione con endpoint e capacità di cui è stato effettuato il provisioning.
model_deploy scrivi Alias compatibile con le versioni precedenti deprecato di model_deploy_azure_direct_model. Ha input e comportamento identici. Nome del modello, nome della distribuzione, unità di capacità Dettagli della distribuzione con endpoint e capacità di cui è stato effettuato il provisioning.
model_deploy_managed_compute scrivi Creare una distribuzione di calcolo gestita distinta da un asset del modello del Registro di sistema e un modello di distribuzione risolto. Nome distribuzione, modelAssetId, deploymentTemplate, acceleratorType (facoltativo), instanceCount (facoltativo), versionUpgradeOption (facoltativo) Dettagli della distribuzione del calcolo gestito.
model_deployment_get leggere Ottenere le distribuzioni dei modelli Foundry venduti da distribuzioni di Azure e di calcolo gestito. Con un nome, lo strumento cerca entrambi i tipi di risorse e può restituire entrambi quando condividono tale nome. Senza un nome, combina entrambi gli elenchi. Nome distribuzione (facoltativo) Dettagli della distribuzione con Kind impostato su ADM o Managed.
model_deployment_delete scrivi Eliminare uno dei due tipi di distribuzione. Lo strumento controlla le distribuzioni dei modelli Foundry venduti da Azure prima, quindi le distribuzioni di calcolo gestito. Nome della distribuzione Conferma dell'eliminazione.

Analisi dei modelli e raccomandazioni

Confrontare i benchmark dei modelli e ottenere raccomandazioni per passare a modelli più convenienti o di qualità superiore.

Prompt di esempio:

  • "Mostra i dati di benchmark per tutti i modelli disponibili".
  • "Confrontare le prestazioni del benchmark tra GPT-5.4 e GPT-4".
  • "Trovare modelli simili alla distribuzione GPT-4 corrente".
  • "Quali modelli mi darebbero un rapporto di qualità/costo migliore rispetto a quello che uso ora?"
Tool Access Description Input delle chiavi Restituzioni
model_benchmark_get leggere Recuperare i dati di benchmark per i modelli Foundry. Filtri del modello (facoltativo) Punteggi di benchmark, accuratezza, costi e metriche di latenza.
model_benchmark_subset_get leggere Ottenere dati di benchmark per coppie specifiche di nome e versione del modello. Coppie nome modello e versione Dati di confronto dei benchmark per i modelli specificati.
model_similar_models_get leggere Trovare modelli simili in base ai dettagli della distribuzione o del modello. Nome della distribuzione o nome del modello Elenco di modelli simili con confronto delle funzionalità.
model_switch_recommendations_get leggere Ottenere raccomandazioni per il cambio di modello in base ai dati di benchmark. Nome della distribuzione corrente Modelli consigliati con analisi di compromesso qualità/costo.

Monitoraggio e operazioni del modello

Tenere traccia dell'integrità della distribuzione, monitorare le metriche, controllare lo stato di deprecazione e visualizzare l'utilizzo delle quote, inclusa la quota dell'acceleratore di calcolo gestito.

Prompt di esempio:

  • "Mostra le metriche di richiesta per la distribuzione production-chatbot ".
  • "Controllare se una delle distribuzioni usa versioni del modello deprecate".
  • "Mostra l'utilizzo della quota in tutte le aree per la sottoscrizione."
  • "Mostra A100_80GB, H100_80GB, MI300_192GB e quota di acceleratori di H200_141GB nell'area Stati Uniti orientali 2".
Tool Access Description Input delle chiavi Restituzioni
model_monitoring_metrics_get leggere Ottenere le metriche di monitoraggio (richieste, latenza, errori, quota) per una distribuzione del modello. Nome distribuzione, intervallo di tempo (facoltativo) Numero di richieste, percentili di latenza, percentuali di errore e utilizzo dei token.
model_deprecation_info_get leggere Ottenere informazioni sulla distribuzione arricchite con pianificazioni di deprecazione e ritiro. Nome distribuzione (facoltativo) Dettagli della distribuzione con date di deprecazione e sostituzioni suggerite.
model_quota_list leggere Elencare la quota di distribuzione e l'utilizzo disponibili per una sottoscrizione in un'area, inclusa la quota dell'acceleratore di calcolo gestito. Sottoscrizione, area geografica Limiti di quota, utilizzo corrente e capacità disponibile per famiglia di modelli o acceleratore.

Connessioni del Progetto

Gestire le connessioni a servizi esterni (Azure OpenAI, Archiviazione BLOB di Azure, ricerca e altri) all'interno di un progetto Foundry.

Prompt di esempio:

  • "Elencare tutte le connessioni nel progetto Foundry."
  • "Mostra i dettagli per la connessione azure-search ."
  • "Quali tipi di connessione e metodi di autenticazione sono supportati?"
  • "Creare una nuova connessione AzureOpenAI chiamata my-openai usando l'autenticazione AAD".
  • "Eliminare la old-storage connessione dal progetto".
Tool Access Description Input delle chiavi Restituzioni
project_connection_list leggere Elencare tutte le connessioni in un progetto Foundry, con filtri facoltativi per categoria o destinazione. Filtro categoria, filtro di destinazione (entrambi facoltativi) Elenco di connessioni con nome, tipo e stato.
project_connection_get leggere Ottenere una connessione specifica in base al nome. Nome della connessione Dettagli della connessione, tra cui categoria, destinazione e tipo di autenticazione.
project_connection_list_metadata leggere Elencare tutte le categorie di connessione e i tipi di autenticazione supportati. Chiamare questa prima operazione per individuare i valori validi. Nessuno Categorie supportate (ad esempio, AzureOpenAI, AzureBlobStorage) e tipi di autenticazione (ad esempio, AAD, chiave).
project_connection_create scrivi Creare o sostituire una connessione di progetto. Nome connessione, categoria, destinazione, tipo di autenticazione Dettagli della connessione creati.
project_connection_update scrivi Aggiornare una connessione di progetto esistente. Nome connessione, campi da aggiornare Dettagli della connessione aggiornati.
project_connection_delete scrivi Eliminare una connessione di progetto in base al nome. Nome della connessione Conferma dell'eliminazione.

Ottimizzazione prompt

Ottimizzare le richieste di sistema e i messaggi per sviluppatori per migliorare le prestazioni LLM.

Prompt di esempio:

  • "Ottimizzare la richiesta di sistema: "Si è un agente del servizio clienti utile" usando gpt-5.4".
  • "Migliorare le istruzioni dell'agente per ottenere risposte più concise."
  • "Perfezionare la richiesta ottimizzata per gestire anche le domande di completamento."
Tool Access Description Input delle chiavi Restituzioni
prompt_optimize scrivi Ottimizzare un prompt degli sviluppatori (messaggio di sistema) per migliorare le prestazioni LLM usando l'utilità di ottimizzazione richiesta OpenAI Azure. Testo della richiesta, modello di destinazione, istruzioni di perfezionamento (facoltativo) Testo del prompt ottimizzato con spiegazione delle modifiche.

Valutazione continua

Abilitare, monitorare e gestire la valutazione continua per gli agenti. La valutazione continua valuta automaticamente le risposte dell'agente in modo continuativo. Lo strumento rileva automaticamente il tipo di agente (prompt o ospitato) e configura il meccanismo di valutazione appropriato, ovvero le regole di valutazione per gli agenti prompt o le esecuzioni di valutazione pianificate per gli agenti ospitati.

Prompt di esempio:

  • "Abilitare la valutazione continua per l'uso customer-support-agent degli analizzatori di pertinenza e di base".
  • "Configurare la valutazione continua per l'esecuzione dell'agente triage-agent ospitato ogni 2 ore".
  • "Mostrami la configurazione di valutazione continua per customer-support-agent".
  • "Disabilitare la valutazione continua per il mio old-test-agent".
  • "Aggiornare la valutazione continua per customer-support-agent fino a 50% di risposte di esempio."
Tool Access Description Input delle chiavi Restituzioni
continuous_eval_create scrivi Abilitare o aggiornare la valutazione continua per un agente. Rileva automaticamente il tipo di agente e configura il meccanismo di valutazione appropriato. Crea il gruppo di valutazione, se necessario. Nome agente, nomi dell'analizzatore, nome della distribuzione del modello (per gli analizzatori di qualità), flag abilitato, ore di intervallo (agenti ospitati), frequenza di campionamento (agenti prompt), scenario (standard o business) Configurazione di valutazione continua con ID, stato e dettagli della pianificazione.
continuous_eval_get leggere Ottenere la configurazione di valutazione continua per un agente. Restituisce tutte le configurazioni o filtrare in base a uno scenario per gli agenti prompt. Nome agente, filtro scenario (facoltativo) Elenco delle configurazioni di valutazione continua con dettagli dell'analizzatore, pianificazione e stato.
continuous_eval_delete scrivi Eliminare una configurazione di valutazione continua per un agente. Usare continuous_eval_get per trovare gli ID di configurazione. ID di configurazione, nome agente Conferma dell'eliminazione.

Flussi di lavoro di esempio

Distribuzione e ottimizzazione del modello:

  • "Mostrami il gpt-5.6-sol modello nel catalogo".
  • "Distribuire gpt-5.6-sol come customer-service-bot con 15 unità di capacità".
  • "Monitorare la latenza della richiesta per la nuova distribuzione".
  • "Consigliare alternative più convenienti in base all'utilizzo corrente."

Pianificazione della quota di calcolo gestita:

  • "Usare model_quota_list per visualizzare la quota e l'utilizzo dell'acceleratore di calcolo gestito per la sottoscrizione <subscription-id> negli Stati Uniti orientali 2".
  • "Confrontare le istanze disponibili per A100_80GB, H100_80GB, MI300_192GBe H200_141GB".
  • "Ho bisogno di quattro istanze. Identificare quali acceleratori hanno attualmente una quota disponibile sufficiente e ricordare che la disponibilità della quota non garantisce la capacità di distribuzione".
  • "Prima di qualsiasi distribuzione, visualizzare l'acceleratore selezionato e il numero di istanze da esaminare perché il calcolo gestito alloca capacità GPU dedicata fatturabile".

Ciclo di vita della distribuzione di calcolo gestito:

  • "Usare model_catalog_list per trovare i modelli annunciati per il calcolo gestito, dove isManagedCompute è true".
  • "Per openai--gpt-oss-20b, usare model_details_get per confermare che isFoundryManagedCompute è truee visualizzare il registro modelAssetId, i modelli di distribuzione risolti e gli acceleratori."
  • "Usare model_quota_list per controllare l'acceleratore selezionato negli Stati Uniti orientali 2 prima della distribuzione".
  • "Esaminare il modello di distribuzione, l'acceleratore e il numero di istanze con l'utente corrente. Dopo aver confermato l'allocazione della GPU dedicata fatturabile, usare model_deploy_managed_compute per creare gpt-oss-managed-test con il Registro di sistema modelAssetId, uno risolto deploymentTemplatee l'approvazione instanceCount".
  • "Usare model_deployment_get per monitorare gpt-oss-managed-test e verificare che sia KindManaged".
  • "Al termine del test e confermare la pulizia, usare model_deployment_delete per eliminare gpt-oss-managed-test".

Flusso di lavoro di valutazione dell'agente:

  • "Elencare tutti gli agenti nel mio progetto."
  • "Valutare la versione customer-support-agent 2 usando gli analizzatori di pertinenza, terra e sicurezza."
  • "Confrontare la valutazione di base con la nuova esecuzione".
  • "Mostra i risultati del confronto con significato statistico".

Configurazione di valutazione continua:

  • "Elencare tutti gli agenti nel mio progetto."
  • "Abilitare la valutazione continua per l'uso customer-support-agent di analizzatori di rilevanza, terra e sicurezza con la distribuzione esistente gpt-5.6-luna ".
  • "Mostrami la configurazione di valutazione continua per customer-support-agent".
  • "Aggiornare la valutazione continua al campione 25% di risposte con un massimo di 10 esecuzioni all'ora".

Gestione delle risorse e pulizia:

  • "Elencare tutte le distribuzioni correnti e il relativo utilizzo".
  • "Controllare quali distribuzioni usano versioni del modello deprecate".
  • "Mostra l'utilizzo della quota in tutte le aree".
  • "Eliminare le distribuzioni di test inutilizzate per liberare capacità".

Limitazioni dell'anteprima

Foundry MCP Server è disponibile in anteprima pubblica. Si applicano le limitazioni seguenti:

  • Nessun isolamento di rete : foundry MCP Server usa l'endpoint https://mcp.ai.azure.compubblico . Le risorse dietro Azure collegamenti privati non sono accessibili. Per la connettività MCP privata, creare il proprio server MCP e connetterlo al servizio Agent con la rete privata.
  • Residenza dei dati : le richieste e le risposte potrebbero essere elaborate nei data center ue o negli Stati Uniti. Il server stesso non archivia i dati, ma può verificarsi l'elaborazione tra aree.
  • Nessun contratto di servizio : le funzionalità di anteprima non includono un contratto di servizio. Non usare il server per i carichi di lavoro di produzione che richiedono disponibilità garantita.
  • Il set di strumenti può cambiare : gli strumenti, i parametri e i valori restituiti possono cambiare durante il periodo di anteprima senza preavviso.

Per altre informazioni, vedere Condizioni per l'utilizzo Microsoft Azure anteprime.

Errori comuni

Error Cause Resolution
Accesso negato Insufficienti Azure ruolo controllo degli accessi in base al ruolo nel progetto o nell'account Foundry. Assegnare almeno Lettore per gli strumenti di lettura o Collaboratore per gli strumenti di scrittura. Vedere RBAC per Microsoft Foundry.
Errore di autenticazione Token di Entra ID scaduto o non valido. Disconnettersi e accedere di nuovo all'account Azure in Visual Studio Code o allo strumento in uso.
La quota è stata superata Capacità insufficiente per creare una distribuzione o eseguire una valutazione. Usare model_quota_list per controllare la quota disponibile prima dell'operazione.
Risorsa non trovata La distribuzione, il set di dati, l'agente o la connessione specificati non esiste. Usare lo strumento o get corrispondente list per verificare il nome della risorsa.
Endpoint privato non raggiungibile Le risorse foundry usano Azure collegamenti privati non raggiungibili dal server MCP Foundry ospitato. Rimuovere le restrizioni dell'endpoint privato, usare SDK/API REST o usare un server MCP personalizzato con la rete privata del servizio Agent.

Per altre indicazioni sulla risoluzione dei problemi, vedere Foundry MCP Server security and best practices (Sicurezza e procedure consigliate per il server McP Foundry).

Contenuti correlati

  • Last updated on