Управление Кодированием
С помощью функции Кодирование администраторы могут создавать управляемые ключи API для инструментов программирования, таких как Aider и OpenCode. Пользователи работают не со своим ключом OpenAI, а с ключом, управляемым AI-School.
Это делает Кодирование подходящим для уроков программирования, проектов и продвинутых пользователей, которые хотят использовать помощь ИИ в локальной среде разработки.
Зачем управляемые API-ключи?
Обычный API-ключ часто предоставляет широкий доступ к внешней AI-платформе. В Кодировании все обращения проходят через AI-School. Таким образом управление, расходы и отчетность остаются за школой.
Ключевые преимущества:
- Контроль расходов: устанавливайте бюджет на каждый ключ.
- Отслеживаемое использование: расход, стоимость и чаты привязаны к пользователю.
- Централизованное управление: создавайте, ограничивайте и отзывайте ключи из административной панели.
- Подходит для классов: можно за один раз создать ключи для группы учащихся.
Включение Кодирования
Кодирование активируется на уровне окружения. Это может сделать администратор управления.
- Перейдите в раздел Администрирование → Кодирование.
- Нажмите Включить кодирование.
- Прочитайте предупреждение об абонентских и API-расходах.
- Нажмите Согласен и включить.
После включения AI-School обрабатывает техническое соединение в фоновом режиме. Администраторам не требуется управлять внешними настройками проекта.
К Кодированию могут применяться дополнительные абонентские сборы. Расходы по API учитываются с наценкой. При возникновении вопросов обращайтесь в AI-School.
Предоставление доступа школам
После включения вы определяете, какие школы могут использовать Кодирование.
- Откройте вкладку Администрирование.
- Выберите школы, которым можно задействовать Кодирование.
- Нажмите Сохранить доступ.
Администратор школы видит только те школы, для которых разрешено Кодирование и имеются соответствующие права администратора. Для администратора школы лишние панели управления скрыты.
Выбор моделей
На вкладке Администрирование выбирайте, какие модели OpenAI доступны для Кодирования.
AI-School использует следующие модели:
| Модель | Использование |
|---|---|
| GPT-5.6 Luna | Быстрая и универсальная модель для учащихся и повседневной помощи в программировании |
| GPT-5.6 Terra | Мощная модель для преподавателей, продвинутых учащихся и сложных задач программирования |
| GPT-5.6 Sol | Самая продвинутая модель для требовательной разработки и профессионального использования |
Для учебного использования в классе быстрый и доступный старт обеспечивает GPT-5.6 Luna. Выбирайте Terra или Sol, когда задача требует больше анализа, рассуждений или самостоятельных шагов программирования.
Совместимые инструменты кодирования
Кодирование работает с инструментами, которые могут использовать совместимый с OpenAI Endpoint. Пользователю потребуется три данных:
- API-ключ Кодирования
- URL-эндпойнт Coderen от AI-School:
https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1 - разрешенная модель, например
gpt-5.6-luna
AI-School рекомендует для большинства ситуаций использовать два следующих инструмента:
| Инструмент | Рекомендовано для | Примечание |
|---|---|---|
| Aider | Ученики и классическое кодирование | Является явным инструментом парного программирования в терминале. Менее агентный и поэтому лучше подходит для обучения программированию. |
| OpenCode | Преподаватели и продвинутые учащиеся | Агентно-ориентированный инструмент кодирования для терминала, рабочего стола и IDE. Мощнее, но требует большего опыта. |
Помимо этого есть и другие инструменты кодирования, которые технически могут работать с совместимым с OpenAI Endpoint:
| Инструмент | Тип | Примечание |
|---|---|---|
| Continue | IDE-ассистент для VS Code и JetBrains | Поддерживает конфигурацию OpenAI с пользовательским apiBase. Подходит, если пользователи преимущественно работают в своей IDE. |
| Cline | Расширение VS Code и CLI | Выберите поставщика OpenAI Compatible и укажите базовый URL, API-ключ и модель. Сильный агентный функционал; менее подходит для новичков без наставничества. |
| Roo Code | Расширение VS Code | Может работать с поставщиком, совместимым с OpenAI. Гарантируйте, какие действия выполняет агент. |
| Sourcegraph Cody Enterprise | Корпоративный помощник по кодированию | Особенно актуально для организаций с Sourcegraph Enterprise. Поддерживает конфигурацию модели openaicompatible на уровне организации. |
Инструмент подходит только если у вас есть собственный базовый URL, совместимый с OpenAI. Инструменты, такие как Claude Code и Codex CLI, поэтому не подходят для Кодирования: Claude Code не использует совместимый с OpenAI API, а Codex CLI не предлагает подходящую настройку для конкретной конечной точки Кодирования. Также такие инструменты, как Cursor или Windsurf, годны лишь если используемая версия поддерживает настраиваемый базовый URL совместимый с OpenAI.
Используйте в первую очередь Aider для учащихся. Добавляйте агентные инструменты вроде OpenCode, Cline или Roo Code только после того, как пользователи наберут достаточный опыт в работе в терминале, с git, диффами и локальным управлением файлами.
Отчеты
Вкладка Отчеты показывает использование и расходы за выбранный период. По умолчанию отображаются последние 7 дней.
Отчеты включают:
- общее число запросов
- общая стоимость
- количество токенов
- разбиение по группе
- разбиение по пользователю
Администратор школы видит только отчеты в рамках своей разрешенной области. Администратор совета видит отчетность по всей среде.
Выключение Кодирования
Вы можете временно отключить Кодирование через кнопку на панели инструментов.
Когда Кодирование выключено:
- существующие API-ключи не могут использоваться
- отчеты и исторические данные сохраняются
- Кодирование можно позже снова включить
Выключение не удаляет существующие отчеты.
