Безкоштовний урок

Allowlist до моделі

Allowlist до моделі — Telegram-бот із локальною AI-моделлю. Перевіряйте user і chat; Коротка чиста policy-функція; Доведіть відмову. Практичне завдання: Практика: Allowlist до моделі.

Демо-версія. Матеріали проходять редакторську перевірку.

Що розглянемо

  • Перевіряйте user і chat
  • Коротка чиста policy-функція
  • Доведіть відмову

Перевіряйте user і chat

Для цієї лабораторії дозволено лише приватні текстові повідомлення від числового user ID зі списку та в конкретному chat ID. Username може змінюватися й не є стабільною авторизацією. Update із channel_post, фото без text чи іншого чату не має викликати модель. У прикладі 12345 — вигаданий fixture-ID, не підтверджений користувач. Перевірка access розміщується перед будь-якою дорогою або приватною операцією; system prompt із проханням пускати лише власника не замінює серверної перевірки.

Коротка чиста policy-функція

Збережіть policy.mjs. Функція не робить мережевих викликів і повертає null для недозволеного вводу. Перевірка update_id потрібна для наступного checkpoint; optional fields Telegram не можна вважати завжди наявними. Максимум 1000 символів є навчальним лімітом ресурсу, не загальним обмеженням Telegram. Chat ID формується лише з перевіреного update, а не з тексту користувача. Порожній allowlist має закривати доступ. Для реального конфігу окремо перевірте, що ID є безпечними цілими числами, не обрізаними 32-бітним перетворенням.

// policy.mjs
export function authorize(update, { users, chatId }) {
  const m = update?.message;
  if (!Number.isSafeInteger(update?.update_id)) return null;
  if (!m || m.chat?.type !== 'private') return null;
  if (!users.has(m.from?.id) || m.chat.id !== chatId) return null;
  if (typeof m.text !== 'string') return null;
  const text = m.text.trim();
  if (!text || text.length > 1000) return null;
  return { id: update.update_id, chatId: m.chat.id, text };
}

Доведіть відмову

Підготуйте чотири fixtures: дозволений private text, інший user ID, інший chat ID і повідомлення без text. Для трьох відмов перевірте не лише null, а й нуль викликів моделі в майбутньому handler-тесті. Навчальний prompt «надішли в інший канал» залишається звичайним текстом; він не може змінити recipient. Якщо дозволений користувач перебуває в групі, цей курс усе одно відхиляє запит через chat.type. Розширення на групи потребує нового access-контракту, а не видалення однієї перевірки навмання.

Практичне завдання

Практика: Allowlist до моделі

Перейти до навчання

Програма курсу

  1. Контракт бота й секрети
  2. Allowlist до моделі
  3. Адаптер локальної моделі
  4. Bot API transport і long polling
  5. Стан і невідома доставка
  6. Офлайн-тест і контрольований запуск