Plugin Microsoft Foundry

Bổ sung hỗ trợ nhà cung cấp mô hình Microsoft Foundry cho OpenClaw.

Phân phối

• Gói: @openclaw/microsoft-foundry
• Phương thức cài đặt: được tích hợp trong OpenClaw

Bề mặt

nhà cung cấp: microsoft-foundry; hợp đồng: imageGenerationProviders

• Nhà cung cấp tạo hình ảnh: microsoft-foundry

Yêu cầu

• Một tài nguyên Microsoft Foundry hoặc Azure AI Foundry có các bản triển khai.
• Xác thực bằng khóa API thông qua AZURE_OPENAI_API_KEY hoặc khóa API đã cấu hình cho nhà cung cấp.
• Để xác thực bằng Entra ID, hãy cài đặt Azure CLI và chạy az login trước khi thiết lập ban đầu. OpenClaw làm mới token thời gian chạy Microsoft Foundry thông qua az account get-access-token.

Mô hình trò chuyện

Các bản triển khai trò chuyện Microsoft Foundry sử dụng tham chiếu mô hình của nhà cung cấp microsoft-foundry/<deployment-name>. Quá trình thiết lập ban đầu phát hiện các tài nguyên và bản triển khai Foundry bằng Azure CLI, sau đó ghi tên bản triển khai đã chọn vào cấu hình mô hình.

OpenClaw sử dụng điểm cuối Foundry /openai/v1 cho các API trò chuyện tương thích với OpenAI được hỗ trợ:

• Các họ mô hình GPT, o*, computer-use-preview và DeepSeek-V4 mặc định sử dụng openai-responses.
• MAI-DS-R1 và các bản triển khai hoàn tất trò chuyện khác sử dụng openai-completions trừ khi một API được hỗ trợ được cấu hình rõ ràng.
• MAI-DS-R1 được ghi nhận là có khả năng suy luận thông qua nội dung suy luận, không phải thông qua reasoning_effort. Siêu dữ liệu về token ngữ cảnh và đầu ra của mô hình này là 163.840 token.

Các bản triển khai Anthropic Claude trong Microsoft Foundry sử dụng định dạng API Anthropic Messages, không phải định dạng tương thích với OpenAI /openai/v1. Hãy cấu hình chúng dưới dạng nhà cung cấp anthropic-messages tùy chỉnh cho đến khi Plugin Microsoft Foundry có thời gian chạy Anthropic nguyên bản. Khi tên bản triển khai Foundry khác với ID mô hình Claude, hãy đặt params.canonicalModelId trong mục nhập mô hình để OpenClaw có thể áp dụng các hợp đồng truyền dẫn dành riêng cho mô hình, ánh xạ chính xác /think off và bảo toàn nội dung suy nghĩ đã ký một cách an toàn.

Tạo hình ảnh bằng MAI

Plugin đăng ký microsoft-foundry cho image_generate với các mô hình hình ảnh Microsoft AI hiện tại:

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

Sử dụng tên bản triển khai hình ảnh MAI đã triển khai làm tham chiếu mô hình. Nhà cung cấp không khai báo mô hình hình ảnh mặc định vì API MAI yêu cầu tên bản triển khai của bạn trong trường model của yêu cầu:

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

Quá trình tạo chỉ bằng câu lệnh gọi điểm cuối tạo hình ảnh MAI của Microsoft Foundry: /mai/v1/images/generations. Các thao tác chỉnh sửa bằng hình ảnh tham chiếu gọi /mai/v1/images/edits và chỉ hỗ trợ các bản triển khai MAI-Image-2.5-Flash và MAI-Image-2.5.

Quá trình tạo chỉ bằng câu lệnh có thể sử dụng tên bản triển khai tùy chỉnh khi chỉ cần cấu hình điểm cuối Foundry. Đối với chỉnh sửa hình ảnh bằng tên bản triển khai tùy chỉnh, hãy chọn bản triển khai trong quá trình thiết lập ban đầu hoặc thêm siêu dữ liệu mô hình để OpenClaw có thể xác minh rằng bản triển khai được hỗ trợ bởi MAI-Image-2.5-Flash hoặc MAI-Image-2.5.

Các ràng buộc về hình ảnh MAI:

• Đầu ra: một hình ảnh PNG cho mỗi yêu cầu.
• Kích thước: mặc định là 1024x1024; cả chiều rộng và chiều cao phải ít nhất là 768 px.
• Tổng số pixel: chiều rộng × chiều cao không được vượt quá 1.048.576.
• Chỉnh sửa: một hình ảnh đầu vào PNG hoặc JPEG.
• Các gợi ý dùng chung không được hỗ trợ như aspectRatio, resolution, quality, background và outputFormat không phải PNG sẽ không được gửi tới Microsoft Foundry.

Khắc phục sự cố

• az: command not found: cài đặt Azure CLI hoặc sử dụng xác thực bằng khóa API.
• Microsoft Foundry endpoint missing for MAI image generation: chọn một bản triển khai Foundry trong quá trình thiết lập ban đầu hoặc thêm models.providers.microsoft-foundry.baseUrl.
• supports MAI image deployments only: mô hình hình ảnh đã chọn trỏ đến một bản triển khai không phải MAI. Hãy sử dụng mô hình hình ảnh MAI đã triển khai cho image_generate.