# Ниеттер

**Ниет** — оркестратордың пікірінше хабарлама не істегісі келетіні: іздеу, бірдеңені қосу, бетті ашу, төлеу немесе жай сөйлесу. Планировщик ниетті мақсатқа айналдырады және оған жеткізе алатын құралдарды таңдайды.

## Қазіргі мінез-құлық

Бүгінгі күні онлайн-дүкенге арналған бір бекітілген таксономия бар (`packages/core/src/goap/intent-taxonomy.ts`). Бұл — планировщиктің дүкен-домен қабаты; қалғанының бәрі (құрал атаулары, схемалар, сипаттамалар) сайттан келеді.

| Ниет | Мағынасы |
| --- | --- |
| `chat` | Қарапайым әңгіме; құрал қажет емес. |
| `chooseStore` | Белгілі бір дүкенге өту немесе оған ауысу. |
| `navigate` | Сайттың бетін ашу. |
| `search` | Тауарларды іздеу немесе не бар екенін сұрау. |
| `filter` | Нәтижелерді тарылту. |
| `select` | Нәтижелерден бір тауарды ашу немесе таңдау. |
| `addToCart` | Бірдеңе сатып алу немесе себетке салу. |
| `removeFromCart` | Бірдеңені алып тастау. |
| `checkout` | Төлеп, тапсырыс беру. |
| `paginate` | Тағы нәтижелер, келесі бет. |
| `compare` | Тауарларды салыстыру. |
| `other` | Қалған кез келген нәрсе. |

(`readState` та бар, бірақ тек *құралдың* рөлі ретінде: сайт ұстап тұрған нәрсені, мысалы себетті немесе брондауларды оқитын құрал. Хабарлама ешқашан `readState` ретінде жіктелмейді.)

Әр ниеттің бекітілген әсерлері мен алғышарттары бар (мысалы, `addToCart` үшін дүкен ашық, іздеу орындалған және сұраныс талданған болуы керек). Планировщик құралдарды осылар арқылы тізбектейді. Құралға ниет оның атауы бойынша тағайындалады ([Құралдар](/kk/docs/tools/#Оркестратор-құралды-қалай-оқиды) бөлімін қараңыз).

### Хабарлама қалай жіктеледі

Мына реттілікпен, бірінші сәйкес келгені жеңеді:

1. **Сөздер.** Лексикалық ережелер тек `checkout` пен `removeFromCart` ниеттерін шешеді. Олар бастапқы мәтін мен оның ағылшынша аудармасына қарсы тексеріледі, ағылшын және орыс тілдерінде.
2. **Сайт жады.** Әр арна бойынша әкімші бекіткен (немесе жоғары сенімділікпен автоматты түрде бекітілген) мысалдарда оқытылған шағын классификатор. Сенімділік 0,85-тен төмен болса, ол үнсіз қалады және `checkout` немесе `removeFromCart` үшін ешқашан қолданылмайды.
3. **Laya**, шешім моделі, хабарламаның ағылшынша аудармасында. `checkout` және `removeFromCart` бойынша оның жауабы алынып тасталады және `chat` деп саналады.
4. Laya қателессе немесе жарамды ештеңе қайтармаса, **`chat`-қа қайту** (алдымен сөздер тағы бір рет тексеріледі).

`checkout` пен `removeFromCart` жанама әсерлері бар ниеттер, оларды қайта жоспарлау арқылы кері қайтару мүмкін емес, сондықтан олар тек хабарламадағы айқын сөздерден шығады. Модельдің жай болжамы ешқашан төлемді жасамайды және себетті босатпайды.

Laya жауаптары әр арна бойынша мысал ретінде сақталады. Әрқайсысы әкімші оны әкімші панелінің **Intents** бетінде бекітпейінше, қабылдамайынша немесе түзетпейінше, не оның калибрленген сенімділігі `LAYA_AUTO_APPROVE_CONFIDENCE` мәніне (әдепкі 0,85) жетіп, автоматты түрде бекітілмейінше `pending` күйінде болады. Бекітілген мысал арнаның жады келесі жолы не жауап беретінін өзгертеді.

### Дүкеннен тыс бұл нені білдіреді

Таксономия келуші іздейтін, қосатын және төлейтін сайттарға сай келеді. Басқа сайттарда кейбір әрекеттерге сәйкес ниет жоқ. Пицца мысалы: «пиццаны үлкенірек жаса» деген `addToCart` ретінде оқылуы мүмкін, ал `other` деп жіктелген және әсері жоқ `set_pizza_size` сияқты құрал жоспардың мақсаты бола алмайды. Бұл — төменде жоспарланған жұмыс алып тастайтын белгілі шектеу.

## Жоспарда: арналар бойынша ниет пакеттері

> **Жоспарда, жүзеге асырылмаған.** GitHub-тағы PO-41 issue ретінде жүргізіледі. Төмендегінің ешқайсысы әзірге жұмыс істемейді.

Идея: ниеттер жиыны кодқа емес, арнаға тиесілі болады:

- **Кірістірілген «Online shop» пакеті.** Жоғарыдағы қазіргі таксономия: Laya сипаттамалары, әсерлер, алғышарттар, `checkout` және `removeFromCart` үшін «тек айқын сөздер бойынша» ережесі және қадам мәтіндері. Тек оқуға арналған; агент профильдері сияқты көшіріп, өңдеуге болады.
- **Пакеті жоқ арна** (жаңа арналар үшін жоспарланған әдепкі). Хабарлама сайттың құралын тікелей таңдайды: Laya құралды атауы мен сипаттамасы бойынша (және `chat`) таңдайды, ал мақсат — сол құралдың нәтижесі. Таксономия жоқ, сондықтан кез келген сайтта жұмыс істейді.
- **Бар арналар** «Online shop» пакетіне көшіріледі, сондықтан олардың мінез-құлқы өзгермейді.
- **Әкімші панелі.** Пакетті арна баптауларында таңдау; пакетке арналған экран.

<!-- TODO: PO-41 is OPEN at the time of writing; re-read `gh issue view 41` before publishing and update this section. The issue also plans a "when to take a ready pack, when to work without one" guide for these docs. -->
