Plugin Microsoft Foundry

Dodaje do OpenClaw obsługę dostawcy modeli Microsoft Foundry.

Dystrybucja

• Pakiet: @openclaw/microsoft-foundry
• Sposób instalacji: zawarty w OpenClaw

Powierzchnia

dostawcy: microsoft-foundry; kontrakty: imageGenerationProviders

• Dostawca generowania obrazów: microsoft-foundry

Wymagania

• Zasób Microsoft Foundry lub Azure AI Foundry z wdrożeniami.
• Uwierzytelnianie kluczem API przez AZURE_OPENAI_API_KEY lub skonfigurowany klucz API dostawcy.
• W przypadku uwierzytelniania Entra ID należy zainstalować Azure CLI i uruchomić az login przed konfiguracją początkową. OpenClaw odświeża tokeny środowiska uruchomieniowego Microsoft Foundry za pomocą az account get-access-token.

Modele czatu

Wdrożenia czatu Microsoft Foundry używają odwołania do modelu dostawcy microsoft-foundry/<deployment-name>. Podczas konfiguracji początkowej zasoby Foundry i wdrożenia są wykrywane za pomocą Azure CLI, a następnie nazwa wybranego wdrożenia jest zapisywana w konfiguracji modelu.

OpenClaw używa punktu końcowego Foundry /openai/v1 dla obsługiwanych interfejsów API czatu zgodnych z OpenAI:

• Rodziny modeli GPT, o*, computer-use-preview i DeepSeek-V4 domyślnie używają openai-responses.
• MAI-DS-R1 i inne wdrożenia uzupełniania czatu używają openai-completions, chyba że skonfigurowano jawnie obsługiwany interfejs API.
• MAI-DS-R1 jest rejestrowany jako model obsługujący rozumowanie za pośrednictwem treści rozumowania, a nie przez reasoning_effort. Metadane jego kontekstu i tokenów wyjściowych wynoszą 163,840 tokenów.

Wdrożenia Anthropic Claude w Microsoft Foundry używają formatu interfejsu API Anthropic Messages, a nie zgodnego z OpenAI formatu /openai/v1. Należy skonfigurować je jako niestandardowego dostawcę anthropic-messages, dopóki Plugin Microsoft Foundry nie otrzyma natywnego środowiska uruchomieniowego Anthropic. Jeśli nazwa wdrożenia Foundry różni się od identyfikatora modelu Claude, należy ustawić params.canonicalModelId we wpisie modelu, aby OpenClaw mógł zastosować kontrakty transmisji specyficzne dla modelu, prawidłowo mapować /think off i bezpiecznie zachowywać podpisane rozumowanie.

Generowanie obrazów MAI

Plugin rejestruje microsoft-foundry dla image_generate z bieżącymi modelami obrazów Microsoft AI:

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

Jako odwołania do modelu należy użyć nazwy wdrożonego wdrożenia obrazów MAI. Dostawca nie deklaruje domyślnego modelu obrazów, ponieważ interfejs API MAI wymaga nazwy wdrożenia w polu żądania model:

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

Generowanie wyłącznie na podstawie monitu wywołuje punkt końcowy generowania MAI usługi Microsoft Foundry: /mai/v1/images/generations. Edycje z obrazem referencyjnym wywołują /mai/v1/images/edits i są ograniczone do wdrożeń MAI-Image-2.5-Flash oraz MAI-Image-2.5.

Generowanie wyłącznie na podstawie monitu może używać niestandardowej nazwy wdrożenia, jeśli skonfigurowany jest tylko punkt końcowy Foundry. W przypadku edycji obrazów z niestandardową nazwą wdrożenia należy wybrać wdrożenie podczas konfiguracji początkowej lub dołączyć metadane modelu, aby OpenClaw mógł sprawdzić, czy wdrożenie jest oparte na MAI-Image-2.5-Flash lub MAI-Image-2.5.

Ograniczenia obrazów MAI:

• Dane wyjściowe: jeden obraz PNG na żądanie.
• Rozmiar: domyślnie 1024x1024; zarówno szerokość, jak i wysokość muszą wynosić co najmniej 768 px.
• Łączna liczba pikseli: szerokość × wysokość może wynosić najwyżej 1,048,576.
• Edycje: jeden wejściowy obraz PNG lub JPEG.
• Nieobsługiwane wspólne wskazówki, takie jak aspectRatio, resolution, quality, background oraz formaty outputFormat inne niż PNG nie są wysyłane do Microsoft Foundry.

Rozwiązywanie problemów

• az: command not found: należy zainstalować Azure CLI lub użyć uwierzytelniania kluczem API.
• Microsoft Foundry endpoint missing for MAI image generation: należy wybrać wdrożenie Foundry podczas konfiguracji początkowej lub dodać models.providers.microsoft-foundry.baseUrl.
• supports MAI image deployments only: wybrany model obrazów wskazuje wdrożenie inne niż MAI. Dla image_generate należy użyć wdrożonego modelu obrazów MAI.