Plugin Microsoft Foundry

Aggiunge a OpenClaw il supporto per il provider di modelli Microsoft Foundry.

Distribuzione

• Pacchetto: @openclaw/microsoft-foundry
• Modalità di installazione: incluso in OpenClaw

Superficie

provider: microsoft-foundry; contratti: imageGenerationProviders

• Provider di generazione di immagini: microsoft-foundry

Requisiti

• Una risorsa Microsoft Foundry o Azure AI Foundry con distribuzioni.
• Autenticazione tramite chiave API mediante AZURE_OPENAI_API_KEY o una chiave API del provider configurata.
• Per l'autenticazione Entra ID, installare la CLI di Azure ed eseguire az login prima dell'onboarding. OpenClaw aggiorna i token di runtime di Microsoft Foundry tramite az account get-access-token.

Modelli di chat

Le distribuzioni di chat di Microsoft Foundry utilizzano il riferimento al modello del provider microsoft-foundry/<deployment-name>. L'onboarding individua le risorse e le distribuzioni Foundry tramite la CLI di Azure, quindi scrive il nome della distribuzione selezionata nella configurazione del modello.

OpenClaw utilizza l'endpoint Foundry /openai/v1 per le API di chat compatibili con OpenAI supportate:

• Le famiglie di modelli GPT, o*, computer-use-preview e DeepSeek-V4 utilizzano per impostazione predefinita openai-responses.
• MAI-DS-R1 e le altre distribuzioni di completamento chat utilizzano openai-completions, a meno che non sia configurata esplicitamente un'API supportata.
• MAI-DS-R1 viene registrato come capace di ragionamento tramite il contenuto di ragionamento, non tramite reasoning_effort. I metadati relativi al contesto e ai token di output sono pari a 163,840 token.

Le distribuzioni Anthropic Claude in Microsoft Foundry utilizzano il formato dell'API Anthropic Messages, non il formato compatibile con OpenAI /openai/v1. Configurarle come provider anthropic-messages personalizzato finché il Plugin Microsoft Foundry non disporrà di un runtime Anthropic nativo. Quando il nome della distribuzione Foundry è diverso dall'ID del modello Claude, impostare params.canonicalModelId nella voce del modello affinché OpenClaw possa applicare i contratti di trasmissione specifici del modello, mappare correttamente /think off e preservare in sicurezza il ragionamento firmato.

Generazione di immagini MAI

Il Plugin registra microsoft-foundry per image_generate con gli attuali modelli di immagini Microsoft AI:

• MAI-Image-2.5-Flash
• MAI-Image-2.5
• MAI-Image-2e
• MAI-Image-2

Utilizzare come riferimento al modello il nome di una distribuzione di immagini MAI distribuita. Il provider non dichiara un modello di immagini predefinito perché l'API MAI richiede il nome della distribuzione nel campo model della richiesta:

{  agents: {    defaults: {      imageGenerationModel: {        primary: "microsoft-foundry/<deployment-name>",        timeoutMs: 600000,      },    },  },}

La generazione basata sul solo prompt chiama l'endpoint delle generazioni MAI di Microsoft Foundry: /mai/v1/images/generations. Le modifiche basate su immagini di riferimento chiamano /mai/v1/images/edits e sono limitate alle distribuzioni MAI-Image-2.5-Flash e MAI-Image-2.5.

La generazione basata sul solo prompt può utilizzare un nome di distribuzione personalizzato configurando unicamente l'endpoint Foundry. Per le modifiche alle immagini con un nome di distribuzione personalizzato, selezionare la distribuzione tramite l'onboarding o includere i metadati del modello affinché OpenClaw possa verificare che la distribuzione sia basata su MAI-Image-2.5-Flash o MAI-Image-2.5.

Vincoli per le immagini MAI:

• Output: un'immagine PNG per richiesta.
• Dimensioni: valore predefinito 1024x1024; sia la larghezza sia l'altezza devono essere di almeno 768 px.
• Pixel totali: larghezza × altezza non deve superare 1,048,576.
• Modifiche: un'immagine di input PNG o JPEG.
• I suggerimenti condivisi non supportati, come aspectRatio, resolution, quality, background e outputFormat non PNG, non vengono inviati a Microsoft Foundry.

Risoluzione dei problemi

• az: command not found: installare la CLI di Azure o utilizzare l'autenticazione tramite chiave API.
• Microsoft Foundry endpoint missing for MAI image generation: selezionare una distribuzione Foundry tramite l'onboarding o aggiungere models.providers.microsoft-foundry.baseUrl.
• supports MAI image deployments only: il modello di immagini selezionato fa riferimento a una distribuzione non MAI. Utilizzare un modello di immagini MAI distribuito per image_generate.