Функции

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

к сведению

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

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

---

Комплексная обработка событий

Функция «Сценарии» в MonoChat построена на принципах продвинутой комплексной обработки событий (CEP). CEP позволяет системе анализировать шаблоны событий и реагировать на них в реальном времени, благодаря чему можно автоматизировать сложные бизнес-процессы. С MonoChat компании могут использовать CEP, чтобы создавать сложные сценарии, которые реагируют на разные события, запускают действия и бесшовно интегрируются с внешними системами.

Интерфейс управления функциями

Интерфейс управления функциями в MonoChat предоставляет удобную среду для создания, обновления и управления пользовательскими функциями. Вот основные элементы и их назначение:

Создание функции

1. Название: введите название функции.
2. Результаты: определите выходные данные функции.
3. Выбор функции: выберите существующую функцию или создайте новую.
4. Тип функции: выберите тип функции из доступных вариантов, например Задание Cron, API-эндпоинт, Настройка пользовательского приложения или Узел пользовательского сценария.

Типы функций

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

2. Серверный метод:
   Серверный метод — это функция или процедура, которая выполняется на сервере, а не на устройстве пользователя (на стороне клиента). Он обрабатывает серверные процессы, такие как запросы к базе данных, бизнес-логика или интеграции с другими сервисами, обеспечивая безопасную и эффективную работу.

3. Пользовательское представление:
   Пользовательское представление — это настроенный интерфейс или экран, который показывает данные или информацию так, как нужно конкретным пользователям. Оно позволяет настраивать макет, поля и компоненты, чтобы создать целенаправленный пользовательский опыт, отличающийся от стандартных представлений.

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

5. Задание Cron: Задание Cron — это запланированная задача, которая автоматически выполняется на сервере через заданные интервалы или в заданное время. Его часто используют для повторяющихся задач, таких как отправка писем, очистка баз данных, формирование отчётов или синхронизация данных без ручного вмешательства.

6. Настройка пользовательского приложения:
   Настройка пользовательского приложения — это процесс конфигурирования и развёртывания персонализированного приложения под конкретные бизнес-требования. Сюда входит настройка компонентов приложения, прав доступа, интеграций и пользовательских интерфейсов, чтобы создать уникальное решение внутри платформы.

Обновление функции

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

Пользовательские представления и коллекции

MonoChat поддерживает пользовательские представления и пользовательские коллекции, позволяя компаниям создавать собственные интерфейсы и управлять собственными базами данных.

• Пользовательское представление: этот тип функции позволяет создавать особые экраны внутри MonoChat. Такие экраны могут показывать данные из внешних сервисов или пользовательских коллекций, предоставляя уникальный интерфейс для конкретных бизнес-задач.
• Пользовательские коллекции: позволяют компаниям определять собственные структуры данных и хранить пользовательские данные в MonoChat. Эта возможность особенно полезна компаниям, которым нужно управлять специализированной информацией, не охваченной стандартными функциями MonoChat.

Настройки и выходы для функций Узла пользовательского сценария

Функция Узел пользовательского сценария может описывать настройки, которые принимает каждый использующий её узел, и выходы, по которым сценарий может продолжиться. Автор сценария тогда заполняет форму в узле, а не редактирует код, а одну функцию можно использовать во многих узлах с разными настройками.

Если тип функции — Узел пользовательского сценария, в панелях создания и обновления отображается JSON-редактор Настройки узлов и выходные данные (JSON):

{
  "description": "Routes the conversation to a team based on the selected department.",
  "descriptions": { "tr-TR": "Seçilen departmana göre konuşmayı bir ekibe yönlendirir." },
  "parameters": [
    { "name": "department", "type": "select", "label": "Department", "labels": { "tr-TR": "Departman" }, "required": true,
      "options": [ { "value": "sales", "label": "Sales" }, { "value": "support", "label": "Support" } ] },
    { "name": "maxWaitMinutes", "type": "number", "label": "Max wait (minutes)", "default": 10 },
    { "name": "notifyManager", "type": "boolean", "label": "Notify the manager" }
  ],
  "outputs": [
    { "key": "assigned", "label": "Assigned", "labels": { "tr-TR": "Atandı" } },
    { "key": "noAgent", "label": "No agent available" }
  ]
}

Ключ	Описание
description / descriptions	Текст в верхней части панели узла. В descriptions хранятся переводы по локалям (например, en-US, tr-TR); description — запасной вариант.
parameters	Настройки узла. У каждой есть name (ключ, который читает ваш код), type (text, textarea, url, number, boolean или select), label / labels, необязательное description / descriptions (отображается как подсказка в поле), required, default, а для select — options (value и label / labels).
outputs	Ключи выходов, которые может вернуть функция, у каждого есть label / labels.

В конструкторе сценариев, когда вы добавляете узел Узел пользовательского сценария (среди узлов функций) и выбираете эту функцию в поле Функция, в панели отображаются описание, поле для каждого параметра (с его значением по умолчанию), а в Результаты подставляются объявленные ключи и подписи. Значения сохраняются в узле.

В функции значения приходят в payload.nodeParameters, а выходы узла — в payload.nodeOutputs (key и label каждого). Чтобы продолжить по нужному выходу, вызовите resolve с ключом выхода:

CustomFunction(async function ({ sdk, payload }, reject, resolve) {
  const { department, maxWaitMinutes, notifyManager } = payload.nodeParameters

  // ... your logic ...

  resolve('assigned')
})

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

подсказка

Приложения, установленные из магазина, сохраняют ID своих функций при обновлении, поэтому узлы Функций и AI-инструменты, построенные на функциях приложения, продолжают работать после обновления.

Вложенная структура папок

Управление функциями в MonoChat поддерживает интуитивную вложенную структуру папок. Пользователи могут переходить по папкам и подпапкам, чтобы систематически организовать свои функции. Такая структура упрощает управление и быстрый доступ к нужным функциям в нужной папке.

Сценарии использования

Бизнес-логика

• Пользовательская логика: реализуйте конкретные бизнес-правила и специализированную логику для уникальных бизнес-процессов, например расчёт скидок, обработку заказов, валидацию или пользовательские вычисления. Это позволяет компаниям адаптировать рабочие процессы и автоматизацию под свои нужды.

Интеграция с внешними сервисами

• API-интеграция: создавайте API-эндпоинты, чтобы внешние приложения могли получать данные из MonoChat. Это обеспечивает бесшовную интеграцию со сторонними сервисами, такими как CRM-системы, платёжные шлюзы или платформы аналитики данных, гарантируя бесперебойный обмен данными и совместимость.
• Синхронизация данных: автоматизируйте синхронизацию данных между MonoChat и другими системами, чтобы обеспечить согласованность и точность и поддерживать актуальность всех платформ.

Пользовательские интерфейсы

• Пользовательские интерфейсы: разрабатывайте пользовательские панели или формы ввода данных под конкретные потребности бизнеса. Это даёт агентам и сотрудникам персонализированный интерфейс, повышая удобство и эффективность.

Управление данными

• Управление данными: определяйте пользовательские коллекции для хранения уникальных бизнес-данных и управления ими. Это помогает упорядочивать и поддерживать важную информацию, обеспечивая лёгкий доступ и отчётность.

Автоматизация по расписанию

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

AI-инструменты

• AI-инструменты: используйте возможности искусственного интеллекта, такие как обработка естественного языка, предиктивная аналитика или автоматизация, чтобы улучшать принятие решений и упрощать рабочие процессы. AI-инструменты помогают компаниям автоматизировать сложные задачи, получать выводы из данных и предлагать более умный пользовательский опыт.

Функция управления функциями в MonoChat — универсальный инструмент, который позволяет компаниям широко настраивать свои автоматизированные рабочие процессы. Используя пользовательские функции, представления и коллекции, компании могут добиться полного соответствия среды MonoChat своим операционным требованиям.

к сведению

Подробнее о создании пользовательских событий читайте на странице документации SDK.