Настройки и безопасность
После урока вы сможете программно запускать агента из своего продукта, управлять сессиями и связывать несколько агентов через API-запросы.
API
ASCN Agent предоставляет API для интеграции с внешними системами: запускайте беседы, отправляйте сообщения и получайте ответы программно.
Раздел Настройки → API — Base URL, ключ авторизации и пример запроса
Как получить доступ к API
- Откройте Настройки → API
- Скопируйте Base URL — он уникален для каждого воркспейса
- Скопируйте Ключ авторизации
- Используйте ключ в заголовке
Authorization: Bearer ...с каждым запросом
Базовый пример
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 и ключ авторизации привязаны к конкретному воркспейсу. Для каждого агента они свои.
Кредиты
ASCN работает на кредитах — они списываются каждый раз, когда агент что-то делает. Два независимых типа.
Два типа кредитов
| Тип | Что расходует |
|---|---|
| Кредиты сообщений | Каждое сообщение в чате, выполнение задачи по расписанию |
| Интеграционные кредиты | Обращение к Gmail, Calendar, Drive и другим; срабатывание триггеров; serverless-функции |
Оба типа обновляются ежемесячно согласно вашему тарифу.
Где смотреть остаток
Текущий баланс кредитов — в личном кабинете на ascn.ai. Раздел Тариф или Биллинг в настройках аккаунта.
Как управлять расходом
Самые затратные паттерны:
- Триггер на каждое новое письмо в активном ящике — расходует интеграционные кредиты при каждом входящем
- Частые задачи по расписанию (каждые 15 минут) — расходуют кредиты сообщений предсказуемо, но быстро
Как сократить расход:
- Замените триггеры на частые события задачами по расписанию — например, проверка почты раз в час вместо на каждое письмо
- Для срочных уведомлений оставьте триггер только на VIP-отправителей, остальных включите в утреннюю сводку
- Объединяйте несколько проверок в одну задачу (почта + календарь за один запуск)
Задачи по расписанию расходуют кредиты предсказуемо — вы точно знаете, сколько запусков в день. Триггеры зависят от активности в ваших сервисах.
Что происходит при исчерпании кредитов
- Агент прекращает отвечать в чате и Telegram
- Задачи по расписанию останавливаются
- Триггеры не срабатывают
Все данные, настройки и история сохраняются — после пополнения баланса работа продолжается автоматически.
Тарифы и пополнение
Актуальные тарифы и условия пополнения — на сайте ascn.ai.