aiassistant()

Назначение

Функция aiassistant() отправляет входной текст в узел ИИ Ассистент и возвращает текст ответа модели.

Синтаксис и аргументы

aiassistant(строка/текст[, опциональные параметры])

Для работы функции требуется один аргумент типа Строка или Текст.

Функция принимает следующие опциональные параметры:

prompt:=string/text – шаблон запроса (если опущен, используется запрос по умолчанию); assistant:=string – имя ассистента (прямой выбор); assistanttype:=string – тип ассистента, указанный в конфигураторе (используется с model:=); assistant_type:=string – используется как алиас для assistanttype:=string (для совместимости); model:=string – название модели, отображаемое в конфигураторе (используется с assistanttype:=); apibase:=string – дополнительный базовый фильтр API для разрешения модели; tokenizername:=string – дополнительный фильтр токенизатора для разрешения модели; key:=string – исходное значение ключа API; keyalias:=string – алиас для ключа/настроек подключения из Внешних служб; retriesnumber:=number – количество повторных попыток в случае возникновения предупреждений (по умолчанию 0); temperature:=number – температура запроса; generationtimeout:=number – время ожидания ответа в секундах; computationreuse:=yes/no – флаг для повторного использования результатов вычислений (для совместимости); promptslibrary:=yes/no – флаг для использования библиотеки промптов (для совместимости); convertsettings:=yes/no – флаг для использования настроек конвертера (для совместимости).

Для указания модели можно использовать параметр assistant:=. Если этот параметр не используется, то необходимо указать assistanttype:= и model:=. Модель должна быть указана явно.

Если используется параметр keyalias:=…​, то API-ключ модели должен быть занят через его алиас. В противном случае необходимо указать параметр key:=…​ (аутентификация без алиаса).

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

Функция возвращает текст ответа указанной модели.

Если ответ пуст (ответ не содержит результатов или для первого результата возвращается пустой текст), то функция выведет предупреждение и запишет его в журнал выполнения по тому же пути, что узел ИИ Ассистент.

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

Примеры

aiassistant("Какой город является столицей Испании?", assistanttype:="Anthropic", model:="Claude Haiku 4.5", keyalias:="main") возвращает Мадрид

aiassistant([text_column], prompt:="Дай краткий ответ:\n\n{text}", assistant:="User1", key:="sk-…​") возвращает ответ модели по заданному промпту