Skip to main content
Version: 1.12.0

AINPromptBuilder

Используйте методы класса AINPromptBuilder для построения промптов на основе шаблонов промптов и записей системы SimpleOne.

AINPromptBuilder(templateName)


Используйте этот метод, чтобы создать экземпляр класса AINPromptBuilder.

Параметры:

НаименованиеТипОбязательноОписание
templateNameStringДаИмя шаблона промпта.

Пример:

AINPromptBuilder()
new AINPromptBuilder(templateName)

build(record)


Используйте этот метод серверного API, чтобы получить готовый промпт на основе шаблона промпта, в тело которого подставляются данные переданной записи. Перед парсингом система ищет переопределенный шаблон промпта с параметром used = true. Если такой найден, используется он вместо основного шаблона.

В параметре record укажите запись SimpleRecord. Если указано значение null, в возвращаемом значении будет передан текст шаблона с вырезанными местозаполнителями.

Параметры:

НаименованиеОбязательноТипЗначение по умолчанию
recordДаSimpleRecordНет

Возвращаемое значение:

ТипОписание
StringПреобразованный промпт с подставленными значениями из указанной записи.

Пример:

AINPromptBuilder()
const prompt = new AINPromptBuilder("myTemplate").build(record);

buildFromServer(tableName, recordId, templateName)


Этот метод является дублером серверного метода build() и может использоваться в качестве клиентского для вызова через AJAX.

Параметры:

НаименованиеОбязательноТипЗначение по умолчаниюОписание
tableNameДаStringНетНазвание таблицы, в которой содержится запись, данные которой должны быть подставлены в промпт.
recordIdДаStringНетID записи, данные которой должны подставляться в шаблон промпта.
templateNameДаStringНетНазвание шаблона, который используется для создания промпта. Если для шаблона промпта есть активная запись переопределения шаблона промпта, использоваться будет она.

Пример:

Клиентский вызов через AJAX
const prompt = await AINPromptBuilder.buildFromServer(tableName, recordId, templateName);

Обработка ошибок

  • При несоответствии типа записи ожидаемой таблице в системе регистрируется ошибка.
  • При отсутствии шаблона возвращается ошибка.
  • Некорректные местозаполнители игнорируются или обрабатываются в соответствии с настройками системы.