WordPress 7.0: Нативний AI Client ядра (PHP API)

<?php
declare(strict_types=1);

/**
* Author: Artur Yusupov (Fullstack Agentic Lab)
* Package: @agentic-lab/core-ai
* Module: PostSeoMetadataGenerator
* Standard: WordPress 7.0+ Core AI Subsystem / PHP 8.4 Strict
*/

namespace AgenticLab\AiCore\Application;

use WP_AI_Client;
use WP_AI_Message;
use WP_AI_Schema;
use WP_AI_Response;
use WP_Error;
use Throwable;

final readonly class PostSeoMetadataDto
{
  /**
   * @param list<string> $keywords
   */
  public function __construct(
      public string $metaTitle,
      public string $metaDescription,
      public array $keywords,
      public int $readingTimeMinutes,
      public string $toneOfVoice
  ) {}
}

final class PostSeoMetadataGenerator
{
  private WP_AI_Client $aiClient;

  public function __construct()
  {
      // Получение инстанса нативного клиента ядра WordPress 7.0
      $this->aiClient = function_exists('wp_get_ai_client') 
          ? wp_get_ai_client() 
          : new WP_AI_Client();
  }

  /**
   * Анализ контента статьи и генерация строго типизированного SEO-манифеста.
   *
   * @param string $postTitle Заголовок статьи
   * @param string $postContent Основной текст статьи
   * @return PostSeoMetadataDto|WP_Error
   */
  public function generate(string $postTitle, string $postContent): PostSeoMetadataDto|WP_Error
  {
      // 1. Декларация схемы Structured Output через системный класс ядра
      $schema = new WP_AI_Schema([
          'type'                 => 'object',
          'properties'           => [
              'meta_title' => [
                  'type'        => 'string',
                  'description' => 'Привлекательный SEO-заголовок длиной до 60 символов.',
              ],
              'meta_description' => [
                  'type'        => 'string',
                  'description' => 'Краткое описание для сниппета поисковика длиной до 160 символов.',
              ],
              'keywords' => [
                  'type'        => 'array',
                  'items'       => ['type' => 'string'],
                  'description' => 'Список из 3-5 релевантных поисковых запросов.',
              ],
              'reading_time_minutes' => [
                  'type'        => 'integer',
                  'description' => 'Расчетное время прочтения статьи в минутах.',
              ],
              'tone_of_voice' => [
                  'type'        => 'string',
                  'enum'        => ['technical', 'business', 'casual'],
                  'description' => 'Стиль изложения контента.',
              ],
          ],
          'required'             => ['meta_title', 'meta_description', 'keywords', 'reading_time_minutes', 'tone_of_voice'],
          'additionalProperties' => false,
      ]);

      // 2. Сборка диалогового контекста
      $messages = [
          WP_AI_Message::system(
              'Вы — главный эксперт по поисковой оптимизации для изданий enterprise-уровня. ' .
              'Анализируйте материалы и генерируйте высококонверсионные метаданные строго по схеме.'
          ),
          WP_AI_Message::user(
              "Заголовок статьи: {$postTitle}\n\nСодержимое:\n" . mb_substr(wp_strip_all_tags($postContent), 0, 8000)
          ),
      ];

      // 3. Вызов нативного ядра с гарантированной схемой Structured Output
      try {
          /** @var WP_AI_Response|WP_Error $response */
          $response = $this->aiClient->chat([
              'messages'        => $messages,
              'response_format' => $schema,
              'temperature'     => 0.2,
              'max_tokens'      => 800,
          ]);

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

          // 4. Извлечение валидированных данных из ответа ядра
          $data = $response->get_structured_data();

          if (!is_array($data)) {
              return new WP_Error('ai_invalid_output', __('Ядро не смогло распарсить структурированный ответ.', 'agentic-lab'));
          }

          // 5. Формирование иммутабельного DTO
          return new PostSeoMetadataDto(
              metaTitle: (string) ($data['meta_title'] ?? ''),
              metaDescription: (string) ($data['meta_description'] ?? ''),
              keywords: (array) ($data['keywords'] ?? []),
              readingTimeMinutes: (int) ($data['reading_time_minutes'] ?? 5),
              toneOfVoice: (string) ($data['tone_of_voice'] ?? 'technical')
          );
      } catch (Throwable $e) {
          return new WP_Error(
              'ai_client_exception',
              sprintf(__('Исключение при вызове WP_AI_Client: %s', 'agentic-lab'), $e->getMessage()),
              ['exception' => $e]
          );
      }
  }
}