shvydko
ДокументаціяПочаток
Усі теми

SHVYDKO / Початок

Перший запит

Від прикладу в Playground до типізованого рішення у вашому застосунку.

01. Спробуйте в кабінеті

Створіть обліковий запис і відкрийте Playground. Додайте контекст, сформулюйте питання та виберіть Choice, Score або Noul. Перед запуском перевірте активну організацію: її ключі, ліміти й історія запитів спільні для учасників.

Для першої перевірки використайте вигадане звернення нижче. Модель повертає рішення у визначеній структурі; довільна текстова відповідь для цієї задачі не потрібна.

Відкрити Playground

02. Підготуйте ключ і середовище

Власник або адміністратор організації створює ключ у розділі API Keys. Повне значення показується лише під час створення. Збережіть його у сховищі секретів або змінній середовища на сервері.

SHVYDKO_BASE_URL — адреса Shvydko без завершального слеша. SHVYDKO_API_KEY — ваш секретний ключ. Не додавайте ключ до браузерного JavaScript, репозиторію чи посилання на приклад.

Адреса API · shell
export SHVYDKO_BASE_URL='https://shvydko.ai'
# Передайте SHVYDKO_API_KEY через менеджер секретів вашого середовища.
Створити API-ключ

03. Збережіть request.json

Один state містить факти для всіх питань. Ідентифікатори team, urgency та alternative ви обираєте самі: за ними відповіді повернуться в answers.

request.json · вигаданий приклад
{
  "state": "Оплата карткою не працює. Оплата при отриманні доступна. Клієнт просить допомогти оформити замовлення.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Якій команді передати звернення?",
      "criteria": {
        "engineering": "Збої сайту та платіжних інтеграцій",
        "logistics": "Доставка й отримання замовлень",
        "other": "Питання поза цими категоріями або недостатньо даних"
      }
    },
    "urgency": {
      "type": "score",
      "instructions": "Оціни терміновість звернення за наведеними рівнями.",
      "criteria": [
        "Інформаційне питання; нічого не заблоковано",
        "Є незручність, але доступний інший спосіб завершити дію",
        "Дію повністю заблоковано; потрібна оперативна допомога"
      ]
    },
    "alternative": {
      "type": "noul",
      "instructions": "Чи вказано в контексті інший доступний спосіб оплати?",
      "criteria": {
        "true": "Доступний інший спосіб оплати",
        "false": "Альтернативу не вказано або вона недоступна"
      }
    }
  }
}

04. Надішліть запит

Перевірте HTTP-статус перед читанням answers. У відповіді знайдіть request_id, usage.input_tokens і usage.cost_usd. Потім звірте запит з історією Usage у кабінеті.

У preview діють обмежені безкоштовні запуски. Опублікований тариф сам по собі не означає, що списання вже ввімкнено: фактичний режим є у service_mode.

Термінал
curl --fail-with-body "$SHVYDKO_BASE_URL/v1/systemone" \
  -H "Authorization: Bearer $SHVYDKO_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @request.json
Переглянути використання

Далі за темою