Обзорное знакомство с Koda Desktop¶
Если хочется быстро почувствовать, чем Koda Desktop полезна в реальной работе, не обязательно сразу читать всю документацию подряд. Достаточно понять, какие режимы у неё есть и в какой момент какой из них удобнее включать.
Ниже — короткая карта возможностей.
Диалог с агентом — это основной способ работы с Koda Desktop. Вы выбираете проект, формулируете задачу обычным языком и получаете ответ: объяснение, план, изменения в файлах или результат проверки.
Когда это полезно
Диалог хорош, когда нужно разобраться в коде, обсудить решение, внести правки, добавить тесты или подготовить коммит.
Главный экран Koda Desktop
Это профили поведения для конкретных типов работы: «Стандартный» или ваши собственные. Режим задаёт роль, доступные навыки, инструменты и MCP-серверы, поэтому для новой задачи не нужно каждый раз объяснять контекст заново.
Когда это полезно
Пользовательские режимы выручают, когда работа повторяется: системный аналитик, тестировщик, код-ревьюер — создайте режим под роль и переключайтесь одним кликом.
Пользовательские режимы
Встроенный браузер открывает страницы прямо в окне приложения: агент читает их, нажимает кнопки и заполняет формы, а вы видите происходящее рядом с чатом. Здесь же открываются интерактивные визуализации — макеты интерфейса, которые агент собирает по вашему запросу.
Когда это полезно
Браузер нужен для проверки вёрстки, работы с локальным сайтом, изучения документации и задач, где важно видеть страницу, а не только текст ответа.
Панель встроенного браузера
Потоки — визуальный конструктор автоматизаций. Вы собираете сценарий из блоков: агент, HTTP-запрос, файл, условие, цикл, ожидание или вызов другого потока. Запускать поток можно вручную, по расписанию, по вебхуку или из другого потока.
Когда это полезно
Потоки выручают, когда одна и та же последовательность шагов повторяется: разбор обращений, отчёты, синхронизация данных, проверки перед релизом.
Холст потока
Питомец — необязательный спутник на рабочем столе. Он показывает, что происходит в чатах, и сообщает, когда нужен ответ или решение, не отвлекая от текущего окна.
Когда это полезно
Питомец помогает не пропустить готовый ответ или запрос разрешения, когда Koda Desktop свёрнута, а вы работаете в другом приложении.
Настройки питомца
Задачи по расписанию позволяют запускать агента без вашего участия в заданное время. Это полезно для регулярных проверок, ревью, тестов и аудита.
Когда это полезно
Задачи по расписанию стоит использовать для повторяющихся проверок: прогон тестов, статус проекта, ревью новых коммитов или аудит зависимостей.
Добавление фоновой задачи
Субагенты — фоновые помощники, которых агент запускает для долгих исследований: поиск по кодовой базе, чтение документации, сбор фактов.
Они работают параллельно с основным диалогом и не блокируют чат, а готовый результат приходит агенту автоматически.
Готовые роли субагентов можно запускать меткой @agent:<имя> и продолжать разговор с субагентом на его отдельном экране.
Когда это полезно
Субагенты ускоряют объёмные задачи: сравнить несколько модулей, собрать информацию из разных частей проекта, изучить альтернативные подходы — не засоряя основной диалог.
Настройки субагентов
Telegram-доступ позволяет управлять агентом с телефона: запускать задачи, узнавать статус и разрешать действия агента, когда вы отошли от рабочего места.
Когда это полезно
Длинная задача запущена, а вам нужно уйти — бот напишет, когда потребуется решение, и вы ответите одной кнопкой прямо в чате.
Практический сценарий¶
На практике режимы часто сменяют друг друга в рамках одной задачи. Например, это может выглядеть так:
1. Read-only: «Найди причину бага и предложи план»
2. Диалог с агентом: «Внеси исправление по плану»
3. Задачи по расписанию: «Прогоняй тесты каждый час»
Такой переход между режимами — не обходной путь, а обычный рабочий процесс. Первые два шага можно объединить в режиме планирования: агент найдёт вероятную причину и опубликует план, а реализация запустится после вашего одобрения.
Проект в активной разработке
Мы активно работаем над улучшением стабильности и функционала приложения. Сообщайте нам об ошибках и пожеланиях! Как это сделать описано на этой странице.
С чего начать¶
- Если вы открываете приложение впервые, пройдите первые шаги.
- Если хотите понять рабочий цикл целиком, откройте рабочий процесс.
- Если ищете идеи для задач, посмотрите кейсы использования.
- Если что-то выглядит странно, загляните в раздел диагностики или логи.