DEVELOPER TOOLS / 0.1.0

Додайте рішення
у свій код.

Два серверні клієнти, відкритий контракт і готовий skill для вашого coding agent. Один API для Choice, Score та Noul.

01 / PYTHON 3.10+

Python

Синхронний клієнт без сторонніх runtime-залежностей.

python -m pip install https://shvydko.ai/sdk/shvydko_client-0.1.0-py3-none-any.whl

import os
from shvydko_client import Shvydko

client = Shvydko(os.environ["SHVYDKO_API_KEY"])
result = client.decide(
    state="Checkout is broken. Delivery tracking works.",
    questions={"team": {"type": "choice",
        "criteria": {"engineering": "Site defects",
                     "logistics": "Delivery"}}},
)
print(result["answers"]["team"])

02 / NODE.JS 20+

TypeScript / JavaScript

Типи запитів і відповідей, fetch та контрольований тайм-аут.

npm install https://shvydko.ai/sdk/shvydko-client-0.1.0.tgz

import { Shvydko } from "@shvydko/client";

const client = new Shvydko({
  apiKey: process.env.SHVYDKO_API_KEY,
});
const result = await client.decide({
  state: "Checkout is broken. Delivery tracking works.",
  questions: {team: {type: "choice", criteria: {
    engineering: "Site defects", logistics: "Delivery",
  }}},
});
console.log(result.answers.team);

Це preview-реліз клієнтів Codebridge. Пакети розміщені на shvydko.ai; їх не опубліковано в npm або PyPI. Прямі HTTP-приклади залишаються доступними.

Передбачувана поведінка.

Один виклик — один HTTP-запит. Автоматичних повторів після тайм-ауту немає.
Помилка містить HTTP-статус та ID запиту, коли він доступний. Секрет і текст вхідних даних не додаються до повідомлення помилки.
Ключ залишається на сервері. Перенаправлення на іншу адресу не виконуються.
Python: timeout обмежує очікування мережевої активності. TypeScript: timeoutMs обмежує весь запит із читанням відповіді. Типове значення — 120 секунд.
Версія SDK не фіксує модель. Перевірте revision через GET /v1/models і передайте його як model, якщо потрібна конкретна доступна версія.

Статуси й обробка помилок

03 / CODING AGENTS

Дайте агенту
правильний контракт.

Архів містить SKILL.md та довідник API. Розпакуйте папку shvydko-api у каталог skills вашого агента відповідно до його інструкції.

Завантажити agent skill Документація для агентів

Або почніть із цього запиту

Підключи Shvydko до мого серверного застосунку. Прочитай https://shvydko.ai/en/llms.txt і https://shvydko.ai/openapi.json. Перевір актуальні SDK та agent skill на https://shvydko.ai/en/developers. Використай SHVYDKO_API_KEY із серверного середовища; не показуй ключ і не передавай його в браузер. Підготуй state та питання Choice, Score або Noul для мого процесу. Перевір структуру відповіді, request_id, usage і маршрут ручного розгляду. Не повторюй POST автоматично після тайм-ауту. Не виконуй зовнішню бізнес-дію лише на підставі відповіді моделі.