Повторіть бота самостійно

Відкрийте в Telegram офіційний бот @BotFather (з синьою галочкою) і створіть свого:

повідомлення від BotFather з токеном виду 123456789:AAE….

1. Відкрийте aistudio.google.com/apikey під особистим Gmail.
2. Натисніть Створити ключ APICreate API key і скопіюйте ключ.

рядок із приблизно 39 символів, що починається на AIza.

1. Відкрийте script.google.com → Новий проєктNew project.
2. Клацніть на назву «Проєкт без назви» вгорі й назвіть, наприклад, ШІ-асистент.
3. Видаліть усе з файлу Code.gs і вставте код із сторінки «Код» (кнопка «Копіювати»).
4. Збережіть: Ctrl+S (на Mac — ⌘+S).

файл Code.gs збережено без червоних повідомлень про помилки.

Ключі зберігаємо поза кодом: так код можна показати студентам або викласти на GitHub, і ніхто не отримає доступ до вашого бота.

1. Ліворуч — ⚙ Налаштування проєктуProject Settings.
2. Унизу — Властивості скриптаScript Properties → Додати властивість скриптаAdd script property.
3. Додайте дві властивості й натисніть ЗберегтиSave:

function prop_(name) {
  return PropertiesService
    .getScriptProperties()   // сховище проєкту, не код
    .getProperty(name);
}

у налаштуваннях дві властивості: TELEGRAM_TOKEN і GEMINI_API_KEY.

1. Поверніться до редактора <>. У списку функцій угорі оберіть setup і натисніть ▷ ВиконатиRun.
2. З’явиться вікно Потрібен дозвілAuthorization required → Переглянути дозволиReview permissions → оберіть свій акаунт.
3. Google покаже «Google не перевірив цей додаток» (Google hasn’t verified this app). Це нормально: це ваш власний скрипт. Натисніть ДодатковоAdvanced → Перейти до «ШІ-асистент» (небезпечно)Go to … (unsafe) → ДозволитиAllow.

у журналі виконання внизу — рядок setup() done.

1. РозгорнутиDeploy → Нове розгортанняNew deployment.
2. Біля «Виберіть тип» натисніть ⚙ → ВебдодатокWeb app.
3. Виконувати як: ЯExecute as: Me; Хто має доступ: УсіWho has access: Anyone → РозгорнутиDeploy.
4. Скопіюйте URL вебдодатка (закінчується на /exec) і додайте його у Властивості скрипта як WEB_APP_URL.

якщо відкрити URL у браузері, з’явиться текст ШІ-асистент викладача працює ✔.

1. Оберіть функцію setWebhook → ▷ ВиконатиRun.
2. Напишіть своєму боту /start, потім надішліть будь-який шматок коду.

у журналі — Webhook set ✔, а бот відповідає на /start.

Щоб пристосувати бота під свій предмет, достатньо змінити один фрагмент — системний промпт SYSTEM_PROMPT на початку файлу.

const SYSTEM_PROMPT = [
  'Ти — доброзичливий асистент викладача інформатики…',
  // спробуйте, наприклад:
  // 'Ти — асистент викладача історії. Пояснюй події через',
  // 'причини й наслідки і став одне запитання для самоперевірки.',
].join(' ');

Після змін: РозгорнутиDeploy → Керувати розгортаннямиManage deployments → ✎ → Версія: Нова версіяVersion: New version → РозгорнутиDeploy. Адреса вебдодатка лишиться тією самою.

бот відповідає в новому стилі.

Бот відповідає про ваш курс за Таблицею «ШІ-асистент — база знань і розклад», яку створив setup() на вашому Google Диску. Код і розгортання більше не чіпаєте — лише Таблицю.

1. Відкрийте Таблицю: посилання є в журналі виконання setup() або знайдіть її на Google Диску.
2. Аркуш База знань: один рядок — одна тема. Ліворуч Тема, праворуч Інформація: дедлайни, оцінювання, перездачі, матеріали, відповіді на часті питання.
3. Аркуш Розклад: ваш розклад — бот покаже його за командою /rozklad.
4. Зміни бот підхоплює сам приблизно за 5 хвилин.

на питання «Коли дедлайн ЛР3?» бот відповідає за вашою Таблицею, а після зміни рядка — через кілька хвилин уже по-новому.

Якщо щось не так

Першим ділом запустіть функцію getWebhookInfo: у полі last_error_message Telegram пише, що саме пішло не так.

Шпаргалка