AI в Google Таблицах через AI Gateway: функция =AI() на Apps Script

В Google Таблицах можно завести собственную формулу =AI("…"), которая обращается к модели и возвращает ответ прямо в ячейку. Делается это через Apps Script — встроенный скриптовый движок Google. Так удобно массово переводить, классифицировать, суммировать или размечать данные строками таблицы. Модели берём из каталога AI Gateway.

Подготовка

Нужен ключ AI Gateway sk-aigate-… и базовый URL https://ai-gatewey.ru/v1. Ключ храним не в коде, а в свойствах скрипта (Script Properties) — они не видны тем, у кого есть доступ только к таблице.

Реализация

1. 1
   Откройте редактор Apps Script

   В таблице меню Расширения → Apps Script. Откроется редактор, привязанный к этому документу, — весь код ниже вставляем туда.

2. 2
   Сохраните ключ в свойствах скрипта

   Запустите один раз функцию-установщик (или задайте свойство вручную в настройках проекта) — ключ окажется в защищённом хранилище, а не в тексте формулы:

   jsjsКопировать

   function setup() {PropertiesService.getScriptProperties().setProperty('AIGATE_API_KEY', 'sk-aigate-ваш_ключ');}

3. 3
   Функция =AI()

   Пользовательская функция шлёт промпт на AI Gateway через UrlFetchApp и возвращает текст ответа — его можно вызывать как обычную формулу:

   jsjsКопировать

   /*** Запрос к модели AI Gateway.* @param {string} prompt Текст запроса.* @param {string} model  Код модели (необязательно).* @return Ответ модели.* @customfunction*/function AI(prompt, model) {var key = PropertiesService.getScriptProperties().getProperty('AIGATE_API_KEY');var res = UrlFetchApp.fetch('https://ai-gatewey.ru/v1/chat/completions', {method: 'post',contentType: 'application/json',headers: { Authorization: 'Bearer ' + key },payload: JSON.stringify({model: model || 'deepseek/deepseek-v4-flash',messages: [{ role: 'user', content: prompt }],}),});var data = JSON.parse(res.getContentText());return data.choices[0].message.content;}

4. 4
   Используйте формулу в ячейках

   Теперь =AI() работает как встроенная функция и ссылается на другие ячейки — например, перевод из столбца A:

   texttextКопировать

   =AI("Переведи на английский: " & A2)

Какие модели подойдут

Обработка строк таблицы — это множество однотипных запросов, поэтому берут быструю недорогую модель:

Частые вопросы