wp_ai_client_prompt() │ WP 7.0.0

Создаёт объект билдера промпта для AI и позволяет описать AI-запрос через цепочку методов: текст промпта, системную инструкцию, предпочтительные модели, файлы, формат ответа и другие параметры.

Функция является основной точкой входа в AI Client API. Она не обращается к конкретному провайдеру напрямую: сайт сам использует настроенные AI-коннекторы и подбирает подходящую модель по возможностям запроса.

Через полученный WP_AI_Client_Prompt_Builder{} можно запускать генерацию текста, изображений и других результатов, а также заранее проверять, поддерживается ли нужная возможность на текущем сайте.

Сам вызов функции только создаёт объект. AI-запрос выполняется позже — когда вызывается метод генерации, например generate_text() или generate_image_result().

AI-функции могут быть недоступны, даже если WordPress поддерживает AI Client. На сайте должен быть настроен подходящий AI-коннектор, а выбранный провайдер должен поддерживать нужный тип генерации.

Работает на основе: WP_AI_Client_Prompt_Builder(), AiClient::defaultRegistry()

Хуков нет.

Возвращает

WP_AI_Client_Prompt_Builder.

  • WP_AI_Client_Prompt_Builder — объект строителя промпта, через который настраивается и выполняется AI-запрос.

Использование

wp_ai_client_prompt( $prompt ): WP_AI_Client_Prompt_Builder;
$prompt(string|array|null)

Начальное содержимое промпта. Обычно передаётся строка с текстом запроса.

Если параметр не передан, текст можно добавить позже через метод WP_AI_Client_Prompt_Builder::with_text().

По умолчанию: null

Примеры

0

#1 Генерация простого текста

Создадим промпт, получим текстовый ответ и проверим результат на ошибку.

$text = wp_ai_client_prompt( 'Кратко опиши преимущества кэширования в WordPress.' )
	->using_temperature( 0.7 )
	->generate_text();

if ( is_wp_error( $text ) ) {
	wp_die( esc_html( $text->get_error_message() ) );
}

echo wp_kses_post( $text );
0

#2 Создание промпта через методы билдера

Тот же запрос можно собрать постепенно. Это удобно, когда часть данных приходит из формы, записи или настроек плагина.

$builder = wp_ai_client_prompt()
	->with_text( 'Напиши короткое описание для записи о безопасности WordPress.' )
	->using_system_instruction( 'Отвечай простым языком. Не используй рекламный стиль.' );

$text = $builder->generate_text();

if ( is_wp_error( $text ) ) {
	return;
}

echo wp_kses_post( $text );
0

#3 Проверка поддержки генерации изображений

Перед выводом интерфейса генерации лучше проверить, есть ли на сайте подходящий AI-коннектор.

$is_supported = wp_ai_client_prompt()
	->with_text( 'test' )
	->is_supported_for_image_generation();

if ( ! $is_supported ) {
	return;
}

// Здесь можно подключить интерфейс генерации изображений.
0

#4 Генерация изображения через AI Client

Пример создаёт билдер промпта для генерации изображения и получает полный объект результата.

use WordPress\AiClient\Files\Enums\FileTypeEnum;
use WordPress\AiClient\Files\Enums\MediaOrientationEnum;

$builder = wp_ai_client_prompt()
	->with_text( 'Generate a clean illustration of a WordPress dashboard on a laptop.' )
	->as_output_file_type( FileTypeEnum::inline() )
	->as_output_media_orientation( MediaOrientationEnum::from( 'landscape' ) );

$result = $builder->generate_image_result();

if ( is_wp_error( $result ) ) {
	wp_die( esc_html( $result->get_error_message() ) );
}

return $result;

Список изменений

С версии 7.0.0 Введена.

Код wp_ai_client_prompt() WP 7.0

wp-includes/ai-client.php 
function wp_ai_client_prompt( $prompt = null ): WP_AI_Client_Prompt_Builder {
	return new WP_AI_Client_Prompt_Builder( AiClient::defaultRegistry(), $prompt );
}

AI