Microsoft Foundry Plugin'i

OpenClaw'a Microsoft Foundry model sağlayıcısı desteği ekler.

Dağıtım

• Paket: @openclaw/microsoft-foundry
• Kurulum yolu: OpenClaw'a dahildir

Yüzey

sağlayıcılar: microsoft-foundry; sözleşmeler: imageGenerationProviders

• Görüntü oluşturma sağlayıcısı: microsoft-foundry

Gereksinimler

• Dağıtımları bulunan bir Microsoft Foundry veya Azure AI Foundry kaynağı.
• AZURE_OPENAI_API_KEY ya da yapılandırılmış bir sağlayıcı API anahtarı üzerinden API anahtarıyla kimlik doğrulama.
• Entra ID kimlik doğrulaması için Azure CLI'yi yükleyin ve ilk katılımdan önce az login komutunu çalıştırın. OpenClaw, Microsoft Foundry çalışma zamanı tokenlarını az account get-access-token aracılığıyla yeniler.

Sohbet modelleri

Microsoft Foundry sohbet dağıtımları, microsoft-foundry/<deployment-name> sağlayıcı model başvurusunu kullanır. İlk katılım, Azure CLI ile Foundry kaynaklarını ve dağıtımlarını keşfeder, ardından seçilen dağıtım adını model yapılandırmasına yazar.

OpenClaw, desteklenen OpenAI uyumlu sohbet API'leri için Foundry /openai/v1 uç noktasını kullanır:

• GPT, o*, computer-use-preview ve DeepSeek-V4 model aileleri varsayılan olarak openai-responses kullanır.
• MAI-DS-R1 ve diğer sohbet tamamlama dağıtımları, açıkça desteklenen bir API yapılandırılmadığı sürece openai-completions kullanır.
• MAI-DS-R1, reasoning_effort aracılığıyla değil, akıl yürütme içeriği aracılığıyla akıl yürütme yeteneğine sahip olarak kaydedilir. Bağlam ve çıktı tokenı meta verileri 163.840 tokendir.

Microsoft Foundry'deki Anthropic Claude dağıtımları, OpenAI uyumlu /openai/v1 biçimini değil, Anthropic Messages API biçimini kullanır. Microsoft Foundry Plugin'i yerel bir Anthropic çalışma zamanı kazanana kadar bunları özel bir anthropic-messages sağlayıcısı olarak yapılandırın. Foundry dağıtım adı Claude model kimliğinden farklı olduğunda, OpenClaw'ın modele özgü iletişim sözleşmelerini uygulayabilmesi, /think off komutunu doğru şekilde eşleyebilmesi ve imzalı düşünme verilerini güvenli biçimde koruyabilmesi için model girdisinde params.canonicalModelId değerini ayarlayın.

MAI görüntü oluşturma

Plugin, güncel Microsoft AI görüntü modelleriyle image_generate için microsoft-foundry sağlayıcısını kaydeder:

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

Model başvurusu olarak dağıtılmış bir MAI görüntü dağıtımının adını kullanın. MAI API'si, istek içindeki model alanında dağıtım adınızı gerektirdiğinden sağlayıcı varsayılan bir görüntü modeli bildirmez:

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

Yalnızca istem içeren oluşturma işlemleri, Microsoft Foundry'nin MAI oluşturma uç noktasını çağırır: /mai/v1/images/generations. Referans görüntüsü düzenlemeleri /mai/v1/images/edits uç noktasını çağırır ve MAI-Image-2.5-Flash ile MAI-Image-2.5 dağıtımlarıyla sınırlıdır.

Yalnızca istem içeren oluşturma işlemleri, yalnızca Foundry uç noktası yapılandırılmışken özel bir dağıtım adı kullanabilir. Özel bir dağıtım adıyla görüntü düzenlemek için dağıtımı ilk katılım üzerinden seçin veya OpenClaw'ın dağıtımın MAI-Image-2.5-Flash ya da MAI-Image-2.5 tarafından desteklendiğini doğrulayabilmesi için model meta verilerini ekleyin.

MAI görüntü kısıtlamaları:

• Çıktı: istek başına bir PNG görüntüsü.
• Boyut: varsayılan 1024x1024; genişlik ve yükseklik en az 768 piksel olmalıdır.
• Toplam piksel: genişlik × yükseklik en fazla 1.048.576 olmalıdır.
• Düzenlemeler: bir PNG veya JPEG girdi görüntüsü.
• aspectRatio, resolution, quality, background ve PNG dışındaki outputFormat gibi desteklenmeyen ortak ipuçları Microsoft Foundry'ye gönderilmez.

Sorun giderme

• az: command not found: Azure CLI'yi yükleyin veya API anahtarıyla kimlik doğrulamayı kullanın.
• Microsoft Foundry endpoint missing for MAI image generation: ilk katılım üzerinden bir Foundry dağıtımı seçin veya models.providers.microsoft-foundry.baseUrl ekleyin.
• supports MAI image deployments only: seçilen görüntü modeli MAI dışı bir dağıtımı gösteriyor. image_generate için dağıtılmış bir MAI görüntü modeli kullanın.