Как подключить YandexGPT к агенту
Начинают с Yandex Cloud. Создайте сервисный аккаунт и выдайте ему роль ai.languageModels.user, затем выпустите для него API-ключ и запишите ID каталога.
OpenAI-совместимый режим Yandex AI Studio принимает базовый адрес https://llm.api.cloud.yandex.net/v1. Модель указывают полным URI вида gpt://<идентификатор каталога>/yandexgpt-5.1. Для Completions API документация перечисляет параметры temperature, max_tokens, stream и response_format.
В OpenCode Яндекса нет в списке готовых провайдеров, поэтому его описывают в opencode.json вручную. Блок провайдера содержит пакет @ai-sdk/openai-compatible, options.baseURL с адресом выше и модель в разделе models. В Cline выбирают провайдера OpenAI Compatible и заполняют поля Base URL, API Key и Model ID.
Кодовому агенту нужен вызов инструментов. Прежде чем отдавать YandexGPT большую задачу, проверьте связку на коротком задании с правкой одного файла.
Что дают инструменты каталога с YandexGPT
Почти везде YandexGPT стоит рядом с другими провайдерами. Сервер yandexgpt-server автор minakovai выложил в двух коллекциях, а еще один сервер для модели входит в YaAll.
- Дают агенту YandexGPT как инструмент. Yandex MCP Servers включает текстовое завершение и чат, а рядом лежат серверы для Vision и SpeechKit.
- Собирают сервисы Яндекса в одном месте. YaAll публикует десять серверов в npm, среди них YandexGPT, Директ и Wordstat.
- Переключаются между GigaChat и YandexGPT при ошибке или лимите 429. MCP Gateway перед отправкой маскирует телефоны, ИНН, паспорта и СНИЛС.
- Встраивают модель в 1С. ИИкона ставится в конфигурацию на платформе 8.3.24 и БСП 3.1.10 или новее и дает общий интерфейс к YandexGPT, GigaChat, OpenAI, Anthropic и Gemini.
- Учат агента работать с SDK для Laravel. Скилл Yandex AI Studio для Laravel разбирает авторизацию заголовком Api-Key и формат URI gpt://.
- Ищут причины промахов кэша промптов. Аудит кэширования промптов держит справочник по YandexGPT среди других провайдеров.
- Отвечают голосом в умном доме. SmartChain ставит YandexGPT за голосового ассистента Home Assistant 2025.7 и новее. Всего провайдеров 11.
GigaChat или YandexGPT
Инструменты из каталога чаще поддерживают обе модели, чем выбирают одну. MCP Gateway берет GigaChat основным провайдером и YandexGPT запасным. ИИкона и SmartChain оставляют выбор вам. Сравнения качества моделей в каталоге нет.
Подключение отличается заметнее. У YandexGPT есть OpenAI-совместимый адрес, и агенты вроде OpenCode берут его напрямую. Для GigaChat скилл из подборки awesome-ru-ai-skills поднимает локальный прокси gpt2giga. Инструменты для второй модели собраны на странице GigaChat. Подобрать инструмент под свой стек поможет Foxx AI.
Ограничения и безопасность
Запросы к Yandex Cloud тарифицируются. Ключи большинства инструментов лежат в .env или конфиге. Держите их вне репозитория, а для агента выпускайте отдельный API-ключ, который легко отозвать без последствий для остальных приложений.
ИИкона открывает рабочую базу 1С внешним агентам по HTTP и отправляет данные облачным провайдерам. Автор проверил вызов инструментов вживую только на OpenAI-совместимых моделях, а MCP-сервер советует публиковать наружу только через HTTPS.
Анонимизатор MCP Gateway построен на эвристиках и регулярных выражениях. Проверьте его на своих данных до боевого запуска.
SmartChain управляет реальными замками, светом и климатом через Assist API. Ему нужен отдельный пользователь Home Assistant с минимумом прав.