Microsoft Foundry Plugin

OpenClaw में Microsoft Foundry मॉडल प्रदाता समर्थन जोड़ता है।

वितरण

• पैकेज: @openclaw/microsoft-foundry
• इंस्टॉल मार्ग: OpenClaw में शामिल

सतह

प्रदाता: microsoft-foundry; अनुबंध: imageGenerationProviders

• छवि-निर्माण प्रदाता: microsoft-foundry

आवश्यकताएँ

• डिप्लॉयमेंट वाला Microsoft Foundry या Azure AI Foundry संसाधन।
• AZURE_OPENAI_API_KEY के माध्यम से API-कुंजी प्रमाणीकरण या कॉन्फ़िगर की गई प्रदाता API कुंजी।
• Entra ID प्रमाणीकरण के लिए, Azure CLI इंस्टॉल करें और ऑनबोर्डिंग से पहले az login चलाएँ। OpenClaw, Microsoft Foundry रनटाइम टोकन को az account get-access-token के माध्यम से रीफ़्रेश करता है।

चैट मॉडल

Microsoft Foundry चैट डिप्लॉयमेंट प्रदाता मॉडल संदर्भ microsoft-foundry/<deployment-name> का उपयोग करते हैं। ऑनबोर्डिंग Azure CLI से Foundry संसाधनों और डिप्लॉयमेंट का पता लगाती है, फिर चुने गए डिप्लॉयमेंट का नाम मॉडल कॉन्फ़िगरेशन में लिखती है।

समर्थित OpenAI-संगत चैट API के लिए OpenClaw, Foundry /openai/v1 एंडपॉइंट का उपयोग करता है:

• GPT, o*, computer-use-preview, और DeepSeek-V4 मॉडल परिवारों के लिए डिफ़ॉल्ट openai-responses है।
• MAI-DS-R1 और अन्य चैट-कम्प्लीशन डिप्लॉयमेंट openai-completions का उपयोग करते हैं, जब तक कोई स्पष्ट रूप से समर्थित API कॉन्फ़िगर न हो।
• MAI-DS-R1 को reasoning_effort के माध्यम से नहीं, बल्कि रीजनिंग सामग्री के माध्यम से रीजनिंग-सक्षम के रूप में दर्ज किया जाता है। इसके संदर्भ और आउटपुट टोकन का मेटाडेटा 163,840 टोकन है।

Microsoft Foundry में Anthropic Claude डिप्लॉयमेंट, OpenAI-संगत /openai/v1 संरचना के बजाय Anthropic Messages API संरचना का उपयोग करते हैं। जब तक Microsoft Foundry Plugin में मूल Anthropic रनटाइम नहीं जोड़ा जाता, उन्हें कस्टम anthropic-messages प्रदाता के रूप में कॉन्फ़िगर करें। जब Foundry डिप्लॉयमेंट का नाम Claude मॉडल ID से अलग हो, तो मॉडल प्रविष्टि पर params.canonicalModelId सेट करें, ताकि OpenClaw मॉडल-विशिष्ट वायर अनुबंध लागू कर सके, /think off को सही ढंग से मैप कर सके, और हस्ताक्षरित थिंकिंग को सुरक्षित रूप से संरक्षित रख सके।

MAI छवि निर्माण

Plugin वर्तमान Microsoft AI छवि मॉडल के साथ image_generate के लिए microsoft-foundry पंजीकृत करता है:

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

मॉडल संदर्भ के रूप में डिप्लॉय किए गए MAI छवि डिप्लॉयमेंट के नाम का उपयोग करें। प्रदाता डिफ़ॉल्ट छवि मॉडल घोषित नहीं करता, क्योंकि MAI API को अनुरोध के model फ़ील्ड में आपके डिप्लॉयमेंट के नाम की आवश्यकता होती है:

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

केवल-प्रॉम्प्ट निर्माण Microsoft Foundry के MAI जनरेशन एंडपॉइंट को कॉल करता है: /mai/v1/images/generations। संदर्भ-छवि संपादन /mai/v1/images/edits को कॉल करते हैं और MAI-Image-2.5-Flash तथा MAI-Image-2.5 डिप्लॉयमेंट तक सीमित हैं।

केवल-प्रॉम्प्ट निर्माण केवल Foundry एंडपॉइंट कॉन्फ़िगर करके कस्टम डिप्लॉयमेंट नाम का उपयोग कर सकता है। कस्टम डिप्लॉयमेंट नाम के साथ छवि संपादन के लिए, ऑनबोर्डिंग के माध्यम से डिप्लॉयमेंट चुनें या मॉडल मेटाडेटा शामिल करें, ताकि OpenClaw सत्यापित कर सके कि डिप्लॉयमेंट MAI-Image-2.5-Flash या MAI-Image-2.5 द्वारा समर्थित है।

MAI छवि सीमाएँ:

• आउटपुट: प्रति अनुरोध एक PNG छवि।
• आकार: डिफ़ॉल्ट 1024x1024; चौड़ाई और ऊँचाई, दोनों कम-से-कम 768 px होनी चाहिए।
• कुल पिक्सेल: चौड़ाई × ऊँचाई अधिकतम 1,048,576 होनी चाहिए।
• संपादन: एक PNG या JPEG इनपुट छवि।
• aspectRatio, resolution, quality, background, और गैर-PNG outputFormat जैसे असमर्थित साझा संकेत Microsoft Foundry को नहीं भेजे जाते।

समस्या निवारण

• az: command not found: Azure CLI इंस्टॉल करें या API-कुंजी प्रमाणीकरण का उपयोग करें।
• Microsoft Foundry endpoint missing for MAI image generation: ऑनबोर्डिंग के माध्यम से Foundry डिप्लॉयमेंट चुनें या models.providers.microsoft-foundry.baseUrl जोड़ें।
• supports MAI image deployments only: चुना गया छवि मॉडल गैर-MAI डिप्लॉयमेंट की ओर इंगित करता है। image_generate के लिए डिप्लॉय किया गया MAI छवि मॉडल उपयोग करें।