Как агенты работают с нашими программами

Агент — это помощник на основе модели ИИ, встроенный в одну из наших программ или работающий рядом с ними. У каждого агента в каталоге описаны задача (зачем он нужен) и логика (как именно он работает и откуда берёт данные).

Три пути к моделям

1. Шлюз ИИ — единая точка в Финансах, через которую программы обращаются к Claude. Программа не ходит в интернет сама: она отдаёт запрос шлюзу, шлюз добавляет ключи и отправляет его по каналу.

2. Канал в интернет — выход через Кыргызстан (маршрутизатор MikroTik), откуда Claude API доступен без ограничений. Это единственный учтённый выход агентов в интернет; новые каналы заводятся на странице «Подключения».

3. Локальная модель — Ollama с Qwen2.5 на нашем сервере. Работает без интернета, данные не покидают сервер. Подходит для черновиков, пересказов и разбора текста; сложные задачи отдаются Claude.

Правила

• Каждый агент привязывается к подключению из каталога — самодельные выходы в интернет не заводятся.

• Чувствительные данные (пароли, персональные данные) агентам не передаются; для внутренних текстов предпочтительна локальная модель.

• Новый агент сначала заводится в каталоге со статусом «Запланирован», описываются задача и логика, затем включается.

• Если агент перестал отвечать — проверьте статус его подключения на странице «Подключения» и контейнеры в Инфраструктуре → Сервер.

Архив сохраняется в папку AI_Sales/BackUps/ и содержит всю программу, кроме node_modules.

Для «Каждый час» время запуска не учитывается — бэкап создаётся в начале каждого часа.

Полная выгрузка всей истории внутреннего чата (личные и групповые беседы) в архив ZIP: читаемая стенограмма «Переписка.txt» + оригиналы всех переданных файлов, разложенные по папкам бесед. Доступно только Владельцу и Администратору — остальные роли не видят этот раздел и не могут скачивать историю, но переписка всегда сохраняется в базе данных и доступна для поиска на странице «Чат».

Бэкап переписки создаётся каждый день в указанное время — вместе с текстом сохраняются и все вложенные файлы.

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

Программа запущена внутри Docker-контейнера. Обычный перезапуск (кнопка выше) достаточен для правок кода (server.js, db.js, страницы интерфейса) — они подключены как «живые» файлы. Полная пересборка нужна только при изменении package.json или Dockerfile — эквивалент команды docker compose up -d --build в терминале сервера.