Strumenti server MCP di Azure per Estensioni Microsoft Foundry

Il server MCP di Azure consente di gestire le risorse delle estensioni Microsoft Foundry, tra cui la creazione di completamenti di chat e testo, la generazione di embedding, l'elencazione di modelli e l'uso degli indici di conoscenza, con prompt del linguaggio naturale.

Microsoft Foundry è una piattaforma per la distribuzione e la gestione di modelli di intelligenza artificiale personalizzati in Azure. Fornisce strumenti e servizi per il training, l'ottimizzazione, la distribuzione e il monitoraggio dei modelli di intelligenza artificiale negli ambienti di produzione.

I comandi dell'indice di conoscenza richiedono l'endpoint del progetto Microsoft Foundry. I comandi OpenAI richiedono il nome della risorsa e il gruppo di risorse. Il comando get della risorsa può elencare le risorse senza specificare un nome di risorsa.

Note

parametri Tool: gli strumenti server Azure MCP definiscono i parametri per i dati necessari per completare le attività. Alcuni di questi parametri sono specifici di ogni strumento e sono documentati qui. Altri parametri sono globali e condivisi da tutti gli strumenti. Per altre informazioni, vedere Parametri degli strumenti.

Knowledge: Elencare gli indici delle conoscenze

Ottenere un elenco di indici delle conoscenze da Foundry:

  • Trovare gli indici delle conoscenze creati all'interno dei progetti Foundry.
  • Usare questi indici con gli agenti di intelligenza artificiale per il recupero delle informazioni e le applicazioni RAG.
  • L'elenco viene aggiornato durante la creazione di nuovi indici o l'aggiornamento di quelli esistenti.

Comando CLI di esempio

azmcp foundryextensions knowledge index list \
  --endpoint <endpoint>
Parameter Tipo Required Description
endpoint string Sì URL dell'endpoint del progetto o del servizio Microsoft Foundry. L'endpoint segue questo modello: https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
❌ ✅ ❌ ✅ ❌ ❌

Knowledge: Ottenere lo schema dell'indice

Ottenere la configurazione dettagliata dello schema di un indice di knowledge base specifico da Foundry.

Questa operazione mostra informazioni complete sulla struttura e sulla configurazione di un indice della knowledge base, incluse definizioni di campo, tipi di dati, attributi ricercabili e altre proprietà dello schema. Usa queste informazioni sullo schema per comprendere come le strutture di indici e indicizzano i tuoi dati per la ricerca.

Comando CLI di esempio

azmcp foundryextensions knowledge index schema \
  --index <index> \
  --endpoint <endpoint>
Parameter Tipo Required Description
index string Sì Nome dell'indice delle informazioni.
endpoint string Sì L'URL dell'endpoint per il progetto o il servizio Microsoft Foundry. L'endpoint segue questo modello: https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
❌ ✅ ❌ ✅ ❌ ❌

OpenAI: Creare completamenti di chat

Creare completamenti di chat usando Azure OpenAI in Foundry. Inviare messaggi a Azure modelli di chat OpenAI distribuiti nella risorsa Foundry e ricevere risposte conversazionali generate dall'intelligenza artificiale. Supporta conversazioni a più turni con cronologia messaggi, istruzioni di sistema e personalizzazione delle risposte.

Comando CLI di esempio

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 Tipo Required Description
resource-name string Sì Nome della risorsa Microsoft Foundry.
deployment string Sì Nome della distribuzione.
message-array string Sì Matrice JSON di messaggi nella conversazione. Ogni messaggio deve avere role proprietà e content .
resource-group string Sì Nome del gruppo di risorse di Azure.
max-tokens string No Numero massimo di token da generare nel completamento.
temperature string No Controlla la casualità nell'output. I valori inferiori lo rendono più deterministico.
top-p string No Controlla la diversità tramite campionamento del nucleo (da 0,0 a 1,0). Il valore predefinito è 1.0.
frequency-penalty string No Penalizza i nuovi token in base alla frequenza (da -2,0 a 2,0). Il valore predefinito è 0.
presence-penalty string No Penalizza i nuovi token in base alla presenza (da -2,0 a 2,0). Il valore predefinito è 0.
stop string No Fino a 4 sequenze in cui l'API smette di generare altri token.
stream string No Indica se eseguire il flusso di avanzamento parziale. Il valore predefinito è false.
seed string No Se specificato, il sistema fa il massimo sforzo per campionare in modo deterministico.
user string No Identificatore utente per il tracciamento e il monitoraggio degli abusi.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
❌ ❌ ❌ ✅ ❌ ❌

OpenAI: Creare incorporamenti

Creare incorporamenti usando Azure OpenAI in Foundry. Generare embedding vettoriali dal testo usando le distribuzioni OpenAI di Azure nella risorsa Foundry per la ricerca semantica, i confronti di somiglianza, il clustering o l'apprendimento automatico.

Comando CLI di esempio

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 Tipo Required Description
resource-name string Sì Nome della risorsa Microsoft Foundry.
deployment string Sì Nome della distribuzione.
input-text string Sì Testo di input per cui generare incorporamenti.
resource-group string Sì Nome del gruppo di risorse di Azure.
user string No Identificatore utente per il tracciamento e il monitoraggio degli abusi.
encoding-format string No Il formato in cui restituire gli embedding (float o base64).
dimensions string No Numero di dimensioni per l'output di incorporazione. Supportato solo in alcuni modelli.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
❌ ❌ ❌ ✅ ❌ ❌

OpenAI: Creare completamenti

Creare completamenti di testo usando Azure OpenAI in Foundry. Inviare una richiesta o una domanda ai modelli OpenAI di Azure distribuiti nella risorsa Foundry e ricevere risposte testuali generate. Usare questa funzionalità quando è necessario creare completamenti, ottenere contenuto generato dall'intelligenza artificiale, generare risposte alle domande o produrre completamenti di testo da Azure OpenAI in base a qualsiasi richiesta di input. Supporta la personalizzazione con temperatura e numero massimo di token.

Comando CLI di esempio

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 Tipo Required Description
deployment string Sì Nome della distribuzione.
prompt-text string Sì Testo prompt da inviare al modello per il completamento.
resource-name string Sì Nome della risorsa Microsoft Foundry.
resource-group string Sì Nome del gruppo di risorse di Azure.
max-tokens string No Numero massimo di token da generare nel completamento.
temperature string No Controlla la casualità nell'output. I valori inferiori lo rendono più deterministico.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
❌ ❌ ❌ ✅ ❌ ❌

OpenAI: Elencare modelli e distribuzioni

Elencare le distribuzioni dei modelli Azure OpenAI in una risorsa di Microsoft Foundry. Questo strumento recupera informazioni sui modelli distribuiti, inclusi i nomi dei modelli, le versioni, le funzionalità e lo stato della distribuzione.

Comando CLI di esempio

azmcp foundryextensions openai models-list \
  --resource-name <resource-name> \
  --resource-group <resource-group>
Parameter Tipo Required Description
resource-name string Sì Nome della risorsa Microsoft Foundry.
resource-group string Sì Nome del gruppo di risorse di Azure.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
❌ ✅ ❌ ✅ ❌ ❌

Risorse: Ottieni risorsa Foundry

Elencare o recuperare le risorse Microsoft Foundry e restituire dettagli a livello di singola risorsa, ad esempio l'URL dell'endpoint, la posizione, lo SKU, il tipo e lo stato di provisioning. Se si specifica un nome di risorsa, lo strumento restituisce la singola risorsa. In caso contrario, restituisce l'inventario delle risorse nell'ambito di applicazione. Per l'inventario della distribuzione del modello all'interno di una risorsa Foundry, usare lo strumento di elenco dei modelli OpenAI.

Comando CLI di esempio

azmcp foundryextensions resource get \
  [--resource-name <resource-name>]
Parameter Tipo Required Description
resource-name string No Nome della risorsa Microsoft Foundry.

Suggerimenti per l'annotazione degli strumenti:

Distruttivo Idempotente Open World Sola lettura Secret Locale obbligatorio
❌ ✅ ❌ ✅ ❌ ❌

Contenuti correlati

  • Last updated on