Click: API ИИ-агентов для вашего приложения

Для чего нужен Click: простое объяснение

Click — управляемый API ИИ-агентов для разработчиков, которые встраивают агентов в собственные приложения. Вы задаёте ключ модели, инструкции и разрешённые инструменты. Click выполняет вызовы модели и инструментов, сохраняет историю и управляет восстановлением выполнения. Приложение получает результат через API, поток событий или вебхуки.

Например, помощник внутри продукта может прочитать CSV с продажами и подготовить отчёт. Интерфейс, пользователи, доступ к данным и согласования остаются на стороне приложения; Click предоставляет среду исполнения. Сервис Click AI Labs, Inc. подходит для многошаговых и фоновых задач. Понадобится интеграция бэкенда и проверка результатов.

Бесплатный план и полная стоимость работы

Публичные месячные цены в USD проверены 3 ноября 2026 года на странице тарифов. Это не подтверждённая рублёвая цена или гарантия местной оплаты и доступности.

• Free: 0 USD/месяц. Две одновременно резидентные сессии, 100 МБ файлов; ежемесячно час управляемой песочницы, час браузера и 100 поисков.
• Pro: 199 USD/месяц. 50 резидентных сессий, 10 ГБ; ежемесячно по 100 часов песочницы и браузера, 5000 поисков.
• Enterprise: индивидуальная цена и ёмкость.

BYOK означает использование своих ключей моделей: расходы провайдера модели нужно учитывать отдельно. Внешние сервисы песочниц и браузеров также могут выставлять собственные счета. Хранилище — текущая ёмкость, а не новый объём каждый месяц. Управляемые квоты общие для tenant: Free обновляется по календарным месяцам UTC, Pro — по оплаченному расчётному периоду.

В параллельность входят активные и простаивающие сессии с runtime, но не standby. Исчерпание квот может блокировать инструменты и останавливать работу. Документация указывает отсутствие автоматической оплаты превышений.

Как запустить первого агента через API

1. Подготовьте ключ API Click и ключ поддерживаемого провайдера модели. Создание и изменение ресурсов требует проверки карты; для существующих аккаунтов возможны исключения. Проверка не списывает деньги и не запускает платную подписку.
2. Сохраните ключ модели через POST /credentials, запишите ID. Оба ключа должны оставаться на бэкенде.
3. Выберите модель нужного провайдера через GET /models.
4. Создайте агента с моделью, инструкциями и правами инструментов через POST /agents. Сохраните latest_version.id, затем вызовите POST /sessions.
5. Отправьте работу в POST /sessions/{session_id}/submissions. request_id позволяет при повторе получить исходную отправку.
6. Дождитесь done, cancelled или failed. При успехе прочитайте указанную запись ответа, иначе проверьте причину.

HTTP 202 означает только сохранение ввода. Свяжите сессию со своим документом или тикетом, чтобы продолжать с её историей, и проверяйте права пользователя перед выдачей данных.

Подключение инструментов и обработка файлов

Click подключает MCP Streamable HTTP и собственные HTTP-эндпоинты по публичному HTTPS. После создания соединения нужно явно выдать права на инструменты. HTTP-инструменты описывают аргументы через JSON Schema и получают JSON POST; документированный тайм-аут — 120 секунд.

Эндпоинт тикетов может проверять краткоживущий токен, ограниченный конкретным клиентом. Аутентификация, бюджеты, согласования и бизнес-проверки остаются ответственностью приложения.

Есть веб-поиск, автоматизация браузера и файловые либо shell-операции в песочнице. Документация также описывает Blaxel, Daytona и собственные учётные данные Browserbase. Условия и расходы внешних провайдеров проверяются отдельно.

Для файлов используйте песочницу Click: загрузите вход через POST /files, укажите ID в задаче и поручите агенту вызвать publish_file. Затем получите artifacts и скачайте результат через GET /files/{file_id}. Рабочий файл песочницы ещё не является устойчиво опубликованным результатом; проверьте и содержимое.

Поток событий и фоновые задачи

GET /sessions/{session_id}/events сначала выдаёт полный snapshot, затем изменения текста, инструментов и статуса. При переподключении новый snapshot заменяет локальное состояние. Разрыв потока не останавливает работу; при standby поток закрывается.

Подписанные вебхуки submission.updated и artifact.created позволяют получать результат в фоне. После уведомления прочитайте текущее состояние ресурса перед обновлением своего продукта.

Данные, ключи и контроль доступа

Политика конфиденциальности охватывает инструкции, сообщения, файлы, вызовы инструментов и предоставленные ключи. Для выполнения задач данные могут передаваться провайдерам моделей и инструментов; применимы и их правила.

Сотрудники Click могут обращаться к содержимому для адаптации, поддержки, диагностики и улучшения сервиса. Срок хранения определяется разумной необходимостью без единого фиксированного периода. Обработка возможна в США и других странах. Это не гарантирует хранение в РФ, нулевую ретенцию или общий запрет использования для обучения.

Секреты помещайте в предназначенные настройки ключей, а не сообщения и файлы. Политика просит не отправлять особо чувствительные регулируемые сведения.

Частые вопросы

Можно ли пользоваться Click бесплатно?

Да, в пределах Free. Провайдер модели может брать отдельную плату, а создание ресурсов обычно требует проверки карты.

Входит ли стоимость модели в подписку?

Официальный сценарий использует ваши ключи провайдера. Учитывайте расходы модели отдельно и проверяйте каталог через GET /models.

Как подключить собственные инструменты?

Через MCP или HTTPS-инструменты с явными разрешениями. Контроль клиентского доступа и согласование важных действий остаются в приложении.

Официальные ресурсы для разработчиков

• Справочник API: инструменты, события, вебхуки и файлы.
• Быстрый старт: первый агент, сессия и отправка задачи.
• Условия и поддержка: условия сервиса и официальный способ обращения.