![]()
Один текст удобно обработать в чате. Но когда команда каждый день копирует туда похожие заявки, вручную добавляет одинаковые правила и переносит ответы обратно, стоимость процесса начинает складываться из мелких действий. API нужен не ради технической сложности, а ради повторяемого пути от исходных данных до проверенного результата.
В Чатиуме можно превратить такой путь в приложение: форма, AI-черновик, правка и история. Пользователю не придётся помнить длинный промпт или искать предыдущую версию ответа в переписке.
Создай редактор описаний товаров. Пользователь заполняет факты о товаре, получает черновик и правит его перед сохранением. Не добавляй неподтверждённые характеристики. Храни исходные данные, все версии текста и отметку об утверждении.
Когда обычного чата достаточно
Если задача разовая, исходник небольшой, а результат проверяет один человек, отдельное приложение может не окупить усилия. Нужно написать письмо, придумать несколько формулировок или объяснить незнакомый термин — чат подходит естественно.
Переход к API имеет смысл, когда повторяются не только вопросы, но и правила обработки. Например, описание товара всегда должно сохранять материал, размеры и комплектацию, не выдумывать свойства и проходить редакторское утверждение.
Пример: двадцать карточек каждый день
В ручном процессе сотрудник открывает таблицу, копирует характеристики, добавляет инструкцию, ждёт ответ, переносит его обратно и отмечает готовность. Ошибка может возникнуть не в модели, а при переносе: текст от одного товара попадёт в карточку другого.
В приложении запись товара остаётся связанной с запросом и результатом. Пользователь видит, что именно отправлено модели, и принимает черновик в той же карточке. Это снимает часть повторяющихся операций, даже если качество самой модели не изменилось.
| Признак задачи | Что даёт приложение |
|---|---|
| Повторяются обязательные поля | Форма проверяет полноту ввода |
| Несколько сотрудников | Роли и общая очередь |
| Нужна история | Версии привязаны к конкретной записи |
| Есть согласование | Явное состояние «черновик» и «утверждено» |
| Важны расходы | Учёт запросов и повторов |
Чего API не исправляет автоматически
Он не делает модель безошибочной. Если исходные характеристики противоречат друг другу, программа должна показать проблему, а не просто быстрее отправить её нейросети. Если текст принят без проверки, удобный интерфейс лишь ускорит публикацию ошибки.
Не стоит считать подписку на пользовательский чат оплатой любого API-вызова. Это разные способы доступа со своими условиями. Для приложения нужно учитывать фактические расходы, ошибки и ограничения выбранного маршрута.
Также понадобится поведение во время ожидания. Запрос может выполняться дольше обычного или завершиться ошибкой. Пользователь должен понимать, сохранён ли его исходник и можно ли повторить действие, не создавая лишних задач.
Как выглядит вызов модели из Чатиума
Чатиум предоставляет среду для интерфейса, серверных обработчиков и хранения. Встроенный помощник помогает собрать приложение, а модель для генерации описания выбирается отдельно. В примере используется Qwen3.8 Flash.
Это фрагмент серверного обработчика Чатиума. ctx передаёт платформа, sourceText содержит проверенный текст из формы. done и failed — заранее зарегистрированные маршруты app.function для результата и ошибки. Они проверяют, что вызов пришёл от приложения start: caller.type === 'plugin' && caller.appSlug === 'start'.
import { startCompletion } from '@start/sdk'
const { completionId } = await startCompletion(ctx, {
model: 'qwen/qwen3.8-flash',
system: 'Составь краткое описание товара только по указанным характеристикам. Не добавляй свойства, гарантии и комплектацию. Противоречия выдели отдельно.',
messages: [{
role: 'user',
content: [{ type: 'text', text: sourceText }],
}],
onCompletionCompleted: done,
onCompletionFailed: failed,
})
Метод возвращает completionId. Сам ответ приходит позже в onCompletionCompleted, ошибка — в onCompletionFailed; до этого приложение показывает ожидание. Это схема вызова, а не полный код приложения.
Сохранение результата выполняется в обработчике завершения с привязкой к исходной карточке и её версии. Если пользователь успел изменить характеристики, старый ответ не должен незаметно перезаписать новый черновик.
Как перейти без большого проекта
Начните с одной формы и одного результата. Сохраните прежний ручной способ как понятный ориентир: сколько времени занимает обработка и где возникают ошибки. Затем сравните полный цикл в приложении, включая проверку и исправления.
Не добавляйте сразу автоматическую публикацию, сложные роли и десяток моделей, если задача этого не требует. Первый полезный шаг — убрать копирование и сохранить связь между исходником и ответом. После этого проще решить, какой следующий элемент действительно нужен.
Частые вопросы
API нужен только программистам?
API — программный интерфейс, но пользователь готового приложения работает с обычной формой. В Чатиуме приложение можно описать встроенному помощнику, который создаёт реализацию.
Можно ли менять модель позже?
Да, если модельный шаг отделён от данных и интерфейса. После замены нужно проверить качество и поддерживаемые возможности. Подробнее — в переключении моделей.
Как понять, что переход был полезен?
По времени до принятого результата, уменьшению ошибок переноса и понятной истории. Стоимость вызова — только часть общей оценки; её разбираем в расходах на AI-функцию.