Come generare risposte di testo con Microsoft Modelli Foundry

Questo articolo illustra come generare risposte di testo per i modelli Foundry, ad esempio Microsoft modelli di intelligenza artificiale, DeepSeek e Grok usando l'API Risposte. Per un elenco completo dei Modelli Foundry che supportano l'uso dell'API Risposte, vedere Supported Foundry Models (Modelli di foundry supportati).

Prerequisiti

Per usare l'API Risposte con i modelli distribuiti nell'applicazione, è necessario:

  • Sottoscrizione Azure.

  • Progetto Foundry. Questo tipo di progetto viene gestito tramite una risorsa Foundry. Se non si ha un progetto Foundry, vedere Creare un progetto per Microsoft Foundry.

  • L'URL dell'endpoint del tuo progetto Foundry, che è del formato https://YOUR-RESOURCE-NAME.services.ai.azure.com/api/projects/YOUR_PROJECT_NAME.

  • Una distribuzione di un modello Foundry, come il modello DeepSeek-R1-0528 usato in questo articolo. Se non si ha già una distribuzione, vedere Aggiungere e configurare i modelli Foundry per aggiungere una distribuzione del modello alla risorsa.

Usare lo starter kit del modello di intelligenza artificiale

I frammenti di codice in questo articolo provengono dallo starter kit del modello di intelligenza artificiale. Usare questo starter kit come modo rapido per iniziare a usare l'infrastruttura cloud completa e il codice necessari per chiamare i modelli Foundry, usando una libreria OpenAI stabile con l'API Risposte.

Usare l'API Risposte per generare testo

Usare il codice in questa sezione per effettuare chiamate API di risposte per i modelli Foundry. Negli esempi di codice si crea il client per utilizzare il modello e quindi si invia una richiesta di base.

Suggerimento

Quando si distribuisce un modello nel portale foundry, si assegna un nome di distribuzione. Usare questo nome di distribuzione (non l'ID catalogo del modello) nel model parametro delle chiamate API.

Nota

Usare l'autenticazione senza chiave con Microsoft Entra ID. Per altre informazioni sull'autenticazione senza password, vedere Cos'è l'autenticazione Microsoft Entra? e DefaultAzureCredential.

  1. Installare librerie, inclusa la libreria client Azure Identity:

    pip install azure-identity
pip install -U openai

  2. Usare il codice seguente per configurare l'oggetto client OpenAI nella route del progetto, specificare la distribuzione e generare risposte.

    from azure.identity import DefaultAzureCredential, get_bearer_token_provider
from openai import OpenAI

project_endpoint = "https://YOUR-RESOURCE-NAME.services.ai.azure.com/api/projects/YOUR_PROJECT_NAME"
# Build the base URL: project_endpoint + /openai/v1 (no api-version needed)
base_url = project_endpoint.rstrip("/") + "/openai/v1"

# Use get_bearer_token_provider for automatic token refresh
credential = DefaultAzureCredential()
client = OpenAI(
    base_url=base_url,
    api_key=get_bearer_token_provider(credential, "https://ai.azure.com/.default"),
)

response = client.responses.create(
    model="DeepSeek-R1-0528", # Replace with your deployment name, not the model ID 
    input="What are the top 3 benefits of cloud computing? Be concise.",
    max_output_tokens=2000,
)

print(f"Response: {response.output_text}")
print(f"Status:   {response.status}")
print(f"Output tokens: {response.usage.output_tokens}")

La risposta include il testo generato insieme ai metadati del modello e dell'utilizzo.

Modelli di fonderia supportati

Una selezione di modelli Foundry viene supportata per l'uso con la Responses API.

Visualizzare i modelli supportati nel portale foundry

Per visualizzare un elenco completo dei modelli supportati nel portale foundry:

  1. Accedere a Microsoft Foundry. Assicurarsi che l'interruttore New Foundry sia attivato. Questi passaggi fanno riferimento a Foundry (nuovo).These steps refer to Foundry (new).
  2. Selezionare Esplora nella barra di navigazione in alto a destra, quindi Modelli nel riquadro sinistro.
  3. Aprire l'elenco a discesa Funzionalità e selezionare il filtro supportato dall'agente .

Elenco dei modelli supportati

Questa sezione elenca alcuni dei Modelli Foundry supportati per l'uso con l'API delle Risposte. Per i modelli OpenAI Azure supportati, vedere Modelli OpenAI di Azure disponibili.

Modelli di Foundry venduti da Azure:

  • MAI-DS-R1: ragionamento deterministico e incentrato sulla precisione.
  • grok-4: ragionamento su scala di frontiera per la risoluzione di problemi complessi e in più passaggi.
  • grok-4-fast-reasoning: ragionamento agentico accelerato ottimizzato per l'automazione del flusso di lavoro.
  • grok-4-fast-non-reasoning: alta velocità di trasmissione, generazione a bassa latenza e instradamento del sistema.
  • grok-3: ragionamento forte per flussi di lavoro complessi a livello di sistema.
  • grok-3-mini: modello leggero ottimizzato per casi d'uso interattivi ad alto volume.
  • Llama-3.3-70B-Instruct: modello versatile per Q&A aziendale, supporto decisionale e orchestrazione del sistema.
  • Llama-4-Maverick-17B-128E-Instruct-FP8: modello ottimizzato per FP8 che offre inferenza rapida e conveniente.
  • DeepSeek-V3-0324: comprensione multimodale tra testo e immagini.
  • DeepSeek-V3.1: ragionamento multimodale avanzato e recupero contestualizzato.
  • DeepSeek-V3.2: modello che armonizza l'efficienza di calcolo elevata con un ragionamento e prestazioni dell'agente superiori.
  • DeepSeek-V3.2-Speciale: variante specializzata DeepSeek-V3.2.
  • DeepSeek-R1-0528: ragionamento avanzato in formato lungo e in più passaggi.
  • gpt-oss-120b: modello open-ecosystem che supporta trasparenza e riproducibilità.

Risolvere gli errori comuni

Errore Causa Risoluzione
401 Non autorizzato Credenziali non valide o scadute Verificare che DefaultAzureCredential disponga del ruolo Utente OpenAI di Servizi cognitivi nella risorsa.
404 Non trovato Nome dell'endpoint o della distribuzione non corretto Verificare che l'URL dell'endpoint includa /api/projects/YOUR_PROJECT_NAME e che il nome della distribuzione corrisponda al portale Foundry.
400 Modello non supportato Il modello non supporta l'API Risposte Controllare l'elenco dei modelli supportati e verificare che la distribuzione usi un modello compatibile.

Contenuto correlato

  • Last updated on