AI Bridge

AI Bridge - це опціональний модуль, який надає дані вашого магазину асистентам AI та інструментам у контрольований спосіб. Складається з двох частин. Перша - це набір можливостей (abilities) лише для читання, зареєстрованих у WordPress Abilities API (WP 6.9+), завдяки чому палітра команд редактора сайту, сервери MCP та асистенти AI можуть читати ті самі факти, які бачить адміністратор. Друга - це дві функції на основі AI в панелі: підсумок товару та чернетка текстів безпеки GPSR, що використовують WordPress AI Client (WP 7.0+) через постачальника, налаштованого на сайті.

Модуль нічого не змінює автоматично. Можливості виключно читають дані, а функції AI створюють пропозиції для перегляду, ніколи не перезаписуючи поля, що потребують ручної авторизації. Плагін ніколи не зберігає ключ постачальника AI. Це допоміжний інструмент, а не юридична консультація чи гарантія відповідності.

Увімкнення модуля

Модуль за замовчуванням вимкнено. Увімкніть його в WooCommerce > Polski > Модулі (розділ “AI Bridge”, ключ модуля ai_bridge). Після увімкнення:

• на WordPress 6.9+ реєструються торгові можливості (коли Abilities API доступне); на старішому WordPress модуль працює без помилки, просто пропускає реєстрацію,
• функції AI (підсумок товару, чернетка GPSR) стають доступними лише тоді, коли на сайті налаштовано постачальника AI, що підтримує генерування тексту (через WP AI Client / конектор, наприклад Anthropic, Google, OpenAI, Vercel AI Gateway). Без налаштованого постачальника ці функції просто не активуються, а детермінований канал AI Feed залишається недоторканим.

Торгові можливості (лише для читання)

Усі можливості належать до категорії polski-commerce, позначені як readonly і show_in_rest та захищені перевіркою дозволу WooCommerce manage_woocommerce. Кожна підключена до наявної служби плагіна, тож не дублює логіку. Нічого не змінюється.

Можливість (id)	Що повертає	Вхід
polski/get-omnibus-history	Історія цін і найнижча зафіксована ціна товару (як у поданні за директивою Omnibus).	product_id
polski/get-gpsr-data	Дані безпеки товару (GPSR): виробник, імпортер, відповідальна особа, ідентифікатор, попередження, інструкції.	product_id
polski/list-products-missing-gpsr	Опубліковані товари, яким бракує одного чи кількох полів GPSR, щоб знайти й заповнити прогалини.	limit (1-200), offset
polski/get-compliance-status	Результат евристичних перевірок налаштованих правових сторінок (Регламент, Приватність, Повернення, Рекламації) з оцінкою.	page_type (опціонально)
polski/get-store-health	Найновіший знімок стану магазину (загальний статус та сенсори помилок, платежів і продажів).	(немає)
polski/get-product-facts	Структурований список фактів про товар (пари мітка/значення), наданий через AI Feed: SKU, GTIN, ціна, категорії, час доставки та інше.	product_id

Кожен виклик проходить через permission_callback, що перевіряє manage_woocommerce. Користувач без цього дозволу не отримає даних. Можливості доступні через REST (/wp-json/wp-abilities/v1/...), коли Abilities API активне.

Підсумок товару (AI)

Згенерований на запит адміністратора фактологічний підсумок товару. Працює лише коли модуль увімкнено та налаштовано постачальника AI, що підтримує текст. Нічого не створюється при завантаженні сторінки.

Аспект	Поведінка
Джерело даних	Назва, короткий і довгий опис товару та список фактів AI Feed - лише дані, які магазин уже публікує.
Модель	Інструктована використовувати виключно надані факти, не вигадувати специфікації чи ціни, без маркетингових формулювань і без правових декларацій.
Довжина	Короткий, 1-3 речення; запис обмежено 600 символами.
Запис	Зберігається в меті товару (_polski_ai_summary) виключно після явного запуску адміністратором.
Відсутність постачальника	Функція недоступна; нічого не відбувається, а решта шляхів працюють без змін.

Чернетка текстів безпеки GPSR (AI)

Помічник, що створює чернетку попереджень про безпеку та інструкцій з використання товару як відправну точку для ручної перевірки. Це редакційна підтримка, а не юридична консультація чи гарантія відповідності.

Аспект	Поведінка
Джерело даних	Публічний опис товару та вже введені (людиною) поля GPSR, щоб чернетка не суперечила наявним даним.
Модель	Інструктована використовувати виключно надані факти, не вигадувати загрози чи сертифікати та не натякати на правову відповідність.
Запис	Виключно до окремої, однозначно названої мети чернетки (_polski_ai_gpsr_draft). Ніколи не перезаписує справжні поля GPSR.
Перегляд	Адміністратор має прочитати чернетку та вручну перенести вміст до відповідних полів після перевірки. Кожна чернетка містить примітку, що вона лише для перегляду і не є гарантією відповідності.
Довжина	Кожне поле чернетки обмежено 1500 символами.

Приватність і ключі

Плагін ніколи не зберігає ключ постачальника AI і сам не виконує мережевих запитів до постачальника. Облікові дані та мережевий виклик належать конектору AI, налаштованому в WordPress (модель “принеси власний ключ”). До моделі потрапляють виключно дані, які магазин і так уже публікує чи зберігає.

Усунення несправностей

Можливості не з’являються - переконайтеся, що у вас WordPress 6.9+ з активним Abilities API і що модуль AI Bridge увімкнено. На старішому WordPress реєстрація пропускається без помилки.

Функції AI неактивні (затемнені) - налаштуйте постачальника AI, що підтримує генерування тексту через WP AI Client / конектор. Без постачальника підсумок і чернетка GPSR залишаються неактивними.

Немає даних з можливостей - перевірте, чи поточний користувач має дозвіл manage_woocommerce.

Повідомлення про проблеми: github.com/wppoland/polski/issues

Ця сторінка має виключно інформаційний характер і не є юридичною консультацією. Перед впровадженням проконсультуйтеся з юристом. Polski for WooCommerce є програмним забезпеченням з відкритим кодом (GPLv2), що постачається без гарантій.