YandexGPT подключается к Excel тремя способами: через готовую надстройку с формулой без кода, через Power Query с обращением к эндпоинту модели, или через VBA-макрос с HTTP-запросом — рабочий способ зависит от того, разовая это задача или регулярный процесс на сотнях строк.
Три способа подключения
YandexGPT подключается к Excel за 15–20 минут через готовую надстройку без кода, а для регулярной обработки таблиц глубже заходят через Power Query или VBA, по нашему опыту внедрений.
Все три способа обращаются к одному и тому же API Foundation Models в Яндекс Облаке. Разница только в интерфейсе: где-то это формула в ячейке, где-то — шаг в запросе Power Query, где-то — кнопка с макросом на листе.
- Готовая надстройка — формула вроде =YANDEXGPT(A2;"промпт") прямо в ячейке, минимум настройки
- Power Query — запрос идёт построчно ко всей таблице, годится для массовой классификации и очистки
- VBA-макрос — кнопка на листе, удобно встроить в уже готовый рабочий файл с другими макросами
Перед любым из трёх способов нужен API-ключ и идентификатор каталога в Яндекс Облаке — оформляются в личном кабинете за пару минут. Что за модель стоит за этим API — коротко в термине YandexGPT.
Типовые задачи, которые компании поручают модели прямо из таблицы: категоризация строк по клиентам или товарным группам, короткое описание товара по паре характеристик, вытяжка тональности из отзыва, нормализация написания адресов и названий компаний перед выгрузкой в другую систему.
Через готовую надстройку
Надстройка ставится из магазина дополнений Excel и добавляет собственную функцию, которая принимает ячейку с текстом и текст промпта, а возвращает ответ модели прямо в соседнюю ячейку — работает как обычная формула, включая протягивание вниз по столбцу.
- Установите надстройку из магазина дополнений Excel и авторизуйтесь ключом API
- Введите формулу вида =YANDEXGPT(диапазон; "текст промпта") в первую ячейку столбца
- Протяните формулу вниз на нужное число строк
- Проверьте первые 10 ответов вручную перед тем, как считать результат готовым
Плюс — ноль кода. Минус — при большом числе строк формула пересчитывается медленно, а лимит запросов в минуту на бесплатном тарифе быстро упирается в потолок. Для генерации коротких описаний товаров по характеристикам этот способ обычно достаточен целиком, разбор конкретно такой задачи — в статье про генерацию описаний товаров через YandexGPT.
Пример готового промпта прямо в формуле: =YANDEXGPT(A2; "Ты копирайтер, опиши товар из ячейки в 2 предложения для карточки маркетплейса, без канцелярита"). На тестовом прогоне из 100 строк товаров средней категории такая формула отрабатывает за 3–4 минуты на бесплатном лимите запросов в минуту, по нашему опыту внедрений, — дальше упирается в паузу между пакетами. Часть надстроек из магазина дополнений сама разбивает большой диапазон на очереди и ждёт освобождения лимита, часть — просто возвращает ошибку в ячейке, и тогда протяжку стоит повторить вручную для незаполненных строк.
Через Power Query
Power Query обращается к API через шаг «Веб-содержимое» с M-кодом — запрос уходит на каждую строку таблицы отдельно, а результат разворачивается обратно в столбец. Способ удобен, когда задача повторяется регулярно: обновил исходные данные — обновил запрос одной кнопкой.
Функция строится один раз как параметр с текстом строки на входе, а дальше применяется ко всему столбцу через «Добавить столбец из примеров» или прямое обращение к функции. На таблице в несколько тысяч строк запрос стоит разбивать на пакеты по 200–300 строк, по нашему опыту внедрений, — так проще отследить, где именно упал запрос при сбое.
Полезная практика — держать рядом тестовый лист на 20 строк с заранее известным правильным ответом. После любой правки промпта прогоняете тестовый лист заново и сверяете результат — так расхождение видно сразу, задолго до боевых данных.
| Способ | Когда применять | Порог входа |
|---|---|---|
| Надстройка | Разовая задача, до пары сотен строк | Низкий, формула как обычная |
| Power Query | Регулярный отчёт, обновление по кнопке | Средний, нужен M-код один раз |
| VBA-макрос | Встроить в существующий рабочий файл | Средний-высокий, нужен код на VBA |
Какую задачу в таблицах хотите поручить нейросети?
Через VBA-макрос
VBA-макрос собирается на объекте MSXML2.XMLHTTP: формирует запрос с телом в формате JSON, отправляет его на эндпоинт модели и записывает ответ обратно в ячейку. Такой способ удобен, если в файле уже есть кнопки и другие макросы — YandexGPT встраивается тем же стилем.
- Храните API-ключ в отдельном скрытом листе — держать его прямо в коде макроса рискованно
- Добавьте обработку ошибок — таймаут или лимит запросов случаются регулярно
- Ведите счётчик отправленных запросов — так проще держаться в границах дневного лимита токенов
- Проверяйте формат ответа перед тем, как использовать его дальше в расчётах
Таймаут стоит ставить с запасом в 15–20 секунд на запрос, по практике настройки таких макросов: модель иногда отвечает дольше на длинном тексте, а стандартный таймаут MSXML2.XMLHTTP короче. Отдельным блоком макроса удобно логировать неудачные строки в соседний столбец — так пакет проще перезапустить только по ним, без повтора уже готовых ответов.
Похожий подход с формулой запроса к модели разобран для Google Таблиц в статье про промпт для формул в Гугл Таблицах, а посчитать реальную стоимость запросов поможет статья про стоимость запросов YandexGPT API.
Частые ошибки
- API-ключ лежит открытым текстом в общем файле — доступен всем, кто открыл таблицу
- Ответ модели используется в расчётах без проверки формата — одна лишняя запятая ломает формулу
- Лимит запросов в минуту игнорируется — часть строк остаётся без ответа молча
- Задача на 5000 строк запускается формулой в ячейках без Power Query — файл зависает на пересчёте
Тестируйте промпт на 10 строках через надстройку — только когда формулировка стабильно даёт нужный формат, переносите задачу в Power Query или VBA для всего объёма.
Обычная ошибка на старте — сразу проектировать сложный сценарий с несколькими шагами обработки на тысячах строк. Практичнее собрать самый простой вариант на малом объёме, убедиться, что ответы модели стабильны по формату, и только потом масштабировать сценарий и добавлять пакетную обработку с логированием ошибок.
Более широкий разбор задач, которые нейросеть решает прямо в таблицах, — в статье про ии для таблиц. Для регулярной автоматизации процесса вокруг таблицы целиком, где формула — лишь один из шагов, смотрите раздел про автоматизацию бизнес-процессов.