Plugin Microsoft Foundry

เพิ่มการรองรับผู้ให้บริการโมเดล Microsoft Foundry ให้กับ OpenClaw

การเผยแพร่

• แพ็กเกจ: @openclaw/microsoft-foundry
• ช่องทางการติดตั้ง: รวมอยู่ใน OpenClaw

พื้นผิว

ผู้ให้บริการ: microsoft-foundry; สัญญา: imageGenerationProviders

• ผู้ให้บริการสร้างรูปภาพ: microsoft-foundry

ข้อกำหนด

• ทรัพยากร Microsoft Foundry หรือ Azure AI Foundry ที่มีการปรับใช้
• การยืนยันตัวตนด้วยคีย์ API ผ่าน AZURE_OPENAI_API_KEY หรือคีย์ API ของผู้ให้บริการที่กำหนดค่าไว้
• สำหรับการยืนยันตัวตนด้วย Entra ID ให้ติดตั้ง Azure CLI และเรียกใช้ az login ก่อน เริ่มต้นใช้งาน OpenClaw จะรีเฟรชโทเค็นรันไทม์ของ Microsoft Foundry ผ่าน az account get-access-token

โมเดลแชต

การปรับใช้แชตของ Microsoft Foundry ใช้การอ้างอิงโมเดลของผู้ให้บริการ microsoft-foundry/<deployment-name> ขั้นตอนเริ่มต้นใช้งานจะค้นหาทรัพยากร และการปรับใช้ของ Foundry ด้วย Azure CLI จากนั้นเขียนชื่อการปรับใช้ที่เลือกลงใน การกำหนดค่าโมเดล

OpenClaw ใช้ปลายทาง /openai/v1 ของ Foundry สำหรับ API แชตที่เข้ากันได้กับ OpenAI และรองรับ:

• ตระกูลโมเดล GPT, o*, computer-use-preview และ DeepSeek-V4 จะใช้ openai-responses เป็นค่าเริ่มต้น
• การปรับใช้ MAI-DS-R1 และการปรับใช้การเติมข้อความแชตอื่น ๆ ใช้ openai-completions เว้นแต่จะกำหนดค่า API ที่รองรับไว้อย่างชัดเจน
• MAI-DS-R1 ถูกบันทึกว่ารองรับการให้เหตุผลผ่านเนื้อหาการให้เหตุผล ไม่ใช่ ผ่าน reasoning_effort เมทาดาทาโทเค็นบริบทและเอาต์พุตของโมเดลคือ 163,840 โทเค็น

การปรับใช้ Anthropic Claude ใน Microsoft Foundry ใช้รูปแบบ Anthropic Messages API ไม่ใช่รูปแบบ /openai/v1 ที่เข้ากันได้กับ OpenAI ให้กำหนดค่าเป็นผู้ให้บริการ anthropic-messages แบบกำหนดเองจนกว่า Plugin Microsoft Foundry จะมีรันไทม์ Anthropic แบบเนทีฟ เมื่อชื่อการปรับใช้ของ Foundry แตกต่างจากรหัสโมเดล Claude ให้ตั้งค่า params.canonicalModelId ในรายการโมเดล เพื่อให้ OpenClaw สามารถใช้สัญญาการรับส่งข้อมูลเฉพาะโมเดล จับคู่ /think off ได้อย่างถูกต้อง และ รักษาการคิดที่มีลายเซ็นไว้อย่างปลอดภัย

การสร้างรูปภาพด้วย MAI

Plugin จะลงทะเบียน microsoft-foundry สำหรับ image_generate ด้วยโมเดลรูปภาพ Microsoft AI ปัจจุบัน:

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

ใช้ชื่อการปรับใช้รูปภาพ MAI ที่ปรับใช้แล้วเป็นการอ้างอิงโมเดล ผู้ให้บริการ ไม่ได้ประกาศโมเดลรูปภาพเริ่มต้น เนื่องจาก API ของ MAI ต้องการชื่อการปรับใช้ของคุณ ในฟิลด์ model ของคำขอ:

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

การสร้างจากพรอมต์เพียงอย่างเดียวจะเรียกปลายทางการสร้างของ MAI ใน Microsoft Foundry: /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 พิกเซล
• จำนวนพิกเซลทั้งหมด: ความกว้าง × ความสูงต้องไม่เกิน 1,048,576
• การแก้ไข: รูปภาพอินพุต PNG หรือ JPEG หนึ่งรูป
• ระบบจะไม่ส่งคำแนะนำร่วมที่ไม่รองรับ เช่น aspectRatio, resolution, quality, background และ outputFormat ที่ไม่ใช่ PNG ไปยัง 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 ให้ใช้โมเดลรูปภาพ MAI ที่ปรับใช้แล้วสำหรับ image_generate