Skip to main content

Налады Gratis AI Agent

Экран Налады → Advanced (Налады → Падзейні) у Gratis AI Agent прадугледжвае канфігурацыю ўзроўню адміністратара для бэкэндавых інтэграцый, прадстаўленых у версіі v1.5.0. Гэтая старонка апісвае поля Feedback Endpoint і іх чакаваны фарматы.

Доступ да Наладаў

  1. У адмініструватары WordPress зайдзіце ў Gratis AI Agent → Settings.
  2. Націсніце на тэab Advanced.

Канфігурацыя Feedback Endpoint

Feedback endpoint атрымлівае POST-запыты ад AI агента ў кожны момант, калі карыстальнік адпраўляе водгук праз кнопку "палец-ніж" (thumbs-down), баннер аўтаматычнага прампту або камандрай /report-issue.

ПолеАпісан
Feedback Endpoint URLURL, які атрымлівае адпраўленне водгукаў як HTTP POST-запыты з JSON-тэлам.
Feedback API KeyBearer-токен, адпраўляецца ў заголовок Authorization кожнага запыту водгуку. Пакіньце пустым, калі ваш endpoint не патрабуе аўтэнтыкацыі.

Чакаванае JSON-тэла (Payload)

Ваш feedback endpoint павінен прымаць JSON-тэла з мінімум наступнымі полямі:

{
"message_id": "msg_abc123",
"conversation_id": "conv_xyz789",
"feedback_text": "Адказ быў неверным адносна цаны.",
"triage_category": "factual_error"
}

Додатковыя поля могуць быць прысутнічаць у тэле ў залежнасці ад кантексту размовы.

Значэнні triage_category

Сцэнрыванне AI (AI triage layer) прызначае адно з наступных значэнняў для triage_category перад перадачай тэла:

ЗначэннеЗначэнне
factual_errorАсістэнт прадастаўляў неверную фактычную інфармацыю.
unhelpful_answerАдказ быў тэхнічна правільным, але не карысным.
inappropriate_contentАдказ містшы кантэнт, які не павінен быць паказаны карыстальнікам.
otherВодгук не падыходзіў да вядомай катэгорыі.

Аўтэнтыкацыя

Калі ваш endpoint патрабуе аўтэнтыкацыі, ўставіце ў поле Feedback API Key свой bearer-токен. Агент адпраўляе:

Authorization: Bearer <your-api-key>

Калі поле Feedback API Key пусты, заголовок Authorization не адпраўляецца.

Выключэнне збору водгукаў

Пакіньце пустымі поля Feedback Endpoint URL і Feedback API Key. Кнопка "палец-ніж" і UI водгукаў застаюцца бачным для карыстальнікаў, але адпраўленне не перадаецца на канчатковы (external) сэрвіс.

Brave Search API Key

Таж на тэab Advanced поле Brave Search API Key дазваляе функцыянальнасць Internet Search.

ПолеАпісан
Brave Search API KeyВаш API-ключ з дашборда Brave Search developer. Неабходны для ўключэння пошуку ў Інтэрнэце ў AI асістэнта.

Маркіроўка поля ўключае клікабельнае спасылкі на старонку рэгістрацыі Brave Search API. Пакіньце пустым, каб выключыць пошук ў Інтэрнэце.

Для дадатковай інфармацыі для карыстальнікаў пра гэтую функцыю спадырайце Internet Search.

Feature Flags

Таж прадстаўлены ў v1.9.0, тэab Settings → Feature Flags прадугледжвае пераключальнікі для неабязавальнай функцыянальнасці. Кожны флаг можа быць уключаны або выключэн на ўсім сетцы; на дадзены момант няма перавышэння на ўзроўні сайта.

Доступ да Feature Flags

  1. У адмініструватары WordPress зайдзіце ў Gratis AI Agent → Settings.
  2. Націсніце на тэab Feature Flags.

Флагі кантролю доступу (Access Control Flags)

FlagDefaultDescription
Restrict to AdministratorsOffКалі ўключаны, толькі карыстальнікі з роллёй administrator могуць адкрыць чат-панель AI Agent. Усе іншыя ролі бачаць паведамленне "Свяжыцеся з вашым адміністратарам".
Restrict to Network AdminsOffКалі ўключаны на мультысайтавай сетцы, толькі Super Admins могуць выкарыстоўваць агента. Адміністратары індывідуальных сайтаў забанены. Мае прыярытэт над "Restrict to Administrators", калі ўключаны абодва.
Allow Subscriber AccessOffКалі ўключаны, карыстальнікі з роллёй subscriber могуць выкарыстоўваць чат-інтерфейс, але іх функцыянальнасць абмежавана толькі чытаннем (нельга ствараць пасты або змяняць налады).
Disable for Non-MembersOffІнтыгрэецца з статусам عзноўніка Ultimate Multisite. Калі ўключаны, чат скрываецца для сайтаў, якія не маюць актыўнага ўзносу.

Флагі брэнда (Branding Flags)

FlagDefaultDescription
Hide "Powered by Gratis AI Agent" FooterOffАдмяняе паказванне маркіроўкі ў падокэ ў нізку чат-віджэта. Рэкамендуецца для рэжымаў "біялаўка" (white-label deployments).
Custom Agent Name(blank)Замяняе пачатковую маркіроўку "Gratis AI Agent" у заголоўкі чату і адмін-меню на назву вашага прадукту. Пакіньце пустым, каб выкарыстоўваць пачатковую.
Hide Agent PickerOffКалі ўключаны, карыстальнікі не могуць пераключацца паміж п'яць ўбудаванымі агентамі. Актыўны агент фіксуецца на тым, што ўстаноўлена як пачатковы ў Settings → General.
Use Site Icon as Chat AvatarOffЗамяняе пачатковы значок AI у заголоўкі чат-віджэта на значок сайта WordPress (устаноўлены ў Appearance → Customize → Site Identity).

Застоўванне Зменыў

Націсніце Save Settings пасля пераключэння знаёў. Змены ўступаюць у сілу неадкладна — не патрабуецца очишчаць кэш або актываваць плагін.