В этом материале
Где: Настройки → Контент и публикации → Ваши аккаунты AI
Откройте эту страницу: admin.<your-site>/settings/ai/providers (замените <your-site> адресом вашего сайта)
Перед началом
- Аккаунт Azure с созданным ресурсом Azure OpenAI.
- Как минимум одна модель, развернутая в этом ресурсе. Azure запускает модель только после создания развертывания.
- Доступ на чтение ключей ресурса в Azure.
- Подключить могут только пользователи с правами на управление AI, которые недавно выполнили вход.
Инструкция
- Откройте портал Azure и перейдите в свой ресурс Azure OpenAI.
- Откройте раздел Resource Management, затем пункт Keys and Endpoint.
- Скопируйте Endpoint. Он выглядит примерно как
https://my-resource.openai.azure.comи обязательно заканчивается на.openai.azure.comили.cognitiveservices.azure.com. - Скопируйте KEY 1. Ключ KEY 2 держите в качестве резервного. Панель управления принимает ключ длиной 32 символа (буквы a–f и цифры) или 84 символа.
- Найдите названия ваших развертываний. На портале Azure AI Foundry откройте раздел ресурса Deployments. Имя развертывания — это то, что вы указали при создании модели. Оно может отличаться от базового названия модели, например
gpt-4o-mini. - В панели управления сайтом откройте Настройки → Контент и публикации → Ваши аккаунты ИИ и найдите карточку Azure OpenAI.
- Вставьте Endpoint в Azure. Добавьте каждое развертывание в поле Имена развертываний, нажимая Добавить после каждого. Добавьте хотя бы одно.
- Вставьте ключ и нажмите Проверить и подключить. Появится «Проверяем ключ…», а затем Подключено ✓.
Полезно знать
- Можно подключить до двух ресурсов Azure.
- В Azure нет списка моделей по ключу, поэтому в панели будут видны только указанные вами развертывания. Добавляйте новые по мере их создания в Azure.
- Цены указывать не обязательно. С ними система сможет рассчитывать расходы. Без цен AI не переключится на этот аккаунт автоматически, если другой даст сбой.
- Счета выставляет сам Azure. Расходы и лимиты можно отслеживать на портале Azure. Бюджет и лимиты AI
- Ключ хранится только на вашем собственном сервере. Keynate его не видит.
Частые проблемы
Используйте ваш собственный endpoint Azure OpenAI
Endpoint должен заканчиваться на .openai.azure.com или .cognitiveservices.azure.com. Скопируйте его из раздела Keys and Endpoint. Свой домен или IP-адрес работать не будут.
Эта модель или развертывание недоступны в вашем аккаунте Azure OpenAI
Имя развертывания указано неверно. Названия должны совпадать в точности, включая заглавные буквы. Проверьте раздел Deployments в Foundry, исправьте имя в карточке и повторите проверку.
Azure OpenAI отклонил этот ключ
Скопируйте ключ заново целиком. Ключи привязаны к конкретному ресурсу, поэтому берите ключ от того же ресурса, чей endpoint вы указали.
Не удалось подключиться к этому адресу
Проверьте, нет ли опечаток в endpoint. Если для ресурса ограничены сети, проверка может завершиться ошибкой. Разрешите публичный доступ к ресурсу или добавьте адрес вашего сервера, после чего попробуйте снова.
Azure сообщает, что квота или лимит запросов исчерпаны
Подождите минуту или увеличьте лимит квот для этого развертывания в Azure.
Вопросы
Часто задаваемые вопросы
Какой ключ использовать: KEY 1 или KEY 2?
Подойдет любой. Используйте KEY 1. Если вы обновите ключи в Azure, сохраните новый ключ через Заменить ключ.
Зачем вручную вводить названия развертываний?
В Azure имена развертываниям вы придумываете сами. Панель управления сайтом не может определить их автоматически, поэтому их нужно указать.