Функция

Блок "Функция" выполняет пользовательский код JavaScript или TypeScript в ваших воркфлоу. Преобразуйте данные, выполняйте вычисления или реализуйте пользовательскую логику.

Выходные данные

• <function.result>: Значение, возвращаемое из вашей функции
• <function.stdout>: Вывод console.log() из вашего кода

Примеры использования

Конвейер обработки данных - Преобразование ответа API в структурированные данные

API (Fetch) → Function (Process & Validate) → Function (Calculate Metrics) → Response

Реализация бизнес-логики - Расчет баллов лояльности и уровней

Agent (Get History) → Function (Calculate Score) → Function (Determine Tier) → Condition (Route)

Валидация и очистка данных - Проверка и очистка пользовательского ввода

Input → Function (Validate & Sanitize) → API (Save to Database)

Пример: Калькулятор баллов лояльности

// Обработка данных клиента и расчет балла лояльности
const { purchaseHistory, accountAge, supportTickets } = <agent>;

// Расчет метрик
const totalSpent = purchaseHistory.reduce((sum, purchase) => sum + purchase.amount, 0);
const purchaseFrequency = purchaseHistory.length / (accountAge / 365);
const ticketRatio = supportTickets.resolved / supportTickets.total;

// Расчет балла лояльности (0-100)
const spendScore = Math.min(totalSpent / 1000 * 30, 30);
const frequencyScore = Math.min(purchaseFrequency * 20, 40);
const supportScore = ticketRatio * 30;

const loyaltyScore = Math.round(spendScore + frequencyScore + supportScore);

return {
  customer: <agent.name>,
  loyaltyScore,
  loyaltyTier: loyaltyScore >= 80 ? "Platinum" : loyaltyScore >= 60 ? "Gold" : "Silver",
  metrics: { spendScore, frequencyScore, supportScore }
};

Рекомендации

• Сосредоточьте функции на одной задаче: Пишите функции, которые хорошо выполняют одну задачу, чтобы улучшить поддерживаемость и отладку
• Обрабатывайте ошибки корректно: Используйте блоки try/catch для обработки потенциальных ошибок и предоставления понятных сообщений об ошибках
• Тестируйте граничные случаи: Убедитесь, что ваш код корректно обрабатывает необычные вводы, нулевые значения и граничные условия
• Оптимизируйте для производительности: Учитывайте вычислительную сложность и использование памяти для больших наборов данных
• Используйте console.log() для отладки: Используйте вывод stdout для отладки и мониторинга выполнения функции