# Архитектура
Source: https://docs.ascn.ai/about-agent/architecture
Каждый агент состоит из трёх частей. Понять их — значит понять, как настроить агента под любую задачу.
![Структура агента в боковом меню]()
## 1. Мозг — личность и возможности
**Мозг** определяет, кто этот агент, что он знает и к чему подключён.
* **Интеграции** — Gmail, Google Календарь, Диск, Slack, GitHub и другие сервисы
* **Навыки** — готовые шаблоны поведения для повторяющихся задач
* **Знания** — как агент себя ведёт, что знает о вас и ваши файлы
* **Память** — факты, которые агент запомнил в ходе работы
## 2. Задания — что агент делает сам
**Задания** — это то, что агент выполняет без вашего участия.
| Тип | Когда запускается | Пример |
| ----------------- | --------------------------------- | --------------------------------- |
| **По расписанию** | В заданное время | Каждое утро в 8:00 — сводка писем |
| **По событию** | Когда что-то происходит в сервисе | Новое письмо → черновик ответа |
Задания создаются через чат — просто опишите, что нужно делать и когда.
## 3. Каналы — где вы общаетесь
**Каналы** — это где агент пишет вам и где вы можете ему написать.
* **Чат ASCN** — веб-интерфейс платформы
* **Telegram** — личный бот
* **Slack** — рабочее пространство команды
## Как всё это работает вместе
Например, агент по утренней почте:
1. **Мозг** — подключён к Gmail и Календарю, знает ваш рабочий стиль
2. **Задания** — каждое утро в 8:00 собирает важные письма
3. **Каналы** — присылает сводку в Telegram
Вы просыпаетесь и уже знаете, что важного пришло за ночь.
Начните с настройки Мозга — подключите первую интеграцию.
# Возможности
Source: https://docs.ascn.ai/about-agent/capabilities
Полный список того, что умеет ASCN Agent.
## Работа с почтой и календарём
* Читать и анализировать входящие Gmail
* Писать черновики ответов в вашем стиле
* Отправлять письма по команде
* Создавать и редактировать встречи в Google Календаре
* Присылать брифинг перед каждой встречей
## Работа с файлами
* Читать документы из Google Диска
* Отвечать на вопросы по вашим файлам
* Создавать и редактировать файлы в рабочем пространстве
* Извлекать данные из PDF, таблиц и других форматов
## Командная работа
* Работать в Slack-каналах команды
* Присылать уведомления в Telegram-группы
* Отслеживать активность в GitHub-репозиториях
* Создавать задачи и обращения по результатам встреч
## Автоматизации
Выполнять действия в заданное время или с заданной периодичностью.
Реагировать на события в подключённых сервисах.
## Поиск и анализ
* Поиск в интернете с анализом результатов
* Мониторинг упоминаний бренда
* Анализ конкурентов
* Сбор трендов из Reddit, X и других источников
## Генерация контента
* Писать тексты для соцсетей и блогов
* Генерировать изображения
* Создавать структурированные отчёты и сводки
## Расширяемость
Добавьте готовые сценарии или создайте свои.
Подключите собственные сервисы через API.
# Безопасность
Source: https://docs.ascn.ai/about-agent/security
Как ASCN Agent работает с вашими данными, токенами и разрешениями.
## Принципы
* **Каждый агент работает отдельно** — данные одного агента недоступны другому
* **Пароли и ключи хранятся в зашифрованном виде** — никто, кроме вас, к ним не имеет доступа
* **Вы сами решаете, что агент может делать** — отправлять письма, удалять файлы, создавать события — каждое действие требует вашего разрешения
* **Доступ можно отозвать в любой момент** — отключите любой сервис или удалите агента полностью
## Что агент не делает без вашего разрешения
* Не отправляет письма
* Не делится вашими данными с другими пользователями
* Не использует ваши данные для обучения моделей ИИ
## Где этим управлять
Выберите, что агент может делать самостоятельно, а что — только с вашего подтверждения.
Безопасное хранение токенов и ключей от сервисов.
Сброс агента и полное удаление всех его данных.
Что агент помнит о вас и как это удалить.
# use-cases
Source: https://docs.ascn.ai/about-agent/use-cases
Реальные примеры, как люди и команды используют ASCN Agent.
## Для личной продуктивности
Каждый вечер агент читает входящие и присылает только важное в Telegram.
Сохраняет контакты и присылает брифинг перед каждой встречей.
«Отправь письмо Ивану», «забронируй встречу» — без открытия браузера.
Фиксирует договорённости и ставит задачи после звонков.
## Для бизнеса и команд
Проверяет Gmail и Telegram, отвечает на типовые вопросы, эскалирует сложные.
Собирает данные из CRM, рекламы и GitHub в утреннюю сводку.
Ищет упоминания компании в сети и классифицирует по тональности.
Следит за активностью конкурентов и присылает дайджест.
## Для маркетинга и контента
Находит тренды, пишет тексты и генерирует изображения.
Сканирует Reddit и X, выдаёт список проблем ЦА.
Разбор реального кейса: агент по почте и календарю.
# Как устроен агент
Source: https://docs.ascn.ai/architecture/overview
Три уровня архитектуры ASCN Agent: Мозг, Задачи, Каналы.
Каждый ASCN Agent состоит из трёх уровней. Понять их — значит понять, как настроить агента под любую задачу.
В боковом меню агента видны три ключевых раздела: **Мозг** (①), **Каналы** (②) и **Задачи** (③) — каждый отвечает за свой уровень.
![Структура агента в боковом меню]()
***
## Мозг — центр управления
**Мозг** — это то, что определяет личность агента, его знания и возможности.
Здесь вы настраиваете:
* **Интеграции** — к каким сервисам агент имеет доступ: Gmail, Google Calendar, Google Drive, Slack, GitHub
* **Скиллы** — повторяемые сценарии поведения для типовых задач
* **База знаний** — кто этот агент, как он общается, какие файлы и документы он использует
* **Память** — что агент помнит о вас между сессиями
Мозг — это настройка один раз. После подключения интеграций и заполнения базы знаний агент готов работать без повторных инструкций.
***
## Задачи — автоматизации
**Задачи** — это то, что агент делает сам, без вашего участия.
Два вида задач:
| Тип | Пример |
| ------------------------ | --------------------------------------------------- |
| **По расписанию** | Каждое утро в 8:00 — сводка непрочитанных писем |
| **По событию (триггер)** | Пришло новое письмо → агент готовит черновик ответа |
Задачи создаются через чат — просто опишите, что нужно делать и когда.
***
## Каналы — где общаться с агентом
**Каналы** — это где вы общаетесь с агентом и где он вам отвечает.
Доступные каналы:
* **Чат ASCN** — веб-интерфейс платформы
* **Telegram** — бот, которого вы создаёте через BotFather
* **Slack** — рабочее пространство вашей команды
Подключите Telegram, чтобы управлять агентом и получать уведомления прямо в мессенджере — без открытия браузера.
***
## Как уровни работают вместе
**Пример: агент по утренней почте**
1. **Мозг** — подключён к Gmail и Google Calendar, знает ваш рабочий стиль
2. **Задачи** — каждый день в 8:00 агент читает входящие и формирует сводку
3. **Каналы** — сводка приходит вам в Telegram
Вы просыпаетесь и уже знаете, что важного пришло за ночь.
***
Начните с настройки Мозга — подключите первую интеграцию.
# Подключения
Source: https://docs.ascn.ai/brain/connectors
Gmail, Slack, Google Диск — подключи раз, агент использует сам.
**Подключение** — это провод между агентом и сервисом, которым ты уже пользуешься. Подключил Gmail — агент читает письма и отвечает. Подключил Slack — пишет в каналы. Без подключения агент работает вслепую.
## Что уже работает без настройки
Две вещи доступны агенту сразу, из коробки:
* **Поиск в интернете** — находит актуальную информацию по любому запросу
* **Чтение страниц** — открывает любую публичную ссылку и читает содержимое
## Что можно подключить
| Сервис | Что агент сделает за тебя |
| ------------------------ | ----------------------------------------------------- |
| **Gmail** | Читает, пишет черновики, отправляет, сортирует |
| **Google Календарь** | Видит встречи, создаёт и обновляет события |
| **Google Диск** | Открывает файлы, создаёт новые, следит за изменениями |
| **Google Docs / Sheets** | Читает и редактирует документы |
| **Slack** | Читает каналы и пишет сообщения |
| **GitHub / GitLab** | Смотрит задачи, ветки, запросы на слияние |
| **Notion / Supabase** | Работает со страницами и базами данных |
Нужного сервиса нет в списке? Его можно подключить вручную — об этом ниже.
## Самый быстрый способ — через чат
Просто напиши агенту что хочешь сделать. Он сам поймёт что подключить и попросит войти в аккаунт.
```text theme={null}
Подключи мой Gmail и каждый вечер присылай сводку важных писем
```
```text theme={null}
Следи за моим Календарём и напоминай о встречах за час
```
Авторизация происходит прямо в чате — одно нажатие, и готово.
## Подключить вручную
Если хочешь настроить сам:
1. Открой **Мозг → Подключения**
2. Найди нужный сервис
3. Нажми **+ Добавить**
4. Разреши запрошенный доступ
![Раздел Мозг → Подключения с кнопками «+ Добавить»]()
После подключения агент сам предложит что с этим можно сделать.
## Подключить нестандартный сервис
Для разработчиков: если нужного сервиса нет в списке — его можно добавить через открытый стандарт подключения инструментов (MCP).
1. В разделе **Дополнительные подключения** нажми **+ Добавить**
2. Укажи адрес сервера
3. Агент получит доступ к его инструментам
## Управление подключёнными сервисами
Каждое подключение можно в любой момент:
* **Сменить аккаунт** — привязать другую учётную запись
* **Отключить** — поставить на паузу
* **Удалить** — убрать полностью
> ⚠️ Если удалишь подключение, все задания которые его используют — перестанут работать. Лучше сначала отключи, убедись что ничего не сломалось — и только потом удаляй.
# База знаний
Source: https://docs.ascn.ai/brain/knowledge
Всё что агент знает о себе и о тебе — ещё до первого сообщения.
База знаний — это то, что агент читает перед тем как ответить. Кто он, как себя ведёт, что ты предпочитаешь, какие документы использовать. Без этого агент — умный, но незнакомец.
![Раздел Мозг → База знаний]()
## Что здесь есть
**Ядро** — три системных файла: IDENTITY.md, SOUL.md и USER.md. Отвечают за характер, ценности и всё что агент знает о тебе.
**Документы** — справочные файлы: списки клиентов, шаблоны, инструкции, регламенты. Загружаются через **+ Добавить** или перетаскиванием.
***
### IDENTITY.md — кто твой агент
Должностная инструкция. Здесь задаёшь роль, стиль общения и что агент делает, а что — нет. Агент читает этот файл при каждом запуске.
```markdown theme={null}
# Роль
Ты — ассистент по почте и встречам.
## Стиль
- Краткие ответы: максимум 3-4 предложения, если не попросят больше
- При неопределённости — уточняй, не угадывай
- Деловой тон, без лишних вступлений
## Фокус
- Почта и встречи: приоритет — задачи с дедлайнами
- Напоминания по срокам
- Подготовка к встречам
```
***
### USER.md — информация о тебе
Всё что агент должен знать о тебе: имя, проекты, предпочтения, часовой пояс. Агент дополняет этот файл сам по ходу общения — но лучше заполнить сразу.
```markdown theme={null}
# О пользователе
Имя: [имя]
Обращение: на «ты»
## Проекты
- Основной: [название]
- Дедлайн: [дата]
## Предпочтения
- Краткие ответы, без воды
- Часовой пояс: UTC+3
- Утром — только самое важное
```
Чтобы агент запомнил что-то прямо сейчас — скажи ему в чате:
```text theme={null}
Запомни: я предпочитаю получать ответы списком, без вступлений
```
Он обновит USER.md сам.
***
### SOUL.md — характер и приоритеты
Тонкая настройка. Как агент ведёт себя в неоднозначных ситуациях, что считает важным, где не соглашается автоматически.
```markdown theme={null}
## Ценности
- Честность важнее комфорта: лучше сказать неприятную правду
- Конкретика вместо общих слов: факты, числа, примеры
- Предлагай следующий шаг — не просто отвечай, а двигай вперёд
## Ограничения
- Не принимай решения за пользователя в важных вопросах — спрашивай
- Не соглашайся автоматически: если видишь проблему — говори
```
***
### Документы
Справочники которые агент использует при ответах: список клиентов, шаблоны писем, описание продукта, инструкции. Загружаются через **Документы → + Добавить** или перетаскиванием.
***
> Чем база знаний отличается от памяти — читай в разделе [Память](/brain/memory).
# Память
Source: https://docs.ascn.ai/brain/memory
Как агент запоминает информацию между сессиями.
**Память** — это то, что агент узнаёт о вас в процессе работы и сохраняет между сессиями. В отличие от базы знаний, которую вы заполняете вручную, память формируется автоматически.
## Как работает память
В ходе разговоров агент запоминает:
* Упомянутые вами предпочтения и детали
* Контекст текущих задач и проектов
* Ваш стиль общения и реакции на ответы
Эта информация сохраняется и используется в следующих сессиях — вам не нужно повторять одно и то же каждый раз.
## Как управлять памятью
**Чтобы агент запомнил что-то конкретное**, скажите ему прямо в чате:
```
Запомни: я предпочитаю краткие ответы без вступлений.
```
```
Запомни: встречи в пятницу я не назначаю принципиально.
```
Агент обновит ваш профиль и будет учитывать это в дальнейшем.
**Чтобы агент забыл информацию**, также скажите ему:
```
Забудь, что я говорил про проект X — он отменён.
```
## Чем память отличается от базы знаний
| Память | База знаний |
| --------------------------- | ------------------------------------ |
| Формируется автоматически | Вы заполняете вручную |
| Личные детали из разговоров | Справочная информация, роли, правила |
| Меняется со временем | Остаётся стабильной |
## Приоритет при конфликте
Информация из базы знаний имеет приоритет над памятью. Если в разговоре вы сказали одно, а в файлах базы знаний написано другое — агент следует базе знаний.
**Пример конфликта:**
> В SOUL.md: «Никогда не создавай встречи без явного подтверждения»\
> В разговоре: «Запишись на встречу с Иваном на пятницу»\
> Результат: агент предложит детали встречи для подтверждения, но не создаст её автоматически
Это позволяет зафиксировать важные ограничения раз и навсегда — они не «перезаписываются» случайной фразой в чате.
# Мозг: обзор
Source: https://docs.ascn.ai/brain/overview
Центральный блок настройки агента — здесь вы объясняете ему кто он, что умеет и к чему подключён.
**Мозг** — это центр управления вашим агентом. Здесь вы задаёте, к чему он подключён, как себя ведёт и что знает о вас и вашей работе.
![Раздел Мозг раскрыт в боковом меню: Интеграции, Навыки, Знания, Память]()
## Что входит в Мозг
Внешние сервисы, к которым подключён агент. Например: Gmail, Google Календарь, Slack, GitHub. Агент читает данные из них и выполняет действия — отвечает на письма, создаёт события, постит в канал.
Готовые шаблоны поведения для повторяющихся задач. Например: «составлять краткое саммари после каждой встречи» или «отвечать на входящие по шаблону поддержки». Можно добавить из библиотеки или создать свои через чат.
Всё, что агент знает о вас и вашей работе. Например: как вас зовут, в какой компании работаете, какой тон общения предпочитаете, какие документы использует агент как справочник.
То, что агент запомнил в ходе разговоров. Например: «Alex предпочитает короткие сводки» или «встречи по понедельникам не трогать». Сохраняется между сессиями автоматически.
## Как открыть Мозг
1. Войдите в ASCN и откройте нужного агента
2. Перейдите в раздел **Мозг** в боковом меню
## Рекомендованный порядок настройки
1. **Интеграции** — подключите сервисы, которые нужны для задачи. Например, Gmail и Google Календарь для агента по почте.
2. **Знания** — объясните агенту кто он и расскажите о себе. Например: «Ты помощник Alex, менеджера по продажам. Пиши коротко и по делу».
3. **Навыки** — добавьте, если нужна специфическая логика. Например, навык «еженедельный отчёт по сделкам».
4. **Память** — работает автоматически, вмешиваться не нужно.
# Скиллы
Source: https://docs.ascn.ai/brain/skills
Научи агента один раз — он запомнит навсегда.
Скилл — это память на поведение. Объяснил агенту как делать сводку почты, как оформлять отчёт, как реагировать на запросы клиентов — он запомнил и повторяет. Не нужно каждый раз объяснять заново.
![Раздел Мозг → Скиллы]()
## Готовые скиллы и свои
В **Мозг → Скиллы** два раздела.
**Open Source скиллы** — библиотека от ASCN и сообщества. Нашёл нужный, нажал **+ Установить**. Например, скилл `pdf` даёт агенту работать с PDF-файлами: читать, заполнять формы, шифровать. Скилл `creating-financial-models` — строить DCF и считать сценарии. Таких скиллов десятки.
**Мои скиллы** — то, чему ты сам научил агента. Изначально пусто.
## Примеры скиллов
| Скилл | Что делает |
| --------------------- | ------------------------------------------------------------------------------------------ |
| **email-digest** | Собирает сводку писем: группирует по отправителю, выделяет важные, пропускает рассылки |
| **meeting-prep** | Перед встречей достаёт из календаря участников, ищет о них инфу, присылает краткую справку |
| **crm-update** | После звонка или письма сам обновляет карточку клиента в CRM |
| **daily-brief** | Каждое утро в заданное время присылает сводку: задачи, встречи, важные письма |
| **invoice-tracker** | Следит за входящими счетами, напоминает об оплате, помечает просроченные |
| **social-reply** | Отвечает на типовые комментарии и вопросы в соцсетях по заданному тону |
| **lead-qualifier** | Оценивает входящие заявки по критериям и расставляет приоритеты |
| **content-repurpose** | Из длинной статьи делает пост для Telegram, тред для X и письмо для рассылки |
| **support-triage** | Сортирует входящие обращения по теме и срочности, отвечает на типовые сам |
| **weekly-report** | В конце недели собирает данные из таблиц и присылает итоговый отчёт |
## Как создать свой
Просто напиши в чате что агент должен делать. Он разберётся и создаст скилл сам.
```text theme={null}
Создай скилл: когда прошу сводку почты — группируй по отправителю,
выдели письма с дедлайнами или вопросами ко мне, рассылки пропусти
```
Готовый скилл появится в **Мои скиллы**. Можно открыть, посмотреть, подправить.
Если хочешь создать вручную — кнопка **+ Добавить** там же.
## Где это хранится
Все скиллы лежат в файлах агента по пути `.agents/skills/` — раздел **Файлы**. Текстовые файлы, можно редактировать напрямую.
# Slack
Source: https://docs.ascn.ai/channels/slack
Подключите агента к Slack и работайте с ним прямо в рабочем пространстве команды.
Slack позволяет общаться с агентом прямо в рабочем пространстве вашей команды — задавать вопросы, получать уведомления и давать команды, не выходя из привычной среды.
## Как подключить Slack
1. Откройте раздел **Каналы** в настройках агента
2. Выберите **Slack**
3. Нажмите **Подключить**
4. Авторизуйтесь в своём Slack-аккаунте и выберите рабочее пространство
5. Подтвердите запрошенные разрешения
После подключения агент появится в вашем Slack как приложение.
## Что можно делать через Slack
* Задавать вопросы и получать ответы в личном сообщении агента
* Давать команды: «проверь почту», «что у меня в календаре?», «пришли сводку»
* Получать уведомления от триггеров и задач по расписанию
* Отправлять сообщения в каналы через агента (если интеграция Slack подключена в Мозге)
**Пример команд:**
```text theme={null}
Какие встречи у меня завтра?
```
```text theme={null}
Отправь в канал #general: "Ежедневный синк переносится на 15:00."
```
```text theme={null}
Проверь почту и пришли сводку важных писем за сегодня.
```
Для отправки сообщений в Slack-каналы через агента дополнительно подключите **интеграцию Slack** в разделе **Мозг → Интеграции**.
# Telegram
Source: https://docs.ascn.ai/channels/telegram
Подключите агента к Telegram: личный чат, группа, канал или личный аккаунт.
Telegram — самый удобный способ взаимодействовать с агентом вне браузера: получать уведомления, задавать вопросы и давать команды прямо из мессенджера.
## Личный чат с ботом
### Шаг 1. Создайте бота через BotFather
Откройте [@BotFather](https://t.me/BotFather) в Telegram и создайте нового бота. ASCN покажет пошаговую инструкцию прямо в интерфейсе.
![Диалог с BotFather — /newbot, имя, username и получение токена]()
### Шаг 2. Следуйте инструкции в ASCN
Откройте **Каналы → Telegram**. ASCN запустит мастер подключения:
1. Откройте BotFather в Telegram — кнопка **Открыть @BotFather**
2. Отправьте команду `/newbot`
3. Выберите отображаемое имя бота
4. Выберите username (должен заканчиваться на `_bot`)
5. Скопируйте токен — BotFather пришлёт его в чат
![Мастер подключения Telegram в ASCN — 5 шагов]()
### Шаг 3. Вставьте токен
Нажмите **У меня есть токен →**, вставьте токен в поле. Можно вставить всё сообщение от BotFather целиком — ASCN извлечёт токен автоматически.
Нажмите **Подключить бота**.
![Ввод токена и кнопка «Подключить бота»]()
### Шаг 4. Подтвердите владение
После подключения ASCN попросит верифицировать бота:
1. Нажмите **Открыть бота в Telegram**
2. Нажмите **Старт** в открывшемся диалоге — это свяжет ваш аккаунт с агентом
![Подтверждение: открыть бота и нажать Старт]()
### Готово
После нажатия Старт бот поприветствует вас и предложит быстро подключить интеграции прямо в Telegram.
![Бот в Telegram после /start — кнопки подключения сервисов]()
***
## Подключение к группе или каналу
Агента можно добавить в Telegram-группу или канал — для командной работы или публикации уведомлений.
### Шаг 1. Добавьте бота в группу или канал
1. Откройте настройки группы/канала → **Администраторы** → **Добавить администратора**
2. Найдите вашего бота по username и добавьте
3. Выдайте права: **Отправка сообщений** (для группы) или **Публикация** (для канала)
### Шаг 2. Получите ID чата
**Простой способ:** добавьте бота [@RawDataBot](https://t.me/RawDataBot) в группу или канал — он сразу пришлёт сообщение с `chat.id`, скопируйте его. После получения ID удалите @RawDataBot из группы.
**Альтернатива:** напишите любое сообщение в группе/канале, затем откройте:
```
https://api.telegram.org/bot<ВАШ_ТОКЕН>/getUpdates
```
В ответе найдите поле `chat.id` (для каналов начинается с `-100`).
### Шаг 3. Укажите ID в ASCN
В разделе **Каналы → Telegram** введите Chat ID и нажмите **Сохранить**.
В группах агент отвечает на сообщения, адресованные боту через @username, или в ответ на его сообщения — чтобы не засорять общий чат.
***
## Подключение к личному аккаунту Telegram
Возможность Telegram позволяет агенту работать от имени вашего личного аккаунта — не как бот, а как вы сами.
**Что агент получает при подключении личного аккаунта:**
* Доступ к вашим чатам и переписке
* Возможность отправлять сообщения от вашего имени по команде или триггеру
* Видит все входящие, включая личные переписки
**Агент НЕ делает автоматически**: не отвечает в чатах без явной команды или настроенного триггера.
Рекомендация: если хотите сохранить разделение — используйте отдельный Telegram-аккаунт специально для агента.
### Как подключить
1. Перейдите в **Каналы → Telegram**
2. Выберите вкладку **Личный аккаунт**
3. Нажмите **Подключить аккаунт**
4. Введите номер телефона и подтвердите код из Telegram
После подключения агент сможет читать входящие, отправлять сообщения от вашего имени и реагировать на упоминания.
***
## Что можно делать через Telegram
* Задавать вопросы и получать ответы
* Давать команды: «отправь письмо», «забронируй встречу», «что у меня сегодня?»
* Получать уведомления от триггеров и задач по расписанию
* Загружать файлы и изображения прямо в чат
**Примеры команд:**
```
Что у меня в почте за сегодня?
```
```
Отправь письмо Ивану Петрову: подтверждаю встречу на пятницу в 15:00.
```
```
Запишись на встречу с командой завтра в 11:00, название "Синк по продукту".
```
Удобный паттерн: триггер на важные письма — мгновенное уведомление в Telegram, утренняя сводка — задача по расписанию прямо в чат.
# ASCN.AI API — Документация
Source: https://docs.ascn.ai/crypto/overview
Программный доступ к крипто-аналитике институционального уровня в реальном времени.
## ✨ Введение
Добро пожаловать в ASCN.AI Assistant API! Наша цель — предоставить программный доступ к крипто-аналитике институционального уровня в реальном времени. API преобразует сложные on-chain данные с более чем 20 блокчейнов, а также данные социальных сетей и новостных источников, в готовые к применению инсайты — через простые запросы на естественном языке.
Строите торговых ботов, трекеры портфеля или AI-инструменты для управления сообществом — наш API даёт скорость, точность и глубину, которые нужны, чтобы быть на шаг впереди.
***
## 🚀 Начало работы
### Шаг 1. Получите API-ключ
**Быстрый вариант** — запросить напрямую в [поддержке в Telegram](https://t.me/ascnai).
**Более полезный вариант** — зарегистрироваться на [B2B-платформе](https://b2b.ascn.ai), ознакомиться с планами и выбрать Free. Так вы получите доступ к подробным логам запросов, информации о расходе кредитов и возможности мгновенно перейти на платный план.
### Шаг 2. Выполните первый запрос
Откройте терминал и выполните команду. Замените `YOUR_API_KEY` на ваш ключ.
```bash theme={null}
curl --request POST \
--url 'https://b2b.api.ascn.ai/api/ai-assistant/v2/invoke_assistant' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{
"message": "Сделай краткий анализ PEPE: цена, объём, настроения",
"model": "ascn_v1.2"
}'
```
### Шаг 3. Посмотрите ответ
Вы получите JSON с анализом монеты PEPE в реальном времени: рыночные метрики, on-chain активность и оценку настроений. Полная структура ответа описана в разделе [Схема ответа](#схема-ответа).
***
## 🔓 Аутентификация
Все запросы к API должны быть аутентифицированы. Передавайте ключ в заголовке `X-API-Key` каждого запроса.
```text theme={null}
X-API-Key: YOUR_API_KEY
```
API-ключ — секрет. Не публикуйте его в клиентском коде (браузеры, мобильные приложения). Все запросы к API должны выполняться с защищённого сервера.
## 🟢 Коды ответов
| Код | Значение | Описание |
| ----- | --------------------- | ------------------------------------------------------------------- |
| `200` | OK | Запрос успешен. |
| `400` | Bad Request | Неверный формат запроса или отсутствуют обязательные параметры. |
| `401` | Unauthorized | Неверный или отсутствующий API-ключ. |
| `403` | Forbidden | У ключа нет прав на это действие. |
| `429` | Too Many Requests | Превышен лимит запросов — см. [Лимиты запросов](#-лимиты-запросов). |
| `500` | Internal Server Error | Ошибка на сервере. Попробуйте позже. |
Пример ответа с ошибкой:
```json theme={null}
{ "detail": "Authentication credentials were not provided." }
```
***
## 🧠 Возможности
### Рыночные данные в реальном времени
Данные с более чем 20 блокчейнов: ценовые графики, объём, капитализация и технический анализ любого токена.
### Анализ токена
Потоки токенов (CEX), балансы холдеров (топ-адреса, киты, фонды), крупнейшие переводы, активность покупателей и продавцов.
### On-chain анализ
Мониторинг DeFi-позиций, трекинг DEX-сделок и выявление прибыльных кошельков на 20+ блокчейнах, включая EVM-сети и Solana.
### Бессрочные контракты (DEX)
Инсайты по DEX-фьючерсному рынку в реальном времени. Отслеживайте топ-трейдеров на Hyperliquid, их стратегии, открытые позиции, плечо, P/L и историю сделок.
### Анализ настроений
Анализ Telegram-сообществ и новостных медиа — чёткая картина позитивных и негативных настроений по любой монете.
### Веб-поиск
AI-ассистент выполняет расширенные поиски для сбора публичной информации о проектах, командах и рыночных трендах.
***
## 📜 Шаблоны использования
| Сценарий | Описание | Используемые функции |
| --------------------------- | -------------------------------------------------------------------------------- | -------------------------------------------------- |
| Торговый бот | Бот, торгующий на основе рыночных данных, on-chain событий и анализа настроений. | `Рыночные данные`, `On-chain анализ`, `Настроения` |
| Трекер портфеля | Обзор криптоактивов, DeFi-позиций и исторической доходности с AI-инсайтами. | `On-chain анализ` |
| Дашборд настроений | Визуализация настроений рынка по конкретным монетам. | `Анализ настроений` |
| Управление сообществом | AI-ассистент для Telegram/Discord, отвечающий на вопросы о рынке. | `Веб-поиск`, `Рыночные данные` |
| Инструмент due diligence | Глубокий анализ новых токенов: распределение холдеров, потоки умных денег. | `Анализ токена` |
| Исследовательский ассистент | Объединяет on-chain данные, метрики, настроения и веб-информацию. | `Анализ токена`, `Веб-поиск` |
***
## 📚 API Reference
**Base URL:** `https://b2b.api.ascn.ai`
| Метод | Эндпоинт | Назначение |
| ------ | ---------------------------------------------- | ---------------------------- |
| `POST` | `/api/ai-assistant/v2/invoke_assistant` | Полный ответ одним запросом. |
| `POST` | `/api/ai-assistant/v2/invoke_assistant_stream` | Потоковый ответ через SSE. |
### POST /invoke\_assistant
Отправляет сообщение AI-ассистенту и возвращает полный структурированный анализ за один запрос.
**Тело запроса**
| Параметр | Тип | Описание |
| -------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `message` | string | Вопрос или сообщение для AI-ассистента на естественном языке. Обязателен во всех запросах, **кроме** ответа на HIL-запрос — там достаточно `chat_id` + `hil_response`. |
| `chat_id` | uuid | Опционально. ID существующего чата для продолжения разговора. **Обязателен** при ответе на HIL-запрос. |
| `model` | string | Опционально. Модель AI. По умолчанию: `ascn_v1.2`. |
| `auto_hil` | bool | Опционально. По умолчанию `false`. При `true` сервис сам разрешает неоднозначность (берёт первый вариант) и возвращает готовый `content`. Только для sync-режима. |
| `hil_response` | object | Опционально. Ответ пользователя на HIL-запрос — см. [Продолжение диалога после HIL](#продолжение-диалога-после-hil). |
**Пример запроса**
```json theme={null}
{
"message": "Сделай глубокий on-chain и рыночный анализ DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 (BONK)",
"model": "ascn_v1.2"
}
```
#### Схема ответа
| Поле | Тип | Когда приходит |
| ------------ | -------------- | ---------------------------------------------------------------------------- |
| `chat_id` | uuid | Всегда. |
| `chat_title` | string | Всегда. |
| `message_id` | string \| null | При финальном ответе. |
| `content` | string \| null | Когда ответ готов. |
| `hil` | object \| null | Когда ассистент ждёт выбор пользователя — см. [HIL](#hil-human-in-the-loop). |
| `error` | string \| null | При ошибке. |
В одном ответе приходит **либо** `content` (ответ готов), **либо** `hil` (нужен ввод пользователя) — но не оба одновременно.
**Пример: ответ готов**
```json theme={null}
{
"chat_id": "6f1c2a9e-0b3d-4f27-9c51-8ad2e7b4c910",
"chat_title": "Анализ BONK",
"message_id": "msg_01H9Z7",
"content": "BONK торгуется на уровне ...",
"hil": null,
"error": null
}
```
**Пример: требуется выбор пользователя**
```json theme={null}
{
"chat_id": "6f1c2a9e-0b3d-4f27-9c51-8ad2e7b4c910",
"chat_title": "Анализ PEPE",
"message_id": null,
"content": null,
"hil": {
"type": "token_select",
"description": "Найдено несколько токенов с тикером PEPE. Выберите нужный.",
"choices": [
{
"name": "Pepe",
"symbol": "PEPE",
"main_chain": "ethereum",
"price_usd": 0.0000112,
"market_cap_usd": 4700000000
},
{
"name": "Pepe on Solana",
"symbol": "PEPE",
"main_chain": "solana",
"price_usd": 0.0000004,
"market_cap_usd": 1200000
}
]
},
"error": null
}
```
### HIL (Human-in-the-Loop)
Ассистент может приостановить обработку и запросить у пользователя уточнение — например, выбрать конкретный токен, когда тикер неоднозначен. В этом случае финального `content` в ответе нет, вместо него приходит объект `hil`.
**Объект `hil`**
| Поле | Тип | Описание |
| ------------- | --------------- | -------------------------------------------------------------- |
| `type` | string | Тип запроса. Например, `"token_select"`. |
| `description` | string | Пояснение для пользователя: что именно нужно выбрать и почему. |
| `choices` | array of object | Список вариантов на выбор. |
Поля элемента `choices` совпадают с полями элемента `hil_response.chosen` (см. ниже).
#### Продолжение диалога после HIL
Чтобы продолжить, отправьте новый запрос на тот же эндпоинт, передав выбор пользователя:
| Параметр | Тип | Описание |
| --------------------- | ----- | ----------------------------------------------------- |
| `chat_id` | uuid | **Обязателен.** ID чата, в котором пришёл HIL-запрос. |
| `hil_response.chosen` | array | Выбранные пользователем варианты. |
| `message` | — | Можно опустить: контекст берётся из чата. |
Поля элемента `hil_response.chosen` (все опциональны — достаточно передать те, что однозначно идентифицируют вариант):
| Поле | Тип |
| ---------------- | ------ |
| `name` | string |
| `symbol` | string |
| `logo_url` | string |
| `main_chain` | string |
| `contracts` | array |
| `price_usd` | number |
| `market_cap_usd` | number |
| `description` | string |
**Пример ответа на HIL-запрос**
```json theme={null}
{
"chat_id": "6f1c2a9e-0b3d-4f27-9c51-8ad2e7b4c910",
"hil_response": {
"chosen": [
{
"name": "Pepe",
"symbol": "PEPE",
"main_chain": "ethereum"
}
]
}
}
```
#### Автоматический выбор: auto\_hil
Если интерактивный выбор в вашем сценарии не нужен, передайте `auto_hil: true` в исходном запросе. Сервис сам возьмёт первый вариант из `choices` и вернёт готовый `content` — без промежуточного HIL-ответа.
`auto_hil` работает только в sync-режиме (`/invoke_assistant`). В стриминге параметр игнорируется — HIL-события нужно обрабатывать на стороне клиента.
### POST /invoke\_assistant\_stream
Для приложений реального времени — SSE-поток, который отдаёт части ответа по мере генерации. Тело запроса такое же, как у `/invoke_assistant`, за исключением `auto_hil` (не применяется).
**События потока**
| Событие | Данные | Описание |
| -------------------- | ----------------------------------------------------------- | ---------------------------------------------- |
| `chat` | `{"chat_id": "...", "chat_title": "..."}` | Контекст чата в начале потока. |
| `pending_tool_call` | `{"call_id": "...", "title": {...}}` | Внутренний инструмент вызван для сбора данных. |
| `finished_tool_call` | `{"call_id": "..."}` | Инструмент завершил работу. |
| `message_start` | `{"t": "..."}` | Контент сообщения в процессе генерации. |
| `message_end` | `{"message_id": "..."}` | Текущее сообщение завершено. |
| `hil` | `{"type": "...", "description": "...", "choices": [ ... ]}` | Ассистент ждёт выбор пользователя. |
| `finish` | `null` | Завершение всего потока. |
**Событие `hil`**
```text theme={null}
event: hil
data: {"type": "token_select", "description": "Найдено несколько токенов с тикером PEPE. Выберите нужный.", "choices": [ ... ]}
```
Клиент обязан обрабатывать событие `hil`. Структура `data` совпадает с полем `hil` в sync-ответе. После получения события продолжите диалог **новым** запросом с `chat_id` и `hil_response` — так же, как в sync-режиме.
***
## 📌 О сервисе
### 🔴 Лимиты запросов
| Тариф | Запросов в минуту |
| ---------- | ----------------- |
| Free | 60 |
| Pro | 300 |
| Enterprise | Индивидуально |
При превышении лимита — HTTP `429 Too Many Requests`. Рекомендуем реализовать повторные попытки с экспоненциальной задержкой.
Подробности о тарифах и кредитах — на [странице цен](https://arbitragescanner.io/crypto-api).
### ⛓️ Поддерживаемые блокчейны
| Категория | Блокчейны |
| --------- | -------------------------------------------------------------------------- |
| EVM-сети | Ethereum, BNB Chain, Polygon, Arbitrum, Optimism, Avalanche, Base и другие |
| Solana | Полная поддержка: on-chain данные, DEX-сделки, DeFi-анализ |
| Другие | Популярные блокчейны вне EVM |
***
## 🙋 FAQ
**Какие языки программирования поддерживаются?** API не зависит от языка. Используйте любой, поддерживающий HTTP-запросы.
**Можно ли использовать API в коммерческих целях?** Да. Подробности — в [Условиях использования](https://ascn.ai/terms).
**Чем отличается `invoke_assistant` от `invoke_assistant_stream`?** `invoke_assistant` возвращает полный ответ за один запрос. `invoke_assistant_stream` стримит ответ через SSE — подходит для интерактивных приложений.
**Почему в ответе нет `content`?** Скорее всего, ассистент запросил уточнение — проверьте поле `hil` и продолжите диалог с `chat_id` + `hil_response`. Если интерактивный выбор не нужен, передавайте `auto_hil: true` (только в sync-режиме). См. [HIL](#hil-human-in-the-loop).
**Есть ли поддержка?** Да — [info@ascn.ai](mailto:info@ascn.ai), [Telegram](https://t.me/Ascn_support_bot).
***
## 🔗 Ссылки
* **Сайт:** [https://ascn.ai](https://ascn.ai)
* **B2B-платформа:** [https://b2b.ascn.ai](https://b2b.ascn.ai)
# Быстрый старт
Source: https://docs.ascn.ai/getting-started/quickstart
Создайте своего первого агента за 5 минут.
## Шаг 1. Создайте аккаунт
Перейдите на [ascn.ai](https://ascn.ai/ru/agent) и нажмите **Попробовать бесплатно**. Регистрация занимает меньше минуты.
## Шаг 2. Создайте первого агента
На главной странице нажмите **+ Создать новый** в правом верхнем углу.
![Выбор агента в меню и кнопка «+ Создать новый»]()
## Шаг 3. Опишите задачу
Напишите агенту в чате, чем он должен заниматься. Чем конкретнее — тем лучше.
```text theme={null}
Следи за дедлайнами в моём Google Календаре. За день до дедлайна
напоминай мне о задаче и спрашивай, нужна ли помощь с подготовкой.
```
```text theme={null}
Каждое утро в 9:00 присылай мне сводку непрочитанных писем в Gmail
с кратким описанием каждого.
```
Начните с задачи, которую вы уже делаете вручную каждый день. Так быстрее всего почувствуете разницу.
## Шаг 4. Подключите нужные сервисы
Агент сам предложит подключить нужные сервисы после первого сообщения — просто следуйте его подсказкам в чате.
Если хотите подключить что-то самостоятельно — откройте раздел **Мозг**, выберите **Интеграции** и найдите нужный сервис.
![Раздел Мозг → Интеграции → Приложения]()
## Шаг 5. Готово
Агент уже работает. Пишите ему в чате ASCN или подключите [Telegram](/channels/telegram) — и общайтесь откуда удобно.
***
## Что дальше
Разберитесь в архитектуре: Мозг, Задания, Каналы.
Подключите Gmail, Календарь, Диск, Slack, GitHub.
Настройте автоматические утренние сводки и напоминания.
Пошаговая сборка агента по почте и календарю.
# Что такое ASCN Agent?
Source: https://docs.ascn.ai/getting-started/what-is-ascn-agent
Помощник на основе ИИ, который работает за вас — пока вы заняты другим.
ASCN Agent — это ваш личный помощник на основе ИИ. Вы объясняете ему что делать и к каким сервисам он имеет доступ. Дальше он работает сам: читает почту, следит за календарём, присылает нужное в Telegram или Slack — без вашего участия.
## Что он делает
Следит за входящими и делает то, что вы попросили: отвечает, пересылает, составляет черновик.
Каждый день в нужное время сам делает то, что вы настроили — без напоминаний с вашей стороны.
Загрузите файлы, таблицы или инструкции — агент изучит их и будет отвечать на основе ваших данных.
Присылает сводки и уведомления в Telegram, Slack или прямо в ASCN.
Работает с Gmail, Google Календарём, Google Диском, Slack, GitHub и другими.
Находит актуальные данные и присылает готовую выжимку — по запросу или по расписанию.
Например, вы можете написать агенту:
```text theme={null}
Каждое утро в 9:00 присылай мне сводку непрочитанных писем из Gmail
и список встреч на сегодня из Google Календаря.
```
И он будет делать это каждый день сам.
## Из чего он состоит
Агент — это три части:
1. **Мозг** — вы объясняете агенту кто он, к каким сервисам подключён и какие документы знает
2. **Задания** — что агент делает сам и когда: каждое утро, при новом письме, по вашему запросу
3. **Каналы** — где агент пишет вам: в ASCN, Telegram или Slack
Пошаговая инструкция — займёт не больше пяти минут.
# Агент по почте и календарю
Source: https://docs.ascn.ai/guides/email-calendar-agent
Пошаговая сборка агента, который читает почту, делает черновики, присылает утреннюю сводку и управляет встречами через Telegram.
В этом руководстве мы соберём с нуля агента, который:
* Читает Gmail и присылает утреннюю сводку
* Готовит черновики ответов на важные письма
* Видит встречи в Google Calendar и напоминает о них
* Принимает команды через Telegram
Время на настройку: **10–15 минут**.
***
## Шаг 1. Создайте агента и опишите задачу
1. Войдите в ASCN и перейдите к списку агентов
2. Нажмите **+ Создать новый**
3. В чате напишите задачу:
```text theme={null}
Ты — мой персональный ассистент по почте и встречам.
Твоя задача: следить за Gmail и Google Calendar,
готовить черновики ответов, присылать утренние сводки
и выполнять мои поручения через Telegram.
```
После первого сообщения агент сразу предложит подключить нужные интеграции прямо в чате.
![Чат с описанием задачи — агент предлагает подключить Gmail, Google Calendar и Telegram]()
***
## Шаг 2. Подключите интеграции
Прямо в чате нажмите кнопки подключения (①):
* **Gmail** → **Connect** — агент запросит доступ к почте
* **Google Calendar** → **Connect** — доступ к календарю
* **Telegram** → **Connect** — можно подключить сейчас или позже через раздел **Каналы**
После подключения кнопки покажут статус **Connected** (② ③).
***
## Шаг 3. Настройте личность агента через чат
Вставьте в чат правила поведения агента:
```text theme={null}
# Роль
Ты — персональный ассистент по почте и встречам.
## Стиль
- Краткие ответы — только суть
- Не пересказывай всё письмо, выдели главное и нужное действие
- При неопределённости — спрашивай, не угадывай
## Приоритеты при работе с почтой
1. Письма с дедлайнами или явными вопросами ко мне
2. Письма от конкретных людей (уточняй у меня список VIP)
3. Остальное — в сводку, без уведомлений
## Запрещено
- Отправлять письма без моего явного подтверждения
- Удалять письма или события без подтверждения
- Самостоятельно принимать решения о встречах
```
Агент сохранит эти правила и сразу начнёт работать по ним.
![Вставка правил поведения в чат — агент подтверждает и начинает работу]()
***
## Шаг 4. Расскажите агенту о себе
Вставьте в чат информацию о ваших предпочтениях:
```text theme={null}
# О пользователе
Имя: [ваше имя]
Обращение: на «ты»
Часовой пояс: UTC+3
## Предпочтения
- Утренняя сводка в 8:30
- Важные письма — уведомление сразу, остальное — в сводку
- Встречи подтверждать лично, не автоматически
```
Агент запомнит всё и подтвердит сохранение.
![Агент подтверждает сохранённые настройки пользователя]()
***
## Шаг 5. Подключите Telegram
Если не подключили на шаге 2 — перейдите в **Каналы → Telegram** и следуйте инструкции.
Подробно: [Как подключить Telegram](/channels/telegram).
***
## Шаг 6. Настройте утреннюю задачу
Напишите агенту в чате:
```text theme={null}
Каждый день в 8:30 делай следующее:
1. Проверь непрочитанные письма в Gmail за последние 12 часов
2. Составь краткую сводку: важные письма (с дедлайном или вопросом ко мне),
письма требующие ответа, остальное кратко одной строкой
3. Проверь Google Calendar на сегодня — список встреч с временем
4. Отправь мне сводку в Telegram
```
Агент создаст задачу по расписанию и начнёт выполнять её каждое утро.
***
## Готово — что получилось
| Функция | Как работает |
| ---------------------- | ------------------------------------------------------ |
| Утренняя сводка | Каждый день в 8:30 в Telegram: почта + встречи на день |
| Черновики ответов | По запросу в чате, с подтверждением перед отправкой |
| Напоминания о встречах | В составе утренней сводки |
| Создание встреч | По команде в Telegram или чате, с подтверждением |
| Ответы на вопросы | В реальном времени через Telegram или чат ASCN |
| Сортировка почты | По заданным приоритетам, без вашего участия |
**Следующий шаг:** добавьте триггер на письма от важных людей — тогда агент будет уведомлять вас мгновенно, не дожидаясь утренней сводки.
```text theme={null}
Когда приходит письмо от [имя клиента или коллеги],
немедленно уведоми меня в Telegram с кратким содержанием.
```
# API
Source: https://docs.ascn.ai/settings/api
Подключите внешние системы к агенту через API.
ASCN Agent предоставляет API для интеграции с внешними системами: запускайте беседы, отправляйте сообщения и получайте ответы программно.
![Раздел Настройки → API — Base URL, ключ авторизации и пример запроса]()
## Как получить доступ к API
1. Откройте **Настройки → API**
2. Скопируйте **Base URL** — он уникален для каждого воркспейса
3. Скопируйте **Ключ авторизации**
4. Используйте ключ в заголовке `Authorization: Bearer ...` с каждым запросом
## Базовый пример
```bash theme={null}
curl -X POST "https://api.clawman.ascn.ai/api/v1/workspaces/{workspace_id}/session/{session_id}/messages" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {API_KEY}" \
-d '{"content": "Проверь почту и пришли сводку"}'
```
## Методы API
| Метод | Эндпоинт | Описание |
| ------ | -------------------------------- | ---------------------------------------------- |
| `POST` | `/session/{session_id}/messages` | Отправить сообщение и получить стриминг ответа |
**Что такое session\_id:** каждый разговор с агентом — это сессия. `session_id` — уникальный идентификатор конкретного диалога. Вы можете создать новую сессию (новый диалог) или продолжить существующую, передав её ID. Если хотите каждый раз начинать новый разговор — генерируйте новый UUID для `session_id`.
## Сценарии использования
**Интеграция с вашим приложением.** Отправляйте задачи агенту из своего продукта и получайте результаты через API.
**Связь нескольких агентов.** Прямой связи между агентами нет, но вы можете использовать API как мост — один агент отправляет данные другому через API-запрос.
**Вебхуки и автоматизации.** Подключите ASCN Agent к Zapier, Make или собственным скриптам через API.
Base URL и ключ авторизации привязаны к конкретному воркспейсу. Для каждого агента они свои.
# Опасная зона
Source: https://docs.ascn.ai/settings/delete-agent
Перезапуск агента и удаление воркспейса.
В разделе **Настройки → Опасная зона** два действия: перезапуск агента и удаление воркспейса.
![Настройки → Опасная зона]()
***
## Перезапустить
Перезапускает процесс агента. Все активные сессии будут прерваны, но данные, настройки и задачи сохраняются.
Используйте если агент завис, ведёт себя неожиданно или не отвечает.
**Как перезапустить:**
1. Откройте **Настройки → Опасная зона**
2. Нажмите **Перезапустить**
***
## Удалить воркспейс
Полное и необратимое удаление агента. Восстановить данные после невозможно.
### Что будет удалено
* Все беседы и история чатов
* Настройки Мозга: интеграции, скиллы, база знаний, память
* Задачи и триггеры
* Подключённые каналы (Telegram-бот, Slack)
* Файлы, созданные агентом
* Секреты и ключи агента
Перед удалением сохраните всё, что хотите сохранить: скопируйте содержимое IDENTITY.md, SOUL.md и других файлов базы знаний.
### Как удалить воркспейс
1. Откройте **Настройки → Опасная зона**
2. Нажмите **Удалить воркспейс**
3. Подтвердите действие
***
## Альтернативы удалению
Если хотите начать заново, но сохранить часть настроек:
* **Отредактируйте IDENTITY.md / SOUL.md** — обновите роль и характер без пересоздания
* **Отключите ненужные интеграции** — уберите доступ к сервисам, которые больше не нужны
* **Удалите конкретные задачи** — через раздел **Задачи**
Полное удаление имеет смысл только если хотите стереть всю историю и начать с чистого листа.
# Разрешения инструментов
Source: https://docs.ascn.ai/settings/permissions
Управляйте тем, что агент может делать с файлами в воркспейсе.
**Разрешения инструментов** — это переключатели, которые определяют, может ли агент изменять или удалять файлы в **воркспейсе** (изолированная файловая среда вашего агента, где хранятся его данные и файлы).
![Раздел Настройки → Разрешения инструментов]()
## Доступные разрешения
| Разрешение | Описание |
| ------------------------------ | ---------------------------------------------------- |
| **Разрешить изменение файлов** | Агент может создавать и изменять файлы в воркспейсе |
| **Разрешить удаление файлов** | Агент может безвозвратно удалять файлы из воркспейса |
## Рекомендации
Если агент не должен самостоятельно менять файлы — отключите «Разрешить изменение файлов». Агент будет предлагать изменения, но применять их только вы.
* Разрешение удаления файлов стоит включать только если агент явно должен этим заниматься (например, очищать временные файлы по расписанию)
* Для агентов, которые только читают и отвечают на вопросы, оба разрешения можно оставить выключенными
# Секреты и ключи
Source: https://docs.ascn.ai/settings/secrets
Безопасное хранение токенов и API-ключей для внешних сервисов.
**Секреты** — это переменные окружения для безопасного хранения токенов, API-ключей и других учётных данных. Агент использует их при обращении к внешним сервисам, и они никогда не отображаются в открытом виде.
![Раздел Настройки → Секреты и ключи]()
## Когда нужны секреты
Секреты нужны, если вы подключаете собственные API или сервисы, которые требуют ключей авторизации. Например:
* API-ключ стороннего сервиса
* Токен корпоративного Slack или другого инструмента
* Ключи для вебхуков и интеграций
Стандартные коннекторы (Gmail, Google Calendar, Slack и др.) авторизуются через OAuth — секреты для них добавлять не нужно.
## Как добавить секрет
1. Откройте **Настройки → Секреты и ключи**
2. Нажмите **+ Добавить секрет**
3. Введите **название** (например, `API_KEY`) и **значение** — токен или ключ
4. Сохраните
## Как использовать секрет
После добавления секрет доступен агенту как переменная окружения по его названию. Укажите название в описании задачи или скилла:
```
При обращении к API используй ключ из переменной MY_API_KEY.
```
## Безопасность
* Значения секретов зашифрованы и не отображаются в интерфейсе после сохранения
* Секреты не попадают в историю чатов и логи
* Удалить секрет можно в любой момент через **Настройки → Секреты и ключи**
# Задачи по расписанию
Source: https://docs.ascn.ai/tasks/scheduled
Настройте агента на автоматическое выполнение задач в заданное время.
**Задача по расписанию** — это сценарий, который агент выполняет сам в нужное время, без вашего участия. Создаются через чат: просто опишите, что и когда нужно делать.
## Как создать задачу
Напишите агенту в чате:
```
Каждое утро в 8:00 делай сводку непрочитанных писем в Gmail
и отправляй мне в Telegram.
```
```
Каждый понедельник в 9:00 проверяй мой Google Calendar
и присылай план встреч на неделю.
```
```
Каждую пятницу в 17:00 спрашивай, что я успел сделать за неделю,
и фиксируй ответ в файл weekly_log.md.
```
Агент создаст задачу, подтвердит расписание и начнёт выполнять её автоматически.
## Поддерживаемые форматы расписания
| Формат | Пример |
| ------------------------------ | ------------------------------ |
| Каждые N минут / часов | Каждые 30 минут |
| Ежедневно в определённое время | Каждый день в 09:00 |
| По дням недели | Каждый понедельник и пятницу |
| В конкретное время | В 18:00 по московскому времени |
## Управление задачами
Просмотреть все задачи можно в разделе **Задачи**. Каждая задача показывает расписание, статус (**Активна** / **Пауза**) и кнопки управления: **Редактировать**, **Детали** и удалить.
![Раздел «Задачи» — список с расписанием и статусами]()
Чтобы изменить или остановить задачу, скажите агенту:
```
Отмени задачу утренней сводки.
```
```
Измени время утренней сводки на 9:30.
```
## Расход кредитов
Каждое выполнение задачи по расписанию расходует кредиты сообщений. Если задача обращается к внешним сервисам (Gmail, Google Calendar и др.) — также тратятся интеграционные кредиты.
Задачи по расписанию расходуют кредиты предсказуемо — вы точно знаете, сколько раз в день агент будет запускаться. Для частых проверок рассмотрите оптимальный интервал: раз в час вместо каждые 15 минут.
## Примеры полезных задач
**Утренняя почтовая сводка:**
```
Каждый день в 8:00 читай непрочитанные письма в Gmail,
выдели важные (с вопросами ко мне или дедлайнами)
и пришли краткое резюме в Telegram.
```
**Напоминание о встречах:**
```
Каждый день в 8:30 смотри мой Google Calendar на сегодня
и отправляй список встреч с временем и названиями.
```
**Еженедельный отчёт:**
```
Каждую пятницу в 17:00 спроси меня, что было сделано за неделю,
запиши ответ в файл weekly_report_[дата].md.
```
# Триггеры по событиям
Source: https://docs.ascn.ai/tasks/triggers
Агент реагирует на события в ваших сервисах — новые письма, встречи, файлы.
**Триггер** — это условие, при наступлении которого агент автоматически выполняет заданное действие. В отличие от расписания, триггер не привязан ко времени — он срабатывает в момент события.
## Доступные триггеры
| Сервис | Событие |
| ------------------- | ----------------------------- |
| **Gmail** | Новое входящее письмо |
| **Google Calendar** | Создание события |
| **Google Calendar** | Изменение события |
| **Google Calendar** | Удаление события |
| **Google Drive** | Добавление нового файла |
| **Google Drive** | Изменение существующего файла |
## Как создать триггер
Опишите условие и реакцию в чате:
```text theme={null}
Когда приходит новое письмо в Gmail, проверь, нужен ли ответ,
и если да — подготовь черновик и пришли мне на утверждение в Telegram.
```
```text theme={null}
Когда в Google Calendar создаётся новая встреча,
пришли мне в Telegram краткое резюме: кто, когда, зачем.
```
```text theme={null}
Когда в Google Drive появляется новый файл в папке «Входящие от клиентов»,
проверь формат и уведоми меня.
```
## Управление триггерами
Просмотреть и отключить активные триггеры можно в разделе **Задачи**.
Чтобы остановить триггер, скажите агенту:
```text theme={null}
Отключи триггер на новые письма в Gmail.
```
## Расход кредитов
Триггеры расходуют интеграционные кредиты при каждом срабатывании. Если в вашей почте много входящих, триггер на каждое новое письмо может расходовать кредиты значительно быстрее, чем задача по расписанию.
**Совет:** если важна не мгновенная реакция, а регулярная проверка, используйте [задачу по расписанию](/tasks/scheduled) — это предсказуемее по расходу кредитов.
## Пример: триггер + расписание
Комбинация работает эффективнее, чем каждый инструмент по отдельности:
* **Триггер** на новые письма от VIP-клиентов → мгновенное уведомление в Telegram
* **Расписание** в 8:00 → сводка всей остальной почты за ночь
Так вы получаете срочное сразу, а остальное — в удобное время.