mirror of
https://github.com/WordPress/WordPress.git
synced 2026-06-19 07:37:07 +00:00
Weston Ruter
dde3a47f0b
This checks that the return value of the `wp_ai_client_default_request_timeout` filter is a non-negative number before passing it to `RequestOptions`. If the filtered value is invalid, it is discarded in favor of the original default of `30.0` and a `_doing_it_wrong()` notice is issued. Without this check, a fatal error would ensue from the exception thrown in `\WordPress\AiClient\Providers\Http\DTO\RequestOptions::validateTimeout()`. The following static analysis issues are addressed: * Use `float` instead of `int` for the `wp_ai_client_default_request_timeout` filter parameter. * Add missing PHP imports for `Message` and `MessagePart` in the PHPDoc for `wp_ai_client_prompt()`. * Add PHP return type hints for `wp_ai_client_prompt()` and `WP_AI_Client_Cache::getMultiple()`. * Use native property type hints in `WP_AI_Client_HTTP_Client`. Developed in https://github.com/WordPress/wordpress-develop/pull/11596 Props westonruter, justlevine, flixos90, khushdoms, darshitrajyaguru97, adrmf25, jarodortegaaraya, tusharaddweb, gaurangsondagar. Fixes #65094. Built from https://develop.svn.wordpress.org/trunk@62255 git-svn-id: http://core.svn.wordpress.org/trunk@61535 1a063a9b-81f0-0310-95a4-ce76da25c4cd
63 lines
2.5 KiB
PHP
63 lines
2.5 KiB
PHP
<?php
|
|
/**
|
|
* WordPress AI Client API.
|
|
*
|
|
* @package WordPress
|
|
* @subpackage AI
|
|
* @since 7.0.0
|
|
*/
|
|
|
|
use WordPress\AiClient\AiClient;
|
|
use WordPress\AiClient\Messages\DTO\Message;
|
|
use WordPress\AiClient\Messages\DTO\MessagePart;
|
|
|
|
/**
|
|
* Returns whether AI features are supported in the current environment.
|
|
*
|
|
* @since 7.0.0
|
|
*
|
|
* @return bool Whether AI features are supported.
|
|
*/
|
|
function wp_supports_ai(): bool {
|
|
// Return early if AI is disabled by the current environment.
|
|
if ( defined( 'WP_AI_SUPPORT' ) && ! WP_AI_SUPPORT ) {
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Filters whether the current request can use AI.
|
|
*
|
|
* This allows plugins and 3rd-party code to disable AI features on a per-request basis, or to even override explicit
|
|
* preferences defined by the site owner.
|
|
*
|
|
* @since 7.0.0
|
|
*
|
|
* @param bool $is_enabled Whether AI is available. Default to true.
|
|
*/
|
|
return (bool) apply_filters( 'wp_supports_ai', true );
|
|
}
|
|
|
|
/**
|
|
* Creates a new AI prompt builder using the default provider registry.
|
|
*
|
|
* This is the main entry point for generating AI content in WordPress. It returns
|
|
* a fluent builder that can be used to configure and execute AI prompts.
|
|
*
|
|
* The prompt can be provided as a simple string for basic text prompts, or as more
|
|
* complex types for advanced use cases like multi-modal content or conversation history.
|
|
*
|
|
* @since 7.0.0
|
|
*
|
|
* @param string|MessagePart|Message|array|list<string|MessagePart|array>|list<Message>|null $prompt Optional. 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.
|
|
* @return WP_AI_Client_Prompt_Builder The prompt builder instance.
|
|
*/
|
|
function wp_ai_client_prompt( $prompt = null ): WP_AI_Client_Prompt_Builder {
|
|
return new WP_AI_Client_Prompt_Builder( AiClient::defaultRegistry(), $prompt );
|
|
}
|