П ПрактикумBMITECH × МФТИ
Вход по коду

16–30.11.2026 · 2 спринта · 3 команды

Практика: ИИ-ассистенты для NutriChat и Healora

Три команды по три человека собирают рабочий ассистент поверх реальных данных продуктов: ответ с цитатами, навигация по базе знаний, данные → вывод → график.

Задач9в бэклоге
Команд3по три человека
Участников9МФТИ
Прошли опрос0по установке

Анонсы задач

Плашки закрыты до старта: код, команда и вес видны, формулировка откроется в кабинете.

T1

Тема 1

Ответ с цитатами и измеренным качеством

T2

Тема 2

Навигация по базе знаний

T3

Тема 3

Данные → вывод → график

Программа

Два спринта: знакомство и инфраструктура → решение задачи. 30.11 — защита.

СпринтДатыЧто делают командыКонтрольная точка
116–22.11 Знакомятся внутри команды: опыт, навыки, роли. Настраивают инфраструктуру: доступы, ключи, репозиторий, рабочие инструменты. Скрин заполненной доски Miro или ВК с комментариями каждого участника, ТЗ команды, репозиторий, smoke-тест ключа
223–29.11 Решают задачу: каркас, данные, рабочий прототип, метрики качества, отчёт. Демо «вопрос → ответ с источником», отчёт с числами, PR в ветку
Защита30.11 Демонстрация решения по шаблону, запись видео и презентация для итоговой аттестации. Структура из 10 пунктов, порог 5 из 10 баллов

Структура защиты

  1. Проблема и введение: суть задачи и её практический интерес.
  2. Цель: одна чёткая формулировка.
  3. Задачи: 2–3 шага к цели, коротко, глаголами.
  4. Практическая значимость: где и как применить результат.
  5. Ожидаемый эффект: что хотели получить и кому это полезно.
  6. Стек: 2–3 ключевых инструмента или технологии.
  7. Ход работы: основные этапы реализации.
  8. Результаты: таблицы, графики, визуализации.
  9. Выводы: 2–3 ключевых итога.
  10. Перспективы: интеграция проекта или его компонентов.

Ритм

Архитектура: SDD, скиллы и бандлы

Порядок один: описание задачи → умение агента (скилл) → набор умений (бандл) → агент. Сначала фиксируем, что должно получиться, потом собираем умение, потом подключаем его к агенту.

СлойЧто этоАртефакт
Спецификация (SDD)Задача, вход, выход и критерии приёмки. Без такого описания агент сам придумывает объём работы.описание задачи, критерий приёмки, метрика
СкиллОдно умение с инструкцией и скриптами: как проверить, что исправить, чем проверить результат.SKILL.md + scripts/
БандлНабор скиллов под роль или этап, подключается целиком. bundle.json
АгентИсполнитель: читает описания скиллов и вызывает нужный, а не весь код подряд.сессия, контекст, лимит
spec.md ──▶ SKILL.md ──▶ bundle.json ──▶ агент
  │            │              │
  │            │              └── набор под роль: core / design / project
  │            └── front-matter: name, version, inputs, outputs, commands
  └── критерий приёмки: что считается «сделано»

Скилл

Скилл — папка с SKILL.md: шапка (имя, описание, версия, входы и выходы, команды), инструкция и при необходимости скрипты и ассеты. Описание в шапке — это то, что видит агент, когда решает, подключать скилл или нет.

Бандлы

БандлДля чегоЧто внутри
coreПонять, записать, отчитатьсяисследование, документ, разбор кода, обсуждение, отчёт, журнал проекта
designМакеты и прототипыинтерфейсные моки, правила настроек, вектор, 3D
skl_projectПапки и документацияструктура проекта, дистилляты, журналы
skl_collectorСбор данныхпарсинг, скачивание, каталогизация
Зачем это на практике. Каждая задача — спецификация с критерием приёмки. Скилл фиксирует повторяемый шаг, чтобы команда не пересказывала его заново. Бандл задаёт минимальный набор инструментов под роль: меньше контекста — дешевле токены и понятнее проверка.

Чем работать: AI-клиенты

AI-клиенты делятся на три класса: чаты (ChatGPT, Claude Desktop) — хорошо объясняют, но не видят репозиторий; плагины в IDE (Copilot, Continue, Cline) — видят файлы, но ограничены редактором; терминальные агенты — читают проект, запускают команды и правят код. Для задач практики нужен третий класс с возможностью подключить свой провайдер по baseURL: ключи у команды свои, а модель должна работать в репозитории. Отсюда выбор — OpenCode: открытый, ставится локально, работает с Desktop и CLI, понимает любой OpenAI-совместимый ключ, настраивается JSON-конфигом, поддерживает плагины и MCP-серверы.

Решение: OpenCode. Один клиент на команду, один ключ, один конфиг в репозитории. Дальше — установка за шесть шагов.

OpenCode: установка за шесть шагов

Два варианта: короткий путь и настройка для тех, кто уже работал с терминалом.

0 / 6
1

Скачать клиент

opencode.ai → Download for Windows (или macOS / Linux). Два варианта: Desktop — окно с вкладками и диффами, CLI — работа в терминале. Для практики подходит любой.

Сайт opencode.ai: кнопки Download for Windows, Install, Download
Кнопки скачивания: Desktop, Terminal (Install), Mobile

Терминал:

curl -fsSL https://opencode.ai/v2/install | bash
npm install -g @opencode/cli
2

Зарегистрироваться

opencode.ai/console → Get started → вход через GitHub или почту. Аккаунт нужен для ключей OpenCode, подписки Go и истории расходов. Для практики достаточно бесплатного.

Консоль OpenCode: кнопка Get Started и список моделей с ценами
Консоль: регистрация, ключи, модели и цены за миллион токенов
3

Ключи: создать в консоли и добавить в клиент

В консоли: раздел с ключами → Create key → скопировать. Ключ показывается один раз, второй раз посмотреть нельзя — только перевыпустить.

В клиенте ключ добавляется командой /connect (выбрать провайдера, вставить ключ) или из терминала — opencode auth login. После подключения модель выбирается командой /models.

Документация OpenCode: страница Providers с командами /connect и opencode auth login
Документация: /connect в TUI и opencode auth login
Документация OpenCode: пример своего провайдера в opencode.json с baseURL и env
Свой провайдер: baseURL, env, модели

Ключ BMITECH на время практики. Команда получает один ключ и адрес https://<BASE_URL>/v1. Он добавляется как свой провайдер: в opencode.json описывается baseURL и модель, ключ берётся из переменной окружения. Второй путь — /connect → Other → вставить адрес и ключ. Ключ живёт только в .env и в git не попадает.

4

Прочитать про модели и расход токенов

Что почитать до первого большого прогона:

Документация OpenCode: страница Models с выбором модели и стоимостью
Models: выбор модели на сессию, дефолты, варианты, кэш
5

Дисклеймеры

  • Бесплатные модели требуют карту. У большинства провайдеров «free» включается только после привязки банковской карты — проверка платёжеспособности. Карта может не списываться, но без неё модель недоступна.
  • Многие модели и плагины ставятся глобально. Нужны Node.js 20+, права администратора и корректный PATH. Без глобальной установки часть моделей, MCP-серверов и функций не заработает.
  • Ключ — расходуемый ресурс. Лимит у команды один; утечка ключа — чужие траты и блокировка. Ключ не попадает в git, чат, скриншоты и презентацию.
  • Бесплатные модели могут хранить запросы. Часть провайдеров использует переписку для обучения. Персональные данные, медицинские сведения и сырые выгрузки продуктов туда не отправляем.
  • VPN и прокси ломают доступ. Провайдер может блокировать выходные узлы и менять лимиты без предупреждения — на демо держите резервную модель (локальная Ollama).
  • Ответ модели — не факт. Цифры, цитаты и ссылки проверяются по источнику; поэтому в задачах требуется ссылка на файл и строку.
6

Проверить, что всё работает

  1. Клиент установлен. opencode --version печатает номер версии, а не «command not found».
  2. Ключ принят. В клиенте /models показывает модель команды; при выборе нет ошибки авторизации.
  3. Ответ по делу. Запрос «какие файлы в этой папке?» — агент читает репозиторий и перечисляет реальные файлы.
  4. Ключ живой на уровне API. Ответ 200 и JSON с choices:
    curl -s https://<BASE_URL>/v1/chat/completions \
      -H "Authorization: Bearer $BMITEH_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"model":"<MODEL>","messages":[{"role":"user","content":"ping"}]}'
  5. Расход пишется. После запроса в usage.jsonl появилась строка.

Если пункт не проходит — не начинайте задачу: напишите в бот @practicumlab_bot или методисту, приложите текст ошибки.

1

Установка и обновление через пакетный менеджер

CLI ставится глобально, обновляется той же командой. Windows: WSL или Git Bash, нативный PowerShell пакетными менеджерами не поддерживается.

npm install -g @opencode/cli      # или pnpm add -g @opencode/cli
opencode upgrade                  # обновление
opencode --version

Отдельный бинарник — если нет Node.js: архив под платформу со страницы загрузки, распаковать и положить в PATH.

2

Ключи из терминала и проверка авторизации

opencode auth login                       # интерактивный выбор провайдера
opencode auth login bmitech --method key   # сразу ключ, без меню
opencode auth list                        # что подключено

Ключи хранятся в конфиге OpenCode, а не в репозитории. Для CI и скриптов удобнее переменные окружения: BMITEH_API_KEY в .env, файл — в .gitignore.

3

Свой провайдер в opencode.json

Провайдер BMITECH описывается как OpenAI-совместимый. Ключ берётся из окружения, поэтому конфиг можно коммитить.

{
  "$schema": "https://opencode.ai/config.json",
  "providers": {
    "bmitech": {
      "name": "BMITECH",
      "env": ["BMITEH_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": { "baseURL": "https://<BASE_URL>/v1" },
      "models": { "<MODEL>": { "name": "<MODEL>" } }
    }
  }
}
Документация: пример своего провайдера в opencode.json
Поля провайдера: env, package, settings, models
4

Модели, варианты и запуск без TUI

Модель выбирается в сессии или указывается на запуск. Варианты одной модели — это разные режимы (быстрый, глубокий, экономичный).

/models
opencode run --model bmitech/<MODEL> "собери список файлов"
opencode run --print-logs --model bmitech/<MODEL> "ping"   # отладка
5

Экономия токенов

Документация Models: лимиты, стоимость, кэш
Лимиты и стоимость модели — в карточке модели
6

Диагностика

СимптомЧто проверить
Model unavailableID модели и провайдер в /models; ключ в окружении
401 / 403opencode auth list, срок ключа, лимит команды
Пустой ответ--print-logs, доступность baseURL из сети
Долгий стартПрокси, VPN, размер сессии
Расход выше планаКэш промпта, субагенты, дешёвая модель для рутины
opencode auth list
curl -s -o /dev/null -w "%{http_code}\n" https://<BASE_URL>/v1/models

Опросник по установке

Операционная система
Опыт с ИИ-ассистентами
Где запускаете OpenCode
Ключ API на команду

Объявления

  • Защита 30.11

    Демонстрация решения по шаблону: проблема, цель, задачи, значимость, эффект, стек, ход работы, результаты, выводы, перспективы. Запись видео и презентация сохраняются для итоговой аттестации.

    2026-11-16 · Методист
  • OpenCode: установка за шесть шагов

    Скачать, зарегистрироваться, добавить ключ, прочитать про модели, дисклеймеры, проверки — раздел «OpenCode» на этой странице. Ключ команды — у хранителя.

    2026-11-16 · 01.lab
  • Задачи недели — в чат

    Предварительные задачи присылаем в чат с дедлайном (пятница, 10:00). Онлайн-встреча с вопросами — среда. В понедельник — задачи следующего спринта.

    2026-11-16 · BMITECH
  • Спринт 1: знакомство и инфраструктура

    Встречаемся внутри команды: опыт, навыки, роли. Скрин доски Miro или ВК с комментариями каждого — подтверждение встречи. Дальше доступы, ключи, репозиторий и smoke-тест.

    2026-11-16 · Методист