AI-платформа Energoskan

<div class="materials-page">

<div class="page-meta">
ENERGOSKAN DEVELOPMENT PORTAL · AI
</div>

<h1>AI-платформа Energoskan</h1>

<p>
Раздел описывает AI-инфраструктуру Energoskan Development Portal:
подключение нейросетей, работу Claude Code и расширений VS Code,
пользовательский чат, управление провайдерами, моделями, доступами,
AI-агентами и RAG.
</p>

<hr>

<h2>1. Текущее состояние</h2>

<p>
В Portal 2.0 основным инструментом программирования является
<b>Claude Code</b>, работающий внутри облачного VS Code пользователя.
</p>

<pre>
Пользователь
      │
      ▼
Облачный VS Code
      │
      ▼
Claude Code
      │
      ▼
anthropic-shim
      │
      ▼
Настроенный AI-провайдер
</pre>

<p>
Компонент <code>anthropic-shim</code> сохраняется в Portal 2.0.
Он принимает запросы Claude Code в формате Anthropic API и передаёт их
подключённому AI-провайдеру в соответствии с серверной конфигурацией.
</p>

<p>
Обычный пользователь не настраивает shim и не получает доступ к API-ключам.
Подключение и изменение провайдера выполняет администратор портала.
</p>

<hr>

<h2>2. Основные направления</h2>

<ul>
<li><b>AI-провайдеры</b> — внешние сервисы и API нейросетей.</li>
<li><b>Модели</b> — доступные модели внутри каждого провайдера.</li>
<li><b>Claude Code</b> — основной AI-инструмент программирования.</li>
<li><b>Расширения VS Code</b> — Cline и другие совместимые клиенты.</li>
<li><b>Пользовательский чат</b> — единый чат внутри портала.</li>
<li><b>AI-агенты</b> — специализированные помощники по отдельным профилям.</li>
<li><b>RAG</b> — использование материалов Базы знаний и Документации.</li>
<li><b>Skills</b> — инструкции и профессиональные навыки агентов.</li>
<li><b>Безопасность</b> — ключи, права, ограничения и аудит.</li>
<li><b>Мониторинг</b> — ошибки, доступность, лимиты и стоимость запросов.</li>
</ul>

<hr>

<h2>3. Пользовательские сценарии</h2>

<h3>Работа в Claude Code</h3>

<p>
Пользователь открывает проект в облачном VS Code и работает через Claude Code.
Маршрут запроса и подключённый провайдер определяются сервером.
</p>

<h3>Работа через Cline</h3>

<p>
Cline устанавливается в облачный VS Code и подключается к совместимому API.
Для него может использоваться прямое подключение к провайдеру либо отдельный
серверный шлюз. Использование <code>anthropic-shim</code> для Cline
не является обязательным.
</p>

<h3>Работа в чате портала</h3>

<p>
Для пользовательского чата потребуется отдельная серверная логика:
интерфейс чата, передача запросов, хранение контекста, контроль доступа,
выбор провайдера и получение потокового ответа.
</p>

<p>
Одной установки расширения VS Code для работы встроенного чата недостаточно.
</p>

<hr>

<h2>4. Целевая схема</h2>

<pre>
                         ┌── Claude Code ── anthropic-shim ──┐
Пользователь ────────────┤                                  │
                         ├── Cline / VS Code ────────────────┤
                         │                                  ▼
                         └── Чат портала ────────────── AI Manager
                                                            │
                                      ┌─────────────────────┼─────────────────────┐
                                      ▼                     ▼                     ▼
                                   Claude                  Kimi                 Другие
</pre>

<p>
В целевой архитектуре разные пользовательские инструменты могут использовать
разные способы подключения, но управление доступными провайдерами выполняется
централизованно.
</p>

<hr>

<h2>5. Выбор нейросети пользователем</h2>

<p>
В пользовательском интерфейсе планируется выбирать
<b>нейросеть или провайдера</b>, а не конкретную техническую модель.
</p>

<p>Например:</p>

<ul>
<li>Claude;</li>
<li>Kimi;</li>
<li>другой разрешённый администратором провайдер.</li>
</ul>

<p>
Конкретные модели, адреса API, ключи, лимиты и резервные варианты
не должны отображаться обычному пользователю.
</p>

<hr>

<h2>6. Управление через Администрирование</h2>

<p>
Для AI будет создан отдельный административный интерфейс.
Он должен позволять:
</p>

<ul>
<li>подключать нового AI-провайдера;</li>
<li>хранить адрес API и защищённые учётные данные;</li>
<li>включать и отключать провайдеров;</li>
<li>назначать доступные модели;</li>
<li>выбирать основной и резервный провайдер;</li>
<li>определять доступ пользователей и проектов;</li>
<li>контролировать лимиты и расходы;</li>
<li>просматривать состояние подключений и ошибки;</li>
<li>переключать провайдера без изменения пользовательского интерфейса.</li>
</ul>

<hr>

<h2>7. AI-агенты и RAG</h2>

<p>
К одному проекту в дальнейшем может быть подключено несколько AI-агентов.
Каждый агент получает собственную роль, инструкции, Skills и разрешённые
источники информации.
</p>

<p>Примеры агентов:</p>

<ul>
<li>технический копирайтер;</li>
<li>SMM-специалист;</li>
<li>разработчик;</li>
<li>аналитик;</li>
<li>специалист технической поддержки.</li>
</ul>

<p>
RAG позволит агентам использовать материалы из Базы знаний,
Документации и проектных источников без включения всей информации
непосредственно в системный промпт.
</p>

<hr>

<h2>8. Безопасность</h2>

<ul>
<li>API-ключи хранятся только на сервере.</li>
<li>Ключи не передаются в браузер пользователя.</li>
<li>Пользователь видит только разрешённые ему нейросети.</li>
<li>Доступ может ограничиваться по пользователям и проектам.</li>
<li>Запросы и ошибки должны журналироваться без раскрытия секретов.</li>
<li>Для каждого провайдера предусматриваются отдельные настройки и лимиты.</li>
</ul>

<hr>

<h2>9. Этапы реализации</h2>

<h3>Portal 2.0 — текущий этап</h3>

<ul>
<li>сохранение рабочего Claude Code;</li>
<li>сохранение <code>anthropic-shim</code>;</li>
<li>наполнение технической документации;</li>
<li>описание текущей AI-инфраструктуры;</li>
<li>подготовка структуры для дальнейшего расширения.</li>
</ul>

<h3>Следующий этап</h3>

<ul>
<li>подключение дополнительных провайдеров;</li>
<li>проверка Cline в облачном VS Code;</li>
<li>создание пользовательского чата;</li>
<li>создание административной страницы AI;</li>
<li>управление провайдерами и моделями.</li>
</ul>

<h3>Portal 3.0</h3>

<ul>
<li>единый AI Manager;</li>
<li>маршрутизация запросов;</li>
<li>резервирование провайдеров;</li>
<li>RAG и AI-агенты;</li>
<li>Skills и проектный контекст;</li>
<li>централизованный мониторинг и учёт стоимости.</li>
</ul>

<hr>

<h2>10. Основной принцип</h2>

<p>
Пользователь должен работать с нейросетью через понятный интерфейс,
не занимаясь настройкой API, shim, моделей и сетевых маршрутов.
Вся техническая конфигурация управляется администраторами Energoskan
Development Portal.
</p>

</div>

<hr>

<h2>Основные направления</h2>

<p>
Ниже приведены основные направления развития AI-платформы Energoskan.
В дальнейшем каждое из них будет подробно описано в отдельных разделах документации.
</p>

<h3>AI-провайдеры</h3>

<p>
Подключение, настройка и управление внешними сервисами искусственного интеллекта
(Claude, Kimi, OpenAI, Gemini, DeepSeek и другими), включая хранение параметров
подключения, переключение между провайдерами и контроль их доступности.
</p>

<h3>AI-модели</h3>

<p>
Управление моделями, доступными у каждого провайдера, выбор модели по умолчанию,
настройка доступности моделей для пользователей, проектов и AI-агентов.
</p>

<h3>Claude Code</h3>

<p>
Основной инструмент разработки в Energoskan Development Portal 2.0,
использующий anthropic-shim для взаимодействия с AI-провайдером.
</p>

<h3>Расширения VS Code</h3>

<p>
Поддержка Cline и других совместимых расширений VS Code для работы
с различными AI-провайдерами непосредственно из среды разработки.
</p>

<h3>Пользовательский чат</h3>

<p>
Единый интерфейс общения с искусственным интеллектом внутри портала
с возможностью выбора доступной пользователю нейросети.
</p>

<h3>AI-агенты</h3>

<p>
Специализированные интеллектуальные помощники,
выполняющие отдельные профессиональные задачи
и использующие собственные инструкции, контекст и Skills.
</p>

<h3>RAG</h3>

<p>
Использование Базы знаний, Документации и проектных материалов
в качестве источников информации для AI и AI-агентов.
</p>

<h3>Skills</h3>

<p>
Библиотека инструкций, методик и профессиональных знаний,
используемых AI-агентами при выполнении специализированных задач.
</p>

<h3>Безопасность</h3>

<p>
Управление правами доступа, безопасное хранение API-ключей,
защита данных пользователей и контроль использования AI-сервисов.
</p>

<h3>Мониторинг</h3>

<p>
Контроль состояния AI-провайдеров, журналирование запросов,
анализ ошибок, использование ресурсов, статистика и контроль затрат.
</p>