База знаний
Платформа: студия, тьютор, агенты, файлы, API

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

3 мин чтенияОбновлено 20 сентября 2026

Агент — это модель с ролью, набором инструментов и правом работать без вас: отвечать людям в 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 с задачей и контекстом, субагент работает своей ролью, моделью и инструментами — витриной, Диском, почтой — и возвращает ответ. Так собирается связка «редактор → исследователь → дизайнер». Списание — по модели субагента, его запуск виден в журнале как «от агента». Субагент может звать своих субагентов только на один уровень ниже, себя — никогда.
  • Голосовые сообщения. В Telegram, VK и MAX агент понимает голосовые: расшифровка бесплатная (Whisper), при исчерпании дневной нормы — 0.5 SC за секунду с вашего баланса. В карточке «Голосовые сообщения» выбирается, отвечать ли голосом: никогда, только на голосовое или всегда, — и каким из пяти голосов. Озвучка ответа оплачивается по факту, как инструмент «Озвучка»; озвучиваются первые 1500 знаков, ссылки и картинки остаются в тексте.
  • Telegram. Создайте бота у @BotFather (/newbot), вставьте токен в карточку агента. Напишите боту /start — чат появится в списке; там же выбирается, кому отвечать и куда присылать выпуски. Бот помнит последние реплики каждого чата.
  • Яндекс Диск. Включите инструмент 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.