Как добавить ИИ-функции в приложение с m77.ai

Обычно, чтобы добавить ИИ в приложение, нужно зарегистрироваться у провайдера моделей, хранить API-ключ на сервере и написать бэкенд-эндпоинт, чтобы ключ никогда не попал в браузер. В builder77 всё это уже сделано. В каждом приложении есть m77.ai.chat, а вызовы списываются с кредитов интеграций владельца приложения — 1 кредит за 500 токенов (ввод + вывод, минимум 1 за вызов).

Основы

const reply = await m77.ai.chat('Suggest three names for a coffee shop by the sea');

const answer = await m77.ai.chat(
  [{ role: 'user', content: question }],
  { system: 'You are a friendly barista. Answer in two sentences.' }
);

Передайте строку для разового промпта или массив сообщений для диалога. Необязательная инструкция system задаёт тон и правила.

Структурированный ответ с json: true

Самым полезным ИИ-функциям нужен не текст, а данные, которые может отобразить интерфейс. Укажите json: true и опишите нужную структуру. В ответ вы получите разобранный объект.

const recipe = await m77.ai.chat(
  `Create a recipe using: ${ingredients.join(', ')}.
   Return JSON: { "title": string, "minutes": number, "steps": string[] }`,
  { json: true }
);
renderRecipe(recipe);

Пять приёмов, которые хорошо работают

• Кратко изложить: превращайте длинные заметки, отзывы или обращения в поддержку в краткую сводку в начале страницы.
• Классифицировать: помечайте входящие заявки из форм по теме или срочности и сохраняйте метку через m77.db.update.
• Генерировать черновики: описания товаров, посты для соцсетей, ответы на письма — всегда с возможностью правки перед сохранением.
• Извлекать: вытаскивайте даты, суммы или имена из свободного текста в поля.
• Помогать: небольшая панель чата, которая отвечает на вопросы о содержимом страницы.

Сохраняйте результаты, чтобы не платить дважды

Вызовы тарифицируются по токенам: 1 кредит интеграций за 500 токенов (ввод + вывод, минимум 1 за вызов), поэтому типичный ответ стоит около 3–4 кредитов. Если результат меняется редко — краткое содержание документа, теги записи, — сохраните его в базе данных и генерируйте заново, только когда меняется источник.

if (!note.summary) {
  const summary = await m77.ai.chat(`Summarize in one sentence: ${note.body}`);
  await m77.db.update('notes', note.id, { summary });
}

Не забывайте о задержках и сбоях

Вызовам ИИ нужно немного времени, поэтому обращайтесь с ними как с любым сетевым запросом: отключайте кнопку, показывайте состояние загрузки и обрабатывайте ошибки понятным сообщением. m77.toast('Something went wrong', 'error') — простой запасной вариант. Приложения, которые создаёт builder77, делают это по умолчанию, но стоит проверить, если вы добавляете функции вручную.

Пишите промпты как техзадание

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

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

Ответственно относитесь к ответам ИИ

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

Попросите builder77 сделать это

Писать всё это самому почти никогда не нужно. Попробуйте промпты вроде «добавь ИИ-кнопку, которая предлагает теги для каждой заметки и сохраняет их» или «добавь чат-ассистента, который отвечает на вопросы о меню». Конструктор знает m77.ai и сам подключит интерфейс, состояния загрузки и хранение данных.