API для разработчиков
Создавайте на базе Cuneiform Chat из своего собственного кода
Публичный REST API с аутентификацией по ключу, который позволяет вашему коду делать то же, что и панель управления: загружать знания, управлять вашими ИИ-агентами и обращаться к ним откуда угодно. Один bearer-ключ, предсказуемый JSON и справочник, из которого можно копировать.
Что можно построить с помощью API
Загружайте знания программно
Отправляйте документы в базу знаний агента прямо из своего кода или пайплайна. Файлы разбираются, разбиваются на фрагменты, векторизуются и становятся доступными для поиска — тот же стек RAG, что использует панель, запускаемый вызовом API.
Управляйте агентами как кодом
Создавайте, получайте списки, обновляйте и просматривайте своих ИИ-агентов через API. Встройте настройку агентов в собственное провижининг или CI, чтобы новый агент стал шагом деплоя, а не кликом в панели.
Запрашивайте агента откуда угодно
Отправьте вопрос любому агенту и получите обоснованный ответ — с тем же поиском и рассуждением, что и в ваших каналах. Встройте это в приложение, фоновую задачу или другой продукт.
Ключи API с ограниченной областью и возможностью отзыва
Создавайте ключи только с теми областями, которые нужны нагрузке, и отзывайте их сразу после утечки. Ключи имеют префикс cuk_live_ и показываются один раз — минимальные привилегии по умолчанию.
Предсказуемые ошибки и лимиты запросов
Каждый ответ — это JSON со стабильной структурой, единообразными кодами ошибок и понятными заголовками лимитов запросов, чтобы ваш клиент мог повторять, делать back-off и сообщать о сбоях без догадок.
Справочник, из которого можно копировать
Полный опубликованный справочник охватывает аутентификацию, соглашения, ошибки, лимиты запросов и каждый эндпоинт во всех трёх доменах — с примерами запросов и ответов, готовыми к вставке.
От ключа до первого ответа
Пять шагов от пустого терминала до работающей интеграции.
Получите ключ
Откройте консоль разработчика в панели и выпустите ключ API, выбрав области, которые нужны интеграции. Скопируйте его один раз — он начинается с cuk_live_.
Аутентифицируйтесь
Отправляйте ключ как Authorization: Bearer в каждом запросе (заголовок X-API-Key — документированный псевдоним). Никаких плясок с OAuth и сессий, которые нужно обновлять.
Вызовите эндпоинт
Обращайтесь к любому пути под /api/developer/v1 — загружайте в Знания, управляйте Агентами или выполняйте Запрос к агенту. Один базовый URL, одна аутентификация, три домена.
Обработайте ответ
Разберите тело JSON, прочитайте заголовки лимитов запросов и ветвитесь по коду ошибки, когда что-то идёт не так. Структура стабильна во всех эндпоинтах.
Запускайте и масштабируйте
Перейдите от теста с curl к продакшену: ротация ключей, области под каждую нагрузку, а документированные лимиты запросов подскажут вашему клиенту стратегию повторов и параллелизма.
Сценарии использования
Что команды создают на базе API
Синхронизируйте знания из своих систем
Настройте ночную задачу или вебхук, чтобы отправлять новые документы, статьи из центра помощи или спецификации продукта в базу знаний агента, — так ответы остаются актуальными, и никому не нужно открывать панель.
Встройте агента в свой продукт
Вызывайте эндпоинт запроса из приложения или бэкенда, чтобы добавить обоснованного ИИ-ассистента туда, для чего у нас нет готового канала: ваше мобильное приложение, внутренний инструмент или собственный виджет.
Создавайте агентов в CI/CD
Создавайте и настраивайте агентов в рамках пайплайна деплоя, чтобы развёртывание нового окружения или клиентского тенанта включало ИИ-агента как код, а не как ручной шаг настройки.
Автоматизируйте бэк-офисные процессы
Пусть скрипт по расписанию просит агента обобщить, классифицировать или ответить по вашей базе знаний и направляет результат туда, где уже работает ваша команда.
Питайте внутренние инструменты и дашборды
Подтягивайте ответы агента в бот для Slack, операционный дашборд или собственную консоль поддержки — для интеграции достаточно одного bearer-ключа и ответа в JSON.