---
name: yourstack-order
description: Понимает сообщение о заказе через Yourstack: где заказ, изменить, отменить или новый. Use when shop messages mix tracking questions, edits, cancellations, and new orders.
---

# Заказ

Сообщение про заказ бывает четырёх видов. Сценарий выбирает, какое оно, чтобы агент не искал трек там, где человек хочет отмену.

Навык вызывает JEV — бесплатную модель Yourstack, которая выбирает из вариантов. Она не пишет текст. На каждый вопрос возвращает долю только тех вариантов, которые перечислены ниже.

## Ключ

Возьми ключ из переменной окружения `YOURSTACK_API_KEY`. Если её нет, один раз спроси ключ у пользователя. Не записывай ключ в файлы проекта и не повторяй его в ответе.

Адрес API: `https://yourstack.ru`

## Предел

Вызовы `POST /v1/decisions` бесплатны, лимита на их число нет. Если модель перегружена и вернула 429, подожди несколько секунд и повтори тот же вызов. Вход длиннее 32000 токенов сервис отклонит, обрезать его он не будет.

## Вопросы

Задавай их по порядку, каждый отдельным вызовом. Формулировки и варианты не меняй. Свой вариант не добавляй.

### Заказ

Ключ вопроса: `order`

Вопрос, дословно: О чём это сообщение про заказ?

Варианты, дословно:

- id `where`: Человек спрашивает статус, трек или срок уже оформленного заказа.
- id `change`: Просит поменять адрес, состав или время уже оформленного заказа.
- id `cancel`: Просит отменить заказ или вернуть его, потому что передумал.
- id `new`: Хочет оформить заказ. Готового номера ещё нет.

## Вызов

`POST https://yourstack.ru/v1/decisions`

Заголовки: `Authorization: Bearer <ключ>`, `Content-Type: application/json`.

Тело:

```json
{
  "state": "<текст одного обращения или одной задачи>",
  "question": "<вопрос дословно>",
  "options": [
    {"id": "<id>", "description": "<описание дословно>"}
  ]
}
```

В ответе `choice` — id ближайшего варианта. У каждого варианта в `options` есть `probability` от 0 до 1.

Доля — это не уверенность модели и не обещание, что выбор верный. Если у ближайшего варианта probability ниже 0,6, пометь вопрос как «неясно» и не принимай решение автоматически.


## Что ответить пользователю

Не подменяй ответ модели своей догадкой. Если вызов не удался, так и скажи. В конце укажи, сколько было вызовов JEV. Они бесплатны. Если навык вызывал чат, назови сумму из заголовка `X-Yourstack-Cost-Rub`.
