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
   Сохраните ключ в свойствах скрипта

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

   js Копировать

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

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

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

   js Копировать

   /**
    * Запрос к модели 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-chat',
         messages: [{ role: 'user', content: prompt }],
       }),
     });
     var data = JSON.parse(res.getContentText());
     return data.choices[0].message.content;
   }

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

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

   text Копировать

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

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

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

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