Title: WP_AI_Client_Prompt_Builder::__construct
Published: May 20, 2026

---

# WP_AI_Client_Prompt_Builder::__construct( WordPressAiClientProvidersProviderRegistry $registry, Prompt $prompt = null )

## In this article

 * [Parameters](https://developer.wordpress.org/reference/classes/wp_ai_client_prompt_builder/__construct/?output_format=md#parameters)
 * [Source](https://developer.wordpress.org/reference/classes/wp_ai_client_prompt_builder/__construct/?output_format=md#source)
 * [Hooks](https://developer.wordpress.org/reference/classes/wp_ai_client_prompt_builder/__construct/?output_format=md#hooks)
 * [Related](https://developer.wordpress.org/reference/classes/wp_ai_client_prompt_builder/__construct/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/classes/wp_ai_client_prompt_builder/__construct/?output_format=md#changelog)

[ Back to top](https://developer.wordpress.org/reference/classes/wp_ai_client_prompt_builder/__construct/?output_format=md#wp--skip-link--target)

Constructor.

## 󠀁[Parameters](https://developer.wordpress.org/reference/classes/wp_ai_client_prompt_builder/__construct/?output_format=md#parameters)󠁿

 `$registry`WordPressAiClientProvidersProviderRegistryrequired

The provider registry for finding suitable models.

`$prompt`Promptoptional

Initial prompt content.
 A string for simple text prompts, a MessagePart or Message
object for structured content, an array for a message array shape, or a list of 
parts or messages for multi-turn conversations.

Default:`null`

## 󠀁[Source](https://developer.wordpress.org/reference/classes/wp_ai_client_prompt_builder/__construct/?output_format=md#source)󠁿

    ```php
    public function __construct( ProviderRegistry $registry, $prompt = null ) {
    	try {
    		$this->builder = new PromptBuilder( $registry, $prompt, AiClient::getEventDispatcher() );
    	} catch ( Exception $e ) {
    		$this->builder = new PromptBuilder( $registry, null, AiClient::getEventDispatcher() );
    		$this->error   = $this->exception_to_wp_error( $e );
    	}

    	$default_timeout = 30.0;

    	/**
    	 * Filters the default request timeout in seconds for AI Client HTTP requests.
    	 *
    	 * @since 7.0.0
    	 *
    	 * @param float $default_timeout The default timeout in seconds.
    	 */
    	$filtered_default_timeout = apply_filters( 'wp_ai_client_default_request_timeout', $default_timeout );
    	if ( is_numeric( $filtered_default_timeout ) && (float) $filtered_default_timeout >= 0.0 ) {
    		$default_timeout = (float) $filtered_default_timeout;
    	} else {
    		_doing_it_wrong(
    			__METHOD__,
    			sprintf(
    				/* translators: %s: wp_ai_client_default_request_timeout */
    				__( 'The %s filter must return a non-negative number.' ),
    				'<code>wp_ai_client_default_request_timeout</code>'
    			),
    			'7.0.0'
    		);
    	}

    	$this->builder->usingRequestOptions(
    		RequestOptions::fromArray(
    			array(
    				RequestOptions::KEY_TIMEOUT => $default_timeout,
    			)
    		)
    	);
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/ai-client/class-wp-ai-client-prompt-builder.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/7.0/src/wp-includes/ai-client/class-wp-ai-client-prompt-builder.php#L185)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.0/src/wp-includes/ai-client/class-wp-ai-client-prompt-builder.php#L185-L224)

## 󠀁[Hooks](https://developer.wordpress.org/reference/classes/wp_ai_client_prompt_builder/__construct/?output_format=md#hooks)󠁿

 [apply_filters( ‘wp_ai_client_default_request_timeout’, float $default_timeout )](https://developer.wordpress.org/reference/hooks/wp_ai_client_default_request_timeout/)

Filters the default request timeout in seconds for AI Client HTTP requests.

## 󠀁[Related](https://developer.wordpress.org/reference/classes/wp_ai_client_prompt_builder/__construct/?output_format=md#related)󠁿

| Uses | Description | 
| [RequestOptions::fromArray()](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-dto-requestoptions/fromarray/)`wp-includes/php-ai-client/src/Providers/Http/DTO/RequestOptions.php` |

{@inheritDoc}

  | 
| [PromptBuilder::__construct()](https://developer.wordpress.org/reference/classes/wordpress-aiclient-builders-promptbuilder/__construct/)`wp-includes/php-ai-client/src/Builders/PromptBuilder.php` |

Constructor.

  | 
| [AiClient::getEventDispatcher()](https://developer.wordpress.org/reference/classes/wordpress-aiclient-aiclient/geteventdispatcher/)`wp-includes/php-ai-client/src/AiClient.php` |

Gets the event dispatcher for prompt lifecycle events.

  | 
| [WP_AI_Client_Prompt_Builder::exception_to_wp_error()](https://developer.wordpress.org/reference/classes/wp_ai_client_prompt_builder/exception_to_wp_error/)`wp-includes/ai-client/class-wp-ai-client-prompt-builder.php` |

Converts an exception into a [WP_Error](https://developer.wordpress.org/reference/classes/wp_error/) with a structured error code and message.

  | 
| [__()](https://developer.wordpress.org/reference/functions/__/)`wp-includes/l10n.php` |

Retrieves the translation of $text.

  | 
| [_doing_it_wrong()](https://developer.wordpress.org/reference/functions/_doing_it_wrong/)`wp-includes/functions.php` |

Marks something as being incorrectly called.

  | 
| [apply_filters()](https://developer.wordpress.org/reference/functions/apply_filters/)`wp-includes/plugin.php` |

Calls the callback functions that have been added to a filter hook.

  |

[Show 3 more](https://developer.wordpress.org/reference/classes/wp_ai_client_prompt_builder/__construct/?output_format=md#)
[Show less](https://developer.wordpress.org/reference/classes/wp_ai_client_prompt_builder/__construct/?output_format=md#)

| Used by | Description | 
| [wp_ai_client_prompt()](https://developer.wordpress.org/reference/functions/wp_ai_client_prompt/)`wp-includes/ai-client.php` |

Creates a new AI prompt builder using the default provider registry.

  |

## 󠀁[Changelog](https://developer.wordpress.org/reference/classes/wp_ai_client_prompt_builder/__construct/?output_format=md#changelog)󠁿

| Version | Description | 
| [7.0.0](https://developer.wordpress.org/reference/since/7.0.0/) | Introduced. |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fclasses%2Fwp_ai_client_prompt_builder%2F__construct%2F)
before being able to contribute a note or feedback.