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

Подключает телефон к вашим агентам. Звонки, смена Wi-Fi, низкий заряд и вход в заданную зону становятся для агента триггерами, а уведомления, календарь, контакты и камера — его инструментами.

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

Телефон сообщает агенту о том, что с ним происходит, и выполняет то, что агент просит сделать.

Триггеры

Звонки

Входящий и пропущенный звонок. Номер звонящего Android сторонним приложениям не отдаёт, поэтому в событии его нет. У пропущенного есть длительность звонка.

Пример: пропущенный во время встречи → агент вечером напомнит перезвонить

Низкий заряд

Срабатывает, когда система сообщает о низком заряде. В событии текущий процент.

Пример: рабочий планшет садится → агент пишет об этом в Telegram

Wi-Fi

Подключение к сети и отключение от неё. В событии имя сети и уровень сигнала.

Пример: телефон подключился к офисной сети → агент присылает план на день

Встряхивание

Телефон встряхнули. Самая простая кнопка, которая всегда под рукой.

Пример: встряхнули → агент читает вслух ближайшие встречи

Вход и выход из зоны

Телефон вошёл в заданную зону или покинул её. Зоны ставит сам агент.

Пример: вышли из офиса → агент напоминает зайти в магазин

Коннектор работает в фоне, держать его открытым не нужно. Агенту уходят только включённые триггеры.

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

Уведомление

Обычное системное уведомление с заголовком и текстом. Ответа не ждёт.

Пример: «Отчёт готов, лежит в файлах»

Вопрос

Уведомление с вопросом и до трёх кнопок-вариантов. Можно ответить и текстом прямо из шторки. Агент ждёт ответа до пяти минут.

Пример: «Перенести созвон на 16:00?» → Да / Нет

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

Телефон читает текст вслух системным синтезатором речи.

Пример: агент вслух напоминает, что через 10 минут выезжать

Поиск в контактах

Ищет в адресной книге по имени, номеру или почте. Выгрузить всю книгу целиком нельзя.

Пример: «Найди телефон Ольги из бухгалтерии»

Календарь

Ищет события за нужный период и создаёт новые. Повторяющиеся события разворачиваются в отдельные встречи.

Пример: «Что у меня в четверг?», «Поставь встречу на завтра в 10»

Фото с камеры

Агент просит снимок, вы подтверждаете в уведомлении. Без вашего нажатия камера не включится, это ограничение Android.

Пример: агент просит сфотографировать чек, чтобы внести расход

Зоны

Добавить зону с центром и радиусом, удалить её или посмотреть список. Вход и выход из зоны приходят агенту как триггеры.

Пример: «Скажи, когда я доеду до дачи»

Вызов приходит на телефон по WebSocket, результат уходит обратно агенту. Выключенный инструмент агент не видит.

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

Телефон, платформа и агент

Android-коннектор
Триггеры и инструменты
HTTP ↑ / WebSocket ↓
AgiMate
Доставляет события и вызовы
Ваш агент
Решает, что делать
1

Телефон привязывается к аккаунту

Вы создаёте приложение в дашборде и вставляете его ключ в коннектор. Коннектор сообщает платформе, какие триггеры и инструменты на нём включены.

2

На телефоне что-то происходит

Пропущенный звонок, вход в зону, встряхивание. Коннектор отправляет событие на платформу по HTTPS.

3

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

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

4

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

Вызов приходит на телефон по WebSocket. Коннектор выполняет его и возвращает результат агенту.

Интерфейс

Три вкладки. Интерфейс пока только на английском.

Triggers

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

  • Переключатель у каждого триггера
  • Разрешение спрашивается при включении
  • Последние события со статусом отправки
  • Очистка журнала

Tools

Что агенту разрешено делать на телефоне.

  • Инструменты сгруппированы по разделам
  • Переключатель у каждого инструмента
  • Разрешение спрашивается при включении
  • Выключенный инструмент агент не увидит

Settings

Подключение к платформе.

  • Device Key — ключ приложения из дашборда
  • Server URL, по умолчанию облако AgiMate
  • Привязка устройства и проверка связи
  • Отладочные логи

Для разработчиков

Формат событий и вызовов, требования и разрешения

Событие (JSON)

Так коннектор отправляет событие на платформу:

{
  "id": "evt-001",
  "type": "DEVICE_EVENT",
  "name": "wifi_connected",
  "source": "android-app",
  "deviceId": "device-abc123",
  "occurredAt": "2026-07-23T12:00:00Z",
  "data": {
    "ssid": "Office-5G",
    "bssid": "00:11:22:33:44:55",
    "signalStrength": -45
  }
}
Вызов инструмента (JSON)

Так вызов инструмента приходит на телефон:

{
  "type": "toolCall",
  "payload": {
    "id": "019f6c63-67f5-7fe8-be0f-031b9b4645ae",
    "connectorCode": "app",
    "connectionId": "01951234-abcd-ef01-2345-6789abcdef02",
    "name": "tts_speak",
    "input": { "text": "Через 10 минут выезжать" },
    "agentSessionId": "0193b8e3-ad77-7c31-a4f0-8e7c9d2f1a77"
  }
}
Требования и разрешения
Android7.0 и новее (API 24)
СоединениеWi-Fi или мобильный интернет
Работа в фонеForeground Service
Связь с платформойHTTPS + WebSocket (Centrifugo)

Разрешения Android

  • Каждое разрешение спрашивается, когда вы включаете триггер или инструмент, которому оно нужно
  • INTERNET, ACCESS_NETWORK_STATE — связь с платформой
  • ACCESS_WIFI_STATE — триггер Wi-Fi
  • READ_PHONE_STATE — триггер звонков
  • ACCESS_FINE_LOCATION, ACCESS_COARSE_LOCATION, ACCESS_BACKGROUND_LOCATION — зоны
  • READ_CONTACTS — поиск в контактах
  • READ_CALENDAR, WRITE_CALENDAR — календарь
  • CAMERA, FOREGROUND_SERVICE_CAMERA — фото с камеры
  • POST_NOTIFICATIONS — уведомления и вопросы
  • FOREGROUND_SERVICE, FOREGROUND_SERVICE_SPECIAL_USE — работа в фоне
  • RECEIVE_BOOT_COMPLETED — запуск после перезагрузки телефона

Установка

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

1

Скачайте APK

Последняя версия лежит в GitHub Releases.

Скачать APK
2

Разрешите установку из неизвестных источников

Android спросит об этом сам при первом открытии APK. Разрешение даётся тому приложению, через которое вы скачали файл, обычно браузеру.

3

Установите и откройте коннектор

Откройте скачанный файл и подтвердите установку.

4

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

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

5

Включите триггеры и инструменты

Отметьте то, что нужно агенту, и выдайте разрешения, которые попросит Android.

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

Бесплатно, с открытым кодом. APK лежит в GitHub Releases.