Отправьте задачу одним HTTP-запросом — получите результат, когда он готов. Текст, файлы, голос, внешние инструменты. Всё асинхронно, всё через API.
Живой пример · JWT и ID ассистента хранятся только в вашей вкладке
Три шага между вашим кодом и ответом 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: авто-масштабирование воркеров, мониторинг, повторные попытки при сбоях с экспоненциальной задержкой.
Передайте массив turns с предыдущими ходами —
AI продолжит разговор с полным контекстом. Каждый ход содержит messages для восстановления истории.
Передайте callback_url — Agent отправит результат на ваш URL сразу по завершении.
Укажите callback_secret для подписи запроса через HMAC-SHA256: до 5 попыток с backoff.
Agent раскрывает потенциал AI-ассистентов за пределами чат-интерфейса.
Подключите Telegram, VK или любой мессенджер. Бот отправляет сообщение пользователя в Agent, поллит статус и пересылает ответ обратно. Все возможности ассистента — включая поиск в интернете, генерацию картинок и работу с документами — доступны прямо в чате.
Обработка входящих обращений, классификация документов, генерация отчётов. Ваш бэкенд ставит задачи в очередь, Agent обрабатывает их параллельно с нужным ассистентом и возвращает структурированный результат.
Добавьте AI-функции в своё мобильное или веб-приложение без сложной инфраструктуры. Agent берёт на себя оркестрацию между вашим приложением, хранилищем ассистентов и AI-движком.
Загрузите пачку файлов или текстов, запустите одного ассистента на все задачи. Лимит одновременных задач защищает систему от перегрузки, а Horizon распределяет нагрузку между воркерами.
Одна задача — два запроса. Ниже минимальный пример; полное описание эндпоинтов, форматов и сценариев — в документации.
Webhook, файлы, мультиход, форматы ввода и структура ответа — подробно, с примерами и справочником.
Создать задачу и забрать результат за два запроса.
Текст, файлы и голос в массиве input.
Загрузка через POST /api/files и ссылки на скачивание.
Доставка результата на callback_url и HMAC-подпись.
Продолжение диалога через массив turns[].
Поля output, messages и metadata в ответе.
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.
Технические детали для тех, кто будет интегрировать.
| Параметр | Значение |
|---|---|
| Аутентификация | RS256 JWT из Aist Back; поля sub, sanctum, exp, abilities |
| Отзыв токена | 403 от Aist Back автоматически вносит JWT в чёрный список; следующие запросы вернут 401 |
| Лимит задач | До 5 активных (Pending/Processing) на пользователя; при превышении — 429 |
| Таймаут принятия | Если aist-core не подтвердил приём в течение 30 с, задача автоматически переходит в failed |
| Коды ошибок задачи |
Assistant is not available — ассистент недоступен;Insufficient balance — недостаточно баланса;Token revoked — токен отозван
|
| Webhook-доставка | До 5 попыток с backoff 10 с, 30 с, 60 с, 120 с; заголовки X-Task-Uuid и X-Signature (если задан callback_secret) |
| Загрузка файлов | Макс. 1 ГБ; форматы: изображения, документы, текст, аудио, видео |
| Хранение задач | Завершённые и упавшие задачи доступны 30 дней, затем удаляются |
Используйте AI-кодинг ассистента для интеграции. Файл llms.txt содержит полную документацию API в формате, оптимизированном для LLM.
Claude Code, Cursor, Windsurf и другие кодинг-ассистенты могут прочитать этот файл и сразу сгенерировать рабочий интеграционный код — с аутентификацией, загрузкой файлов, поллингом и верификацией вебхуков.