← Все материалы

Гайд

Чат с нейросетью или API: когда копировать ответы вручную уже дороже?

Когда обычного чата с нейросетью уже мало: повторяемые задачи, история и роли, с коротким примером вызова модели из Чатиума.

Обновлено

Окна приложения с кодом соединены с серверными модулями

Один текст удобно обработать в чате. Но когда команда каждый день копирует туда похожие заявки, вручную добавляет одинаковые правила и переносит ответы обратно, стоимость процесса начинает складываться из мелких действий. API нужен не ради технической сложности, а ради повторяемого пути от исходных данных до проверенного результата.

В Чатиуме можно превратить такой путь в приложение: форма, AI-черновик, правка и история. Пользователю не придётся помнить длинный промпт или искать предыдущую версию ответа в переписке.

Промпт

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

Когда обычного чата достаточно

Если задача разовая, исходник небольшой, а результат проверяет один человек, отдельное приложение может не окупить усилия. Нужно написать письмо, придумать несколько формулировок или объяснить незнакомый термин — чат подходит естественно.

Переход к API имеет смысл, когда повторяются не только вопросы, но и правила обработки. Например, описание товара всегда должно сохранять материал, размеры и комплектацию, не выдумывать свойства и проходить редакторское утверждение.

Пример: двадцать карточек каждый день

В ручном процессе сотрудник открывает таблицу, копирует характеристики, добавляет инструкцию, ждёт ответ, переносит его обратно и отмечает готовность. Ошибка может возникнуть не в модели, а при переносе: текст от одного товара попадёт в карточку другого.

В приложении запись товара остаётся связанной с запросом и результатом. Пользователь видит, что именно отправлено модели, и принимает черновик в той же карточке. Это снимает часть повторяющихся операций, даже если качество самой модели не изменилось.

Признак задачи Что даёт приложение
Повторяются обязательные поля Форма проверяет полноту ввода
Несколько сотрудников Роли и общая очередь
Нужна история Версии привязаны к конкретной записи
Есть согласование Явное состояние «черновик» и «утверждено»
Важны расходы Учёт запросов и повторов

Чего API не исправляет автоматически

Он не делает модель безошибочной. Если исходные характеристики противоречат друг другу, программа должна показать проблему, а не просто быстрее отправить её нейросети. Если текст принят без проверки, удобный интерфейс лишь ускорит публикацию ошибки.

Не стоит считать подписку на пользовательский чат оплатой любого API-вызова. Это разные способы доступа со своими условиями. Для приложения нужно учитывать фактические расходы, ошибки и ограничения выбранного маршрута.

Также понадобится поведение во время ожидания. Запрос может выполняться дольше обычного или завершиться ошибкой. Пользователь должен понимать, сохранён ли его исходник и можно ли повторить действие, не создавая лишних задач.

Как выглядит вызов модели из Чатиума

Чатиум предоставляет среду для интерфейса, серверных обработчиков и хранения. Встроенный помощник помогает собрать приложение, а модель для генерации описания выбирается отдельно. В примере используется Qwen3.8 Flash.

Это фрагмент серверного обработчика Чатиума. ctx передаёт платформа, sourceText содержит проверенный текст из формы. done и failed — заранее зарегистрированные маршруты app.function для результата и ошибки. Они проверяют, что вызов пришёл от приложения start: caller.type === 'plugin' && caller.appSlug === 'start'.

TypeScript
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-функцию.