Перейти к основному содержанию
ASCN Agent предоставляет API для интеграции с внешними системами: запускайте беседы, отправляйте сообщения и получайте ответы программно. Раздел Настройки → API — Base URL, ключ авторизации и пример запроса

​
Как получить доступ к API

  1. Откройте Настройки → API
  2. Скопируйте Base URL — он уникален для каждого воркспейса
  3. Скопируйте Ключ авторизации
  4. Используйте ключ в заголовке 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 и ключ авторизации привязаны к конкретному воркспейсу. Для каждого агента они свои.