Plugin Microsoft Foundry

Додає до OpenClaw підтримку постачальника моделей Microsoft Foundry.

Розповсюдження

• Пакет: @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 використовує кінцеву точку Foundry /openai/v1 для підтримуваних сумісних з OpenAI API чату:

• Сімейства моделей 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 використовують формат API Anthropic Messages, а не сумісний з OpenAI формат /openai/v1. Налаштуйте їх як власного постачальника 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 і відмінний від 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. Використовуйте розгорнуту модель зображень MAI для image_generate.