AgiMate Desktop-коннектор

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

Как это работает

Коннектор живёт в системном трее. Он передаёт агенту события с компьютера и выполняет вызовы его инструментов.

Компьютер
Папки и быстрые кнопки
HTTP ↑ / WebSocket ↓
Desktop-коннектор
Иконка в трее, работает в фоне
Ваш агент
Решает, что делать
1

На компьютере что-то происходит

В отслеживаемой папке появился файл или вы нажали быструю кнопку. Плагин-триггер это замечает.

2

Коннектор отправляет событие

Событие уходит на платформу по HTTPS: имя триггера, время и данные, например путь к файлу.

3

Событие получает агент

Платформа передаёт его агентам, у которых есть доступ к этому компьютеру.

4

Агент вызывает инструмент

Вызов приходит по WebSocket: показать уведомление, сделать скриншот, прочитать текст вслух. Коннектор выполняет его и возвращает результат агенту.

Что есть из коробки

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

Триггеры

Слежение за папками

Файл появился, изменился, удалён или перемещён. По умолчанию коннектор следит за новыми файлами в «Загрузках».

  • Любые папки, по желанию с вложенными
  • Фильтр по маске: *.pdf, *.xlsx
  • В событии путь, имя, размер и тип изменения
  • Пример: в «Загрузки» пришёл счёт → агент ставит задачу на оплату

Быстрые кнопки

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

  • Кнопка срабатывает сразу или сначала спрашивает текст
  • Число колонок настраивается
  • Кнопки описываются в JSON прямо в окне
  • Пример: «Заметка» → вводите текст → агент сохраняет его в Notion

Инструменты агента

Уведомления

Обычное системное уведомление или окно, которое нужно закрыть самому, чтобы точно не пропустить.

  • Заголовок и текст
  • Для системного уведомления задаётся длительность
  • Пример: агент нашёл ошибку в отчёте → окно поверх всех

Озвучка текста

Компьютер читает текст вслух встроенным синтезатором речи. Агент может и прервать чтение.

  • macOS: say, с выбором голоса и скорости
  • Windows: SAPI через PowerShell
  • Linux: espeak или spd-say
  • Пример: агент вслух напоминает о созвоне через пять минут

Свои плагины

Каждый триггер и инструмент — это плагин: папка с plugin.py и config.json. Свой плагин пишется на Python.

Плагин-триггер

Следит за чем-то на компьютере и отправляет агенту событие.

Компьютер → агентПапки, быстрые кнопки

Плагин-инструмент

Выполняет вызов агента на компьютере и возвращает результат.

Агент → компьютерУведомления, озвучка, скриншоты
Направление
Триггер
Компьютер → агент
Инструмент
Агент → компьютер
Что делает
Триггер
Отправляет событие
Инструмент
Выполняет вызов
Встроенные
Триггер
Папки, быстрые кнопки
Инструмент
Уведомления, озвучка, скриншоты, окна, файлы, система
Базовый класс
Триггер
TriggerPlugin
Инструмент
ToolPlugin
Пример триггера (Python)
from core.plugin_base import TriggerPlugin

class MyTrigger(TriggerPlugin):
    @property
    def name(self) -> str:
        return "Мой триггер"

    async def initialize(self) -> None:
        pass

    async def shutdown(self) -> None:
        pass

    async def start(self) -> None:
        # Начать слежение; событие отправляется так:
        self.emit_event("my_event", {"value": 42})

    async def stop(self) -> None:
        # Остановить слежение
        pass
Пример инструмента (Python)
from core.models import ToolResult
from core.plugin_base import ToolPlugin

class MyTool(ToolPlugin):
    @property
    def name(self) -> str:
        return "Мой инструмент"

    async def initialize(self) -> None:
        pass

    async def shutdown(self) -> None:
        pass

    def get_supported_tools(self) -> list[str]:
        return ["my_tool"]

    async def execute(self, tool_type: str,
                      parameters: dict) -> ToolResult:
        # Выполнить вызов
        return ToolResult(success=True, data={"ok": True})

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

Сценарии, которые собираются из встроенных триггеров и инструментов

Документы из «Загрузок»

В «Загрузки» пришёл PDF. Агент видит имя файла, ставит задачу на доске и показывает уведомление.

Новый файл→Задача→Уведомление

Заметки одной кнопкой

Кнопка «Заметка» спрашивает текст и отправляет агенту. Агент сохраняет его в сервис, к которому у него есть доступ.

Кнопка→Текст→Notion

Важное — голосом

Агент решил, что событие срочное, например письмо от клиента. Он читает его вслух и показывает окно, которое не исчезнет само.

Срочное событие→Голос→Окно

Что у меня на экране

Вы пишете агенту в чат «посмотри, что за ошибка». Он снимает активное окно и отвечает по картинке.

Вопрос в чате→Скриншот→Ответ

Присмотр за компьютером

Агент по расписанию проверяет диски и память и предупреждает, когда место заканчивается.

Проверка→Диски и память→Предупреждение

Кнопки для частых просьб

«Собери отчёт за день», «Что у меня завтра?» — одна кнопка вместо того, чтобы каждый раз писать агенту.

Кнопка→Агент→Ответ

Под капотом

Технические подробности

ПлатформыWindows, macOS, Linux
Сделан наPython 3.11+, Qt 6 (PySide6)
Связь с платформойHTTPS + WebSocket (Centrifugo)
ПереподключениеС растущей паузой, до 10 попыток
MCPВстроенный локальный MCP-сервер с теми же инструментами
ПлагиныПапка с plugin.py и config.json, конфиг проверяется при загрузке

Интерфейс

Иконка в трее и окно настроек

Иконка в трее

Показывает, подключён ли коннектор.

  • Два вида иконки: подключён и не подключён
  • Подробности в подсказке при наведении
  • В меню: подключиться или отключиться, настройки

Подключение

Связь с платформой.

  • Адрес сервера и Device Key
  • Привязка устройства
  • Подключение при запуске
  • Интервал переподключения

Плагины

Триггеры и инструменты.

  • Список встроенных и своих плагинов
  • Включение одной галочкой
  • Настройки каждого плагина в JSON

Начать

Три шага от скачивания до первого события

1

Скачайте коннектор

Выберите платформу.

2

Вставьте ключ

В дашборде, в разделе «Приложения», создайте приложение и скопируйте ключ. В настройках коннектора вставьте его в поле Device Key вместе с адресом сервера и привяжите устройство.

3

Включите плагины

Отметьте нужные триггеры и инструменты. Коннектор работает в фоне, окно можно закрыть.

Скачать Desktop-коннектор AgiMate

Бесплатно, с открытым кодом. Windows, macOS и Linux.