Как создать агента: чат, расписание, Telegram, Яндекс Диск, виджет — база знаний

С 21.09 агента проще собрать разговором: откройте «Агенты», опишите задачу своими словами — модель задаст пару вопросов, сама запишет роль, подберёт инструменты, покажет формы подключения мессенджеров и почты прямо в ленте (секреты в текст не попадают) и включит агента. Карточка справа заполняется по ходу; полные настройки — по кнопке «Все настройки». Ниже — что означает каждая настройка.

Агент — это модель с ролью, набором инструментов и правом работать без вас: отвечать людям в Telegram, VK, MAX, на почте и на сайте, присылать сводки по расписанию, читать и сохранять файлы на вашем Диске, отвечать вашей программе через API. Собирается из одной фразы.

Для кого это

Для тех, кому нужен «дежурный»: следить за новостями ниши, отвечать клиентам по вашим правилам, готовить ежедневную сводку, обрабатывать заявки из CRM.

Собрать

Агенты → Опишите задачу → Собрать. Одна задача, для кого, что считается хорошим результатом. Платформа предложит имя, роль, инструменты и первое сообщение; если деталей мало — задаст пару вопросов. Роль и инструменты потом правятся в карточке.

Инструменты: поиск в интернете, чтение страниц, калькулятор, курсы валют, графики, глубокое исследование, запуск кода, «спросить пользователя» перед необратимым действием, Яндекс Диск, отправка писем и вся витрина Synty (catalog): попросите «сделай ролик 10 секунд про кофейню» — агент найдёт подходящий инструмент, назовёт цену и модель, при дорогом запуске спросит подтверждение и вернёт готовый файл. Модель можно закрепить, оставить «как в диалоге» или поставить Synty Auto.

Где агент работает

Чат на сайте. Кнопка Открыть чат — роль и инструменты подставляются сами.
Расписание. Ежедневно или еженедельно в заданный час по Москве; задание — что делать. Выпуски ложатся в отдельный диалог, приходят push-уведомлением и, если подключены Telegram, VK или MAX, в выбранный чат. Выполнить сейчас проверяет настройку.
VK. В сообществе: Управление → Работа с API → Ключи доступа → создать ключ с правами «сообщения» и «управление»; в разделе «Сообщения» включите сообщения сообщества. Вставьте ключ в карточку агента — Long Poll и событие «Входящее сообщение» включатся сами (без права «управление» включите их руками в «Работа с API → Long Poll API»). Агент отвечает подписчикам в личке сообщества, а в беседах — на упоминание сообщества. Картинки и файлы из инструментов отправляются вложениями.
MAX. В мессенджере MAX откройте @MasterBot, создайте бота, вставьте токен в карточку. Агент отвечает в личке и в чатах, куда добавили бота (по обращению @бот или ответу на его сообщение). Публикация бота в каталоге MAX требует верифицированного юрлица — для работы с вашими чатами это не нужно.
Субагенты. В карточке «Субагенты» отметьте, каким из своих агентов этот может поручать задачи (до восьми). Включится инструмент delegate: агент вызывает ask_agent с задачей и контекстом, субагент работает своей ролью, моделью и инструментами — витриной, Диском, почтой — и возвращает ответ. Так собирается связка «редактор → исследователь → дизайнер». Списание — по модели субагента, его запуск виден в журнале как «от агента». Субагент может звать своих субагентов только на один уровень ниже, себя — никогда.
Ящик агента (AgentMail). Если не хочется подключать личную почту, заведите агенту отдельный ящик: в карточке «Ящик агента» вставьте ключ API из своего аккаунта agentmail.to (сервис американский, как и модели; ящик — ваш, согласие на передачу спрашиваем один раз), затем «Завести ящик агенту» или привяжите существующий. Агент отвечает на письма, пришедшие на этот адрес (список отправителей ограничивает круг), и пишет с него сам (agentmail_send); выпуски расписания можно слать на любой адрес. Что пересылать в этот ящик — решаете только вы.
Яндекс Календарь. Подключение по CalDAV — логин Яндекса и пароль приложения (id.yandex.ru → Безопасность → Пароли приложений → «Календарь CalDAV»), без OAuth. Инструменты: события за период (ycal_list), создать (ycal_create), удалить (ycal_delete); время по Москве, календарь выбирается по названию. Включите плашку yandex_calendar.
Яндекс Трекер. OAuth-токен с правами Трекера и идентификатор организации (Трекер → Настройки → Организация; Яндекс 360 или Cloud определяется само). Инструменты: поиск на языке запросов Трекера (ytr_search), карточка с комментариями (ytr_get), создать (ytr_create), комментарий (ytr_comment), поля и статус (ytr_update). Плашка yandex_tracker. Всё бесплатно — сервисы ваши.
База данных (Postgres/MySQL). Строка подключения к вашей базе — агент читает схему и делает SELECT-запросы: «сколько заказов вчера», «топ товаров за месяц». Запись закрыта на трёх уровнях (проверка запроса, транзакция только для чтения, лимит времени), до 200 строк за запрос. Заведите в базе пользователя только на чтение; хост должен быть доступен из интернета. Плашка sql.
Битрикс24 и amoCRM. Битрикс24 — входящий вебхук портала (Разработчикам → Другое → Входящий вебхук, права CRM и Задачи); amoCRM — поддомен и долгосрочный токен интеграции. Агент ищет контакты, показывает лиды и сделки, заводит новые (лид/сделку/задачу/примечание) — сценарий «ответил клиенту в мессенджере и завёл сделку». Плашки bitrix24, amocrm.
hh.ru для работодателя. Войдите через hh.ru аккаунтом менеджера компании (кнопка «Подключить» в форме или в «Подключениях» профиля). Агент видит активные вакансии со счётчиками откликов, отклики кандидатов, их резюме и переписку, сравнивает кандидатов с требованиями вакансии и готовит сводку и черновик ответа; написать кандидату может только после вашего согласия, приглашать и отказывать — не может. Плашка hh_employer. Поиск вакансий по всему hh (плашка hh) работает без входа.
МойСклад. Токен доступа сотрудника (Настройки → Пользователи → Токен доступа) или логин и пароль — тогда токен получим сами, пароль не храним. Агент показывает остатки и резервы, ищет товары и контрагентов, перечисляет и раскрывает заказы покупателей, создаёт заказ по названию контрагента и списку товаров (перед созданием перечисляет позиции и уточняет). Плашка moysklad.
Таблицы XLSX. Плашка save_xlsx: агент собирает таблицу из данных (результаты поиска, выгрузка из базы, список лидов) и отдаёт ссылку; с подключённым Диском — сохраняет в /Synty.
hh.ru. Плашка hh: поиск вакансий по тексту, региону, зарплате и опыту, полное описание вакансии; резюме под неё — инструмент «ATS-резюме» на витрине. API для соискателей hh закрыл 15.12.2025, поэтому откликаться от вашего имени агент не может; работодательский контур (отклики, кандидаты) — после регистрации приложения.
MCP-серверы. Если у вас есть свой MCP-сервер (CRM, база, внутренний сервис — или готовый из каталога MCP по Streamable HTTP), подключите его в карточке «MCP-серверы»: название, адрес https://…/mcp, токен при необходимости. Мы делаем рукопожатие, забираем список инструментов и показываем его; отметьте, каким агентам сервер доступен, — у агента появятся инструменты mcp_<сервер>_<имя>. Вызовы бесплатны (сервер ваш), до 6 серверов и 40 инструментов на каждом. Локальные и внутренние адреса не принимаются. Кнопка «Обновить» перечитывает инструменты после изменений на сервере.
Голосовые сообщения. В Telegram, VK и MAX агент понимает голосовые: расшифровка бесплатная (Whisper), при исчерпании дневной нормы — 0.5 SC за секунду с вашего баланса. В карточке «Голосовые сообщения» выбирается, отвечать ли голосом: никогда, только на голосовое или всегда, — и каким из пяти голосов. Озвучка ответа оплачивается по факту, как инструмент «Озвучка»; озвучиваются первые 1500 знаков, ссылки и картинки остаются в тексте.
Telegram. Создайте бота у @BotFather (/newbot), вставьте токен в карточку агента. Напишите боту /start — чат появится в списке; там же выбирается, кому отвечать и куда присылать выпуски. Бот помнит последние реплики каждого чата. В группах отвечает только на обращение @бот или на ответ своему сообщению — как в VK и MAX.
Яндекс Диск. Включите инструмент yandex_disk и нажмите Подключить Яндекс Диск — откроется окно Яндекса, войдите в свой аккаунт и разрешите доступ. Агент читает файлы по пути, сохраняет результаты в папку /Synty, по просьбе делает публичную ссылку. Токен хранится шифрованным; отозвать можно в карточке или в настройках Яндекс ID.
Почта. Подключите ящик паролем приложения (Яндекс Почта, Mail.ru, свой IMAP/SMTP) — агент отвечает на письма от вашего имени в той же ветке, присылает выпуски письмом и может писать письма сам (инструмент send_email, с подтверждением).
Webhook. Секретная ссылка для программ: n8n, CRM, формы шлют {"message": …, "wait": true} и получают ответ; результаты и выпуски уходят на ваш callback URL с подписью.
Виджет на сайт. Включить виджет, домены, цвет, приветствие → Скопировать код → перед </body>. Посетители общаются с агентом, платите вы.
API. POST /v1/agents/{id}/run с сообщением, список — GET /v1/agents. Ключ — в кабинете, область chat. Подробности — на /developers, раздел «Агенты».

Деньги и безопасность

Платите вы, со своего баланса, по модели и фактическим токенам. Если баланс кончился, агент по расписанию встанет на паузу с причиной; бот в Telegram вежливо попросит подождать. Платные инструменты (поиск, чтение страниц) недоступны на бесплатном тарифе. Все запуски вне чата — в журнале внизу карточки: запрос, ответ, списанные SC.

Типичные проблемы

Агент отвечает общими словами — задача «про всё». Сузьте до одной.
Не ищет в интернете — не включён web_search или тариф бесплатный.
Бот молчит — неверный токен или ключ, снята галочка «отвечать в …» или бот на паузе; ошибка канала видна рядом с именем бота. В VK проверьте, что включены сообщения сообщества и Long Poll API.
Диск не подключается — разрешите всплывающие окна для synty.pro.