Отправьте задачу одним HTTP-запросом — получите результат, когда он готов. Текст, файлы, голос, внешние инструменты. Всё асинхронно, всё через API.
Три шага между вашим кодом и ответом AI-ассистента.
POST /api/tasks с JWT-токеном из Aist Back.
Укажите ассистента, входные данные — текст, файлы или голос. Получите uuid задачи мгновенно.
Agent создаёт чат и ход в Aist Back, передаёт конфигурацию ассистента в Aist Core. Если ассистенту нужны внешние инструменты — Agent вызовет их автоматически.
Поллинг: GET /api/tasks/{uuid} — опрашивайте статус, пока задача не завершится.
Webhook: передайте callback_url при создании — Agent сам уведомит вас, как только обработка завершится.
Всё необходимое для интеграции AI в ваш продукт.
Задачи обрабатываются через Redis-очередь с Horizon. Ваш сервер не ждёт — периодически опрашивает статус по uuid.
Отправляйте мультимодальные входные данные: текстовые запросы, загруженные файлы и голосовые сообщения в одном запросе.
Ассистент сам вызывает внешние HTTP API во время обработки — получает данные, выполняет действия, возвращает результат в контексте ответа.
RS256 JWT-аутентификация с кэшированием публичного ключа. HMAC-подпись webhook-ов. Автоматический отзыв скомпрометированных токенов.
Атомарный лимит одновременных задач на пользователя с Redis-блокировкой. Настраивается через переменную окружения.
Передайте llm_model_id или image_generator_id,
чтобы выбрать конкретную модель из конфигурации ассистента.
Redis-очередь с Laravel Horizon: авто-масштабирование воркеров, мониторинг, повторные попытки при сбоях с экспоненциальной задержкой.
Ассистенты, модели, документы и инструменты управляются в Aist Back. Agent использует ту же инфраструктуру, что и чат-интерфейс.
Передайте callback_url — Agent отправит результат на ваш URL сразу по завершении.
Укажите callback_secret для подписи запроса через HMAC-SHA256: до 5 попыток с backoff.
Agent раскрывает потенциал AI-ассистентов за пределами чат-интерфейса.
Подключите Telegram, VK или любой мессенджер. Бот отправляет сообщение пользователя в Agent, поллит статус и пересылает ответ обратно. Все возможности ассистента — включая поиск в интернете, генерацию картинок и работу с документами — доступны прямо в чате.
Обработка входящих обращений, классификация документов, генерация отчётов. Ваш бэкенд ставит задачи в очередь, Agent обрабатывает их параллельно с нужным ассистентом и возвращает структурированный результат.
Добавьте AI-функции в своё мобильное или веб-приложение без сложной инфраструктуры. Agent берёт на себя оркестрацию между вашим приложением, хранилищем ассистентов и AI-движком.
Загрузите пачку файлов или текстов, запустите одного ассистента на все задачи. Лимит одновременных задач защищает систему от перегрузки, а Horizon распределяет нагрузку между воркерами.
Два запроса — задача создана и результат получен.
Передайте callback_url при создании задачи — Agent сам уведомит вас, когда готово. Поллинг не нужен.
completed или failed).
До 5 попыток с экспоненциальным backoff: 10 с, 30 с, 60 с, 120 с.
Если callback_secret не указан — заголовок X-Signature не отправляется, верификация не требуется.
Текстовый запрос. Основной формат для большинства задач.
Файл, загруженный через POST /api/files. Передаётся по ID.
Голосовое сообщение. Транскрибируется автоматически перед обработкой.
Agent — мост между вашим кодом и экосистемой AIST.
API-шлюз. Принимает задачи, ставит в очередь, оркестрирует обработку, возвращает результат. Laravel 13 + Horizon.
Центральный бэкенд. Хранит пользователей, ассистентов, чаты, ходы, модели, документы, инструменты и балансы.
AI-движок. Работает с 40+ моделями от 6 провайдеров. Обрабатывает ходы, выполняет инструменты, стримит ответы.
Middleware для чат-интерфейса. SSE-стриминг ответов в реальном времени. Работает параллельно с Agent.
REST API → Redis-очередь → Aist Back → Aist Core → polling или webhook. Для серверных интеграций, ботов, автоматизации. Асинхронно, без UI.
Браузер → Aist Chat → Aist Back → Aist Core → SSE-стрим. Для пользовательского чат-интерфейса. В реальном времени, с UI.
Технические детали для тех, кто будет интегрировать.
| Параметр | Значение |
|---|---|
| Фреймворк | Laravel 13, PHP 8.3 |
| Очередь | Redis + Laravel Horizon, очередь tasks |
| Аутентификация | RS256 JWT (публичный ключ из Aist Back) |
| Webhook-безопасность | HMAC-SHA256 на основе APP_KEY |
| Лимит задач | До 5 одновременных на пользователя |
| Повторные попытки | 3 попытки с backoff 5с, 30с |
| Webhook-доставка | До 5 попыток с backoff 10с, 30с, 60с, 120с; подпись X-Signature: HMAC-SHA256 |
| Автоочистка | Завершённые задачи удаляются через 30 дней |
| Тесты | Pest 4, feature + unit тесты |