---
name: yourstack-bill
description: Раскладывает письма бухгалтерии через Yourstack: счёт, вопрос об оплате, закрывающие документы или не про деньги. Use when an accounting inbox should be sorted before anyone opens every message.
---

# Платёжное письмо

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

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

## Ключ

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

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

## Предел

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

## Вопросы

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

### Документ

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

Вопрос, дословно: К чему относится это письмо?

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

- id `invoice`: Просят оплатить выставленный счёт или прислали новый счёт.
- id `pay`: Спрашивают про уже отправленные деньги: платёж не дошёл или нужно подтверждение.
- id `act`: Акт, накладная или счёт-фактура. Работу закрывают, а не просят новую оплату как главное.
- id `other`: Письмо не про счёт, оплату и закрывающие документы.

## Вызов

`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`.
