Интеграция с JAICP, суммаризация текста и новый редактор кода
В этом обновлении — связка Agent Platform и JAICP, а также новые инструменты для работы с данными и функциями. Встречайте обновленный редактор кода, функцию суммаризации текстов, интеграцию с Jay Guard и выбор области видимости базы данных.
Основные изменения
- Интеграция JAICP и Agent Platform: вызывайте проекты Agent Platform из JAICP-ботов и наоборот. Подробнее
- Функция суммаризации: сокращайте длинные тексты до нужного размера с сохранением ключевой информации. Подробнее
- Единый редактор кода: весь код функции, включая импорты и сигнатуру, теперь в одном окне с защитой служебных строк. Подробнее
- Удобная настройка функций: выбирайте способ заполнения параметров (поле, JSON или LLM) в один клик. Подробнее
- Защита данных с Jay Guard: предотвращайте утечки чувствительной информации в запросах к LLM. Подробнее
- Расширенные области видимости базы данных: создавайте БД с изоляцией на уровне канала, клиента или сессии. Подробнее
Кроме того, мы добавили новую настройку в тестовый виджет и исправили несколько ошибок. Подробнее
Интеграция JAICP и Agent Platform
Теперь проекты JAICP и Agent Platform можно связывать: вызывать AI-агентов из классических ботов JAICP и наоборот. При вызове проекты работают как внешние сервисы: контекст диалога не передается, а ответ возвращается в родительский сценарий, а не пользователю.
Это позволяет создавать гибридные решения:
- Классический бот передает сложные вопросы AI-агенту.
- AI-агент вызывает бота JAICP для выполнения бизнес-логики.
- Один процесс вызывает другой процесс для решения изолированной подзадачи.
Вызов Agent Platform из JAICP
Используйте функцию $agentPlatform.callProject() в коде вашего JAICP-проекта:
var response = $agentPlatform.callProject(
"https://app.jaicp.com/chatapi/webhook/abc123",
$request.query,
{ userId: $session.userId }
);
// Обработка ответа
$reactions.answer(response.replies[0].text);
Функция доступна как в ES5-, так и в ES6-проектах JAICP.
Вызов JAICP из Agent Platform
Чтобы вызвать JAICP-бота, используйте функцию callProject() из коллекции ProjectRouter во встроенных функциях.
Добавьте ее на холст и укажите параметры:
token— токен Chat API целевого проекта.query— текст запроса.customData— дополнительные данные для передачи (необязательно).
Функция суммаризации текста
В коллекции встроенных функций Llm появилась новая функция summarizeText(). Она сокращает длинный текст до заданного размера, сохраняя ключевую информацию.
Используйте функцию, чтобы:
- обрабатывать большие документы перед передачей в контекст агента;
- создавать краткие изложения статей, отчетов или переписок;
- оптимизировать контекст для экономии токенов.
Добавьте функцию на холст и настройте параметры:
llmModelKey— модель для краткого изложения.text— текст для сокращения.targetSize— желаемая длина результата в символах (необязательно).lang— язык краткого изложения (необязательно).combineStrategy— стратегия объединения частей:iterative(по умолчанию) илиrecursive(необязательно).
Поддерживаются тексты до 200 000 символов. Длинные тексты автоматически разбиваются на части и обрабатываются параллельно.
Единый редактор кода
Мы обновили редактор для пользовательских функций: добавили защиту служебных областей от случайных изменений и сворачивание блоков кода.
Защита служебного кода
Импорты зависимостей и сигнатура функции находятся в том же окне, что и основной код, но на сером фоне. Они по-прежнему защищены от изменений: вы видите полный контекст функции, но не можете случайно повредить служебные строки.
При создании новой функции в области для редактирования появляется подсказка // your code goes here.
Сворачивание кода
Теперь в редакторе можно сворачивать блоки кода: циклы, условия, объекты и другие конструкции. Элементы управления для этого появляются слева от номеров строк.
Сворачивание упрощает навигацию по длинным файлам: скройте неактуальные участки и сфокусируйтесь на нужном фрагменте.
Используйте боковые панели, чтобы быстрее работать с функциями:
- Библиотека функций (слева): список всех функций. Двойной клик вставит вызов функции в код.
- Документация (справа): описание и параметры выбранной функции.
Защита данных с Jay Guard
Теперь в Agent Platform можно подключить Jay Guard. Этот сервис анализирует запросы к LLM и предотвращает утечки чувствительной информации.
При включенной интеграции запросы проходят через прокси Jay Guard и проверяются по настроенным правилам.
Проверка работает только для моделей с типом доступа Через Just AI. Для прямых подключений проксирование пока недоступно.
Чтобы настроить интеграцию:
- Получите API-ключ в Jay Guard и добавьте его в учетные данные (тип Jay Guard).
- Создайте интеграцию в разделе Интеграции → Подключить → Jay Guard.
- В настройках нужной LLM-модели включите опцию Проверять запросы к LLM с помощью Jay Guard.
Новые области видимости для баз данных
При создании встроенной базы данных для проекта теперь можно выбрать область видимости. Она определяет, на каком уровне будут храниться данные:
| Область видимости | Уровень хранения данных | Пример использования |
|---|---|---|
PROJECT | Общие для всего проекта. | База знаний, доступная всем пользователям. |
CHANNEL | Уникальные для каждого канала. | Разные приветствия для Telegram и WhatsApp. |
CLIENT | Персональные для каждого клиента. | Профиль пользователя, история его заказов. |
SESSION | Временные для одного диалога. | Корзина товаров в текущей сессии. |
Управлять записями через интерфейс можно только в базах с областями видимости ACCOUNT и PROJECT. Для остальных (CHANNEL, CLIENT, SESSION) управление данными доступно только из кода процесса.
Удобная настройка функций
Режимы заполнения значений
При настройке параметров функций доступны три режима заполнения значений:
| Режим | Описание |
|---|---|
| Поле | Визуальные поля ввода для структурированных данных. |
| JSON | Редактирование значения в виде JSON-кода (только для полей с типом object или array). |
| LLM | Автоматическое заполнение агентом во время выполнения. |
Режим LLM доступен только для функций-инструментов. В этом режиме агент самостоятельно определяет значения параметров на основе контекста диалога. Некоторые параметры, например используемая LLM и учетные данные, всегда задаются вручную.
Для переключения между режимами (поле/JSON и LLM) используйте иконки в заголовке параметра:
Обязательные параметры в функциях
Теперь при создании пользовательских функций можно отметить параметры как обязательные. Это поможет избежать ошибок при вызове функции.
Улучшения и исправления
Настройка тестового виджета
В тестовом виджете появилась настройка Отправлять /start при запуске. Включите ее, чтобы виджет автоматически запускал процесс при открытии, не дожидаясь вашего сообщения.
Настройка находится в верхней панели виджета ().
Права доступа для импорта и экспорта
Добавлены отдельные разрешения для импорта и экспорта проектов. Они автоматически назначены ролям AP_ADMIN и AP_DEVELOPER.
Подробнее о ролевой модели Agent Platform — в документации.
Исправлено добавление учетных данных SaluteSpeech
Исправлена ошибка, из-за которой не удавалось добавить учетные данные SaluteSpeech. Поля формы переименованы в Client ID и Client Secret.
Обновление уже доступно для всех пользователей. Делитесь впечатлениями и задавайте вопросы в нашем Telegram-чате!