WedStackJev API
System One Infrastructure
ДокументацияВведениеБыстрый старт (Quick start)

Быстрый старт (Quick start)

Prefer to just dive in? Here's everything you need to get started immediately.

Предпочитаете сразу перейти к делу? Здесь собрано всё необходимое для немедленного начала работы.

Попробуйте: Playground

  1. Откройте Playground и войдите в систему.
  2. Вставьте любой текст в качестве состояния (state).
PLAINTEXT TITLE="ПРИМЕР СОСТОЯНИЯ" THEME={NULL} api.wedstack.ru/v1 
Hi, I've been trying to connect my Stripe account for 3 days and the integration keeps failing. I'm losing sales. Please help ASAP.
  1. Добавьте вопрос. Попробуйте вопрос типа Noul: "Does this message express urgency?"
JSON THEME={NULL} api.wedstack.ru/v1 
{
  "urgency": {
    "type": "noul",
    "instructions": "Does this message express urgency?"
  }
}
  1. Добавьте больше вопросов. Комбинируйте Noul, Choice и Score в одном запросе и получайте все результаты одновременно.

Вызовите через API

  1. Получите API-ключ в панели управления
  2. Отправьте POST-запрос на эндпоинт API
  3. Ознакомьтесь со справочником API для получения подробной информации.
HTTP THEME={NULL} api.wedstack.ru/v1 
POST https://api.typesafe.ai/v1/systemone
Authorization: Bearer <API_KEY>
Content-Type: application/json

Пример команды cURL

BASH THEME={NULL} api.wedstack.ru/v1 
curl -X POST https://api.typesafe.ai/v1/systemone \
  -H "Authorization: Bearer $TYPESAFE_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
  {
    "state": "Hi, I've been trying to connect my Stripe account for 3 days and the integration keeps failing. I'm losing sales. Please help ASAP.",
    "model": "jev-latest",
    "questions": {
      "urgency": {
        "type": "noul",
        "instructions": "Does this message express urgency?"
      }
    }
  }
EOF

Тело запроса

JSON THEME={NULL} api.wedstack.ru/v1 
{
  "state": "Hi, I've been trying to connect my Stripe account for 3 days and the integration keeps failing. I'm losing sales. Please help ASAP.",
  "model": "jev-latest",
  "questions": {
    "department": {
      "type": "choice",
      "instructions": "Which team should handle this",
      "criteria": {
        "billing": "Payment or subscription issues",
        "technical": "Bugs or integration problems",
        "sales": "Pricing or account questions"
      }
    },
    "frustration": {
      "type": "score",
      "instructions": "How frustrated the customer appears",
      "criteria": [
        "Calm, just stating facts",
        "Frustrated but civil",
        "Very angry, strong language"
      ]
    },
    "is_urgent": {
      "type": "noul",
      "instructions": "The message conveys urgency or time-sensitivity"
    }
  }
}

Тело ответа

JSON THEME={NULL} api.wedstack.ru/v1 
{
  "model": "jev-1.13.0",
  "answers": {
    "department": {
      "type": "choice",
      "choice": "technical",
      "confidence": 0.78,
      "probabilities": {
        "technical": 0.85,
        "sales": 0.0,
        "billing": 0.15
      }
    },
    "frustration": {
      "type": "score",
      "score": 1.0,
      "confidence": 1.0,
      "legend": {
        "0": "Calm, just stating facts",
        "1": "Frustrated but civil",
        "2": "Very angry, strong language"
      },
      "probabilities": {
        "0": 0.0,
        "1": 1.0,
        "2": 0.0
      }
    },
    "is_urgent": {
      "type": "noul",
      "noul": 1.0
    }
  },
  "usage": {
    "input_tokens": 392,
    "output_tokens": 65
  }
}

Подробные сведения см. в справочнике API.

Используйте в коде: Python SDK

  1. Установите SDK (требуется Python >= 3.10).
BASH TITLE="С ПОМОЩЬЮ PIP" THEME={NULL} api.wedstack.ru/v1 
pip install typesafe-sdk
BASH TITLE="С ПОМОЩЬЮ UV" THEME={NULL} api.wedstack.ru/v1 
uv add typesafe-sdk
  1. Используйте SDK. Клиент считывает TYPESAFE_API_KEY из переменных окружения и по умолчанию вызывает jev-latest.
PYTHON THEME={NULL} api.wedstack.ru/v1 
from typesafe_sdk import Choice, Noul, Score, TypeSafeClient

client = TypeSafeClient()

ticket = "Hi, I've been trying to connect my Stripe account for 3 days and the integration keeps failing. I'm losing sales. Please help ASAP."

response = client.system_one(
    state=ticket,
    questions={
        "department": Choice(
            instructions="Which team should handle this",
            criteria={
                "billing": "Payment or subscription issues",
                "technical": "Bugs or integration problems",
                "sales": "Pricing or account questions",
            },
        ),
        "frustration": Score(
            instructions="How frustrated the customer appears",
            criteria=[
                "Calm, just stating facts",
                "Frustrated but civil",
                "Very angry, strong language",
            ],
        ),
        "is_urgent": Noul(
            instructions="The message conveys urgency or time-sensitivity",
        ),
    },
)

print(response.answers["department"].choice)  # "technical"
print(response.answers["frustration"].score)  # 1.0
print(response.answers["is_urgent"].noul)     # 1.0

Сведения о вариантах установки и подробные примеры см. в разделе клиентские SDK.

Подключите скилл агента

  1. Установите скилл TypeSafe с помощью плагина Claude Code или команды npx skills add typesafe-ai/skills --skill typesafe-ai. Вы также можете прочитать SKILL.md на GitHub.
Выполните следующие две команды в терминале:
PLAINTEXT api.wedstack.ru/v1 
```bash theme={null}
claude plugin marketplace add typesafe-ai/skills
claude plugin install typesafe@typesafe-ai
```
 ```bash theme={null} npx skills add typesafe-ai/skills --skill typesafe-ai ```
PLAINTEXT api.wedstack.ru/v1 
При появлении запроса выберите вашего агента. По умолчанию установка выполняется локально в проект; добавьте флаг `-g` для глобальной установки.
 Вставьте этот промпт в вашего агента разработки:
PLAINTEXT api.wedstack.ru/v1 
```text wrap theme={null}
Install the TypeSafe skill. If you're in Claude Code, run `claude plugin marketplace add typesafe-ai/skills`, then `claude plugin install typesafe@typesafe-ai`. If you're in another agent, run `npx skills add typesafe-ai/skills --skill typesafe-ai` and select your agent. Use one installation method. You can read the skill directly at https://github.com/typesafe-ai/skills/blob/main/skills/typesafe-ai/SKILL.md (raw: https://raw.githubusercontent.com/typesafe-ai/skills/main/skills/typesafe-ai/SKILL.md). Then use the TypeSafe skill when working on this project.
```
  1. Укажите вашему агенту разработки использовать скилл TypeSafe при создании проекта!
PLAINTEXT TITLE="CODING AGENT PROMPT" THEME={NULL} api.wedstack.ru/v1 
Let's build a simple CLI that uses the TypeSafe API to evaluate a set of supplied documents on multiple dimensions. Use the TypeSafe skill to understand how to use the TypeSafe API and how to structure the system. Ask me questions about what kinds of documents I want to evaluate and on what dimensions.

Подробнее см. на странице Скилл агента (Agent Skill).