Что умеет
KariAdel CTRL

ПЕРВЫЙ ЗАПУСК

От установки до первого результата

1. Установите и откройте Кариадель

   Перейдите на страницу скачивания и установите KariAdel CTRL из Microsoft Store. Откройте программу; её значок находится в трее возле часов. Для версии из Store обновления устанавливаются через магазин.

2. Выберите способ подключения

   Для ChatGPT следуйте действию подключения в программе и инструкции ChatGPT на Windows. Публичный MCP-адрес: https://mcp.kariadel.ru/mcp, авторизация OAuth. Для Codex используйте отдельную инструкцию MCP.

   При ручном подключении в ChatGPT: Plugins → + → Add custom MCP server, затем установите созданный плагин и выберите его через @ в новом разговоре. Интерфейс и доступность зависят от аккаунта и правил рабочего пространства; актуальный порядок описан у OpenAI.

3. Сохраните нужные разрешения

   Откройте настройки доступа к ПК. Для чтения документов достаточно файлового чтения; для управления окнами нужны экран, мышь и клавиатура; для обработки видео и запуска приложений — команды и запись файлов. Нажмите кнопку сохранения разрешений.

4. Проверьте связь простой командой

   Проверь подключение к Кариадель и перечисли доступные инструменты. Затем покажи названия файлов в папке, которую я укажу.

   Скопировать запрос

   Вход в аккаунт и разрешение доступа к компьютеру — разные этапы. Первый успешный вызов инструмента подтверждает, что запрос дошёл до ПК.

Компьютер должен быть включён, Кариадель — запущена, интернет — доступен. Закрытие панели крестиком оставляет программу работать в фоне. Для публичного MCP-подключения посетителю не нужны Tailscale, настройка роутера или открытие входящих портов на домашнем ПК.

ОСНОВНЫЕ ВОЗМОЖНОСТИ

Что можно поручить компьютеру

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

Документы, таблицы и изображения

С какими программами можно работать

Ниже приведены конкретные способы работы и границы проверки. Это не обещание поддержки каждой кнопки, каждой версии приложения или любой творческой задачи.

Кариадель не включает лицензии Office или Photoshop. FFmpeg и Blender тоже устанавливаются отдельно. Программа не заменяет эти приложения, а даёт ИИ способ использовать их возможности. Официальные интерфейсы: Blender Python API и Photoshop UXP.

ПРАКТИЧЕСКАЯ ДЕМОНСТРАЦИЯ

Да, видео тоже можно обработать

Кариадель запускает подготовленную ИИ команду FFmpeg на вашем ПК. Вы можете указать отрезок, размер, формат, нужную звуковую дорожку и имя результата обычными словами. FFmpeg должен быть доступен на компьютере; разрешения на команды, чтение и запись файлов — включены.

Пути в примерах условные. Замените их на расположение своих файлов.

Размер, длительность и отсутствие звуковой дорожки в результате проверены отдельным вызовом FFprobe. Скорость обработки зависит от длительности исходника, кодека, диска и процессора/GPU. Короткая демонстрация не является оценкой времени для длинного фильма.

С чего можно начать

Хороший запрос задаёт исходные данные, нужный результат и способ проверки. Ниже — шаблоны, которые можно адаптировать под свои файлы. Успешность новой задачи проверяется по полученному результату.

Для сложной задачи удобно сначала попросить ИИ проверить исходные файлы и зависимости, оценить время, затем выполнить работу и показать результат. Фраза «сделай красиво» оставляет много неопределённости; размеры, формат, пример и критерий готовности помогают получить предсказуемый результат.

Промпты и задачи внутри Кариадель

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

1. Откройте библиотеку промптов или раздел задач.
2. Задайте цель, исходные данные, правила и ожидаемый результат.
3. Выберите нужное подключение: локальную работу, Telegram-аккаунт или бота, если это соответствует типу задачи.
4. Запустите задачу и следите за состоянием и «Ходом работы».
5. При необходимости поставьте задачу на паузу. Уже выполненное действие или уже отправленное сообщение этим не отменяется.

Локальная автоматизация использует инструменты компьютера и модель. Переписка, поиск сообществ, модерация и отчёты имеют свои условия запуска. Не любой сохранённый промпт автоматически превращается в непрерывного агента: задача должна быть запущена, а нужное подключение — доступно.

Что текущая версия не обещает

• Работу с выключенным компьютером. Файлы ПК, действия в окнах и локальные Telegram-задачи недоступны без работающего ПК и приложения. Серверный API моделей рассматривается отдельно ниже.
• Полную поддержку любой программы. Наличие мыши и клавиатуры не равно специализированной интеграции со всеми функциями редактора. Раскладка окон, язык, диалоги и масштаб экрана влияют на управление.
• Готовый модуль Photoshop. Отдельного коннектора документов и слоёв сейчас нет. Практический прогон Photoshop при подготовке документации не выполнялся.
• Любые жесты мышью. Среди штатных GUI-инструментов этого выпуска нет отдельных команд перетаскивания и длительного удержания кнопки/клавиши. Для таких задач нужен подходящий сценарий или доработка интеграции.
• Встроенный видеоредактор, генератор изображений или речи. Для таких задач используются отдельные приложения, модели или сервисы, если они доступны и подключены.
• Пересчёт Excel встроенным читателем. Он возвращает формулы и сохранённые значения. Пересчёт в нашем примере сделал установленный Microsoft Excel.
• Неограниченные ресурсы модели. Тариф Кариадель не отменяет лимиты, доступность и условия аккаунта или API используемой модели. Актуальные возможности тарифов — на странице тарифов.
• Безошибочную работу ИИ. Готовый файл, рендер, отправку или изменение нужно проверять по результату. Один успешный пример не подтверждает все возможные сценарии.

Где находятся данные

Настройки, промпты, локальные задачи и Telegram-сессии хранятся на ПК. Telegram API-данные, токены и сессии защищаются средствами Windows. Сервер Кариадель обслуживает авторизацию, подключение, тарифы и серверный API.

При работе через ИИ содержимое выбранных файлов, снимки экрана или текст сообщений могут передаваться модели для выполнения задачи; при публичном подключении запросы и ответы проходят через сервер Кариадель. «Хранится локально» не означает «никогда не передаётся в интернет». Подробности — в политике данных.

ВТОРАЯ ЧАСТЬ · TELEGRAM

Аккаунты, боты и работа по вашим правилам

В Кариадель можно подключить личный Telegram-аккаунт или бота. Это разные подключения: у личного аккаунта — авторизация Telegram и сессия, у бота — токен BotFather. Для работы функций Telegram нужен соответствующий доступ к ИИ-агентам.

Подключение Telegram не является разрешением на рассылку всем контактам. Опишите нужные чаты и действия явно. Правила задачи не отменяют ограничения Telegram; проверки входа, 2FA, частоты запросов и прав остаются в силе.

Как подключить Telegram

1. Откройте раздел Telegram

   Выберите добавление личного аккаунта или бота. Для первого личного аккаунта получите собственные API ID и API hash на my.telegram.org/apps. Это данные Telegram-приложения, не ключ API модели.

2. Подтвердите вход

   На телефоне откройте Telegram → Настройки → Устройства → Подключить устройство и отсканируйте QR. Если включена двухэтапная проверка, введите пароль в запросе. При истечении QR дождитесь нового кода. Для бота введите токен, полученный у BotFather.

3. Задайте инструкцию

   Опишите задачу, стиль ответа, исходные сведения и необходимые чаты. Для специализированной работы создайте задачу нужного типа. Убедитесь, что аккаунт или бот имеет необходимые права.

4. Запустите отдельно

   Сам вход не включает автоматические ответы. Запустите подключение или задачу соответствующей кнопкой и проверьте состояние. Для остановки используйте предусмотренное действие в программе.

API ID/hash, токены и Telegram-сессии сохраняются зашифрованно на этом ПК. Текст, необходимый для ответа, передаётся модели. Облачный пароль Telegram не сохраняется. При выключенном компьютере локальные аккаунты и боты Кариадель не работают.

ТРЕТЬЯ ЧАСТЬ · API

API моделей и доступ к ПК — разные подключения

API нужен, когда вы хотите использовать модель из своего приложения, скрипта, сайта, бота или системы автоматизации. Например, классифицировать обращения, готовить черновики ответов, извлекать сведения из текста или встраивать диалог в собственный сервис.

Как получить API-доступ

1. Откройте в Кариадель раздел API-ключей.
2. Подключите ChatGPT именно для API: это отдельное подключение от доступа чата к вашему ПК.
3. Создайте именованный ключ, сохраните выданный секрет в настройках своего приложения.
4. Укажите базовый адрес https://mcp.kariadel.ru/v1.
5. Запросите список моделей и передавайте выбранный идентификатор в поле model каждого запроса.

Ключ модели не открывает инструменты компьютера, Telegram-сессии или чужие аккаунты. Для доступа к ПК подключайте MCP отдельно. Формат совместим с указанными ниже маршрутами OpenAI; совместимость со всеми возможностями, параметрами и SDK OpenAI не заявляется.

Не вставляйте секретный ключ в публичный JavaScript сайта или репозиторий. Веб-приложение обращается к API со своего сервера, где хранится ключ. Неиспользуемый ключ можно отозвать. После отзыва он перестаёт авторизовывать запросы.

Маршруты и первый API-запрос

Заголовки: Authorization: Bearer ВАШ_КЛЮЧ, для JSON — Content-Type: application/json. Идентификатор модели берётся из списка моделей вашего подключения. Поддержка конкретных входов и функций зависит от выбранной модели.

Python без дополнительных библиотек

Пример читает ключ из переменной окружения KARIADEL_API_KEY. Настройте её в окружении вашего скрипта. Код не создаёт ключ и не содержит настоящих реквизитов.

import json
import os
import urllib.request

BASE = "https://mcp.kariadel.ru/v1"
KEY = os.environ["KARIADEL_API_KEY"]

def call(path, payload=None):
    body = None if payload is None else json.dumps(payload).encode("utf-8")
    request = urllib.request.Request(
        BASE + path,
        data=body,
        headers={"Authorization": "Bearer " + KEY,
                 "Content-Type": "application/json"},
    )
    with urllib.request.urlopen(request, timeout=120) as response:
        return json.load(response)

models = call("/models")["data"]
if not models:
    raise RuntimeError("Нет доступных моделей: проверьте подключение для API")

result = call("/chat/completions", {
    "model": models[0]["id"],
    "messages": [{"role": "user", "content": "Составь план подготовки отчёта."}],
})
print(result["choices"][0]["message"]["content"])

HTTP-шаг в системе автоматизации

Создайте HTTP-запрос POST https://mcp.kariadel.ru/v1/chat/completions, задайте Bearer-ключ в хранилище реквизитов системы, выберите JSON и передайте тело:

{
  "model": "ИДЕНТИФИКАТОР_ИЗ_СПИСКА_MODELS",
  "messages": [
    {"role": "user", "content": "Выдели тему и краткое содержание обращения: ..."}
  ]
}

Для Responses используйте тот же ключ, путь /responses и поля model, input. При stream: true ответ приходит как поток событий; обработчик должен читать поток, а не ожидать один JSON-документ.

В проверках документации маршруты, потоковые ответы и отзыв ключей проверены на изолированном сервере с тестовым поставщиком модели. Это проверка API-контракта; она не обещает доступность конкретной модели, скорость генерации или успешную оплату у пользователя.

Если что-то не работает

ПРОВЕРЕНО НА ПРАКТИКЕ

На чём основана эта документация

Проверки выполнены 18 октября 2026 года. Команды обработки и чтение результатов вызваны через установленную Кариадель. Для примеров созданы искусственные данные; пользовательские документы и переписки не публикуются.

Автотесты Telegram не являются отправкой сообщений реальным людям. API-тесты не являются проверкой всех моделей на реальном платном запросе. Проверки внешних программ подтверждают перечисленные сценарии, а не всю совместимость их интерфейсов.

Открыть краткий технический отчёт JSON →