Разработчикам
API, SDK, паттерны проектирования и работа с уверенностью модели.
API Jev — справочник на русскомСправочник по API Jev от TypeSafe AI: эндпоинт /v1/systemone, авторизация, поля запроса и ответа Noul, Choice и Score, модели, лимиты и коды ошибок.Choice, Score и Noul — три типа вопросов JevТри типа вопросов Jev: Noul (да или нет), Choice (выбор из списка) и Score (шкала). Что возвращает каждый, как выбрать тип и как формулировать вопросы.Jev на Python — установка SDK и примерыКак работать с Jev из Python: установка typesafe-sdk, синхронный и асинхронный клиент, чтение ответов, повторы и ошибки, подключение через OpenRouter и Polza.AI.Jev на JavaScript и TypeScript — SDK и примерыКак подключить Jev в Node.js и TypeScript: установка @typesafe-ai/sdk, хелперы choice, noul и score, типы ответов, повторы и ошибки, Next.js и вызов без SDK.Уверенность (confidence) в Jev — как её читатьЧто показывают probabilities, confidence и noul в ответах Jev, почему это не вероятность правильного ответа и как подобрать пороги для автоматических решений.Паттерн fan-out: много вопросов к Jev за один запросПаттерн speculative fan-out в Jev: все вопросы уходят одним запросом, включая «лишние», а нужные ответы выбирает код. Пример, код, экономика и ограничения.Каскад Jev → LLM: маршрутизация по уверенности, чтобы платить за LLM только в сложных случаяхКак построить каскад Jev → LLM: Jev сама решает простые случаи, а сомнительные по уверенности передаёт LLM или человеку. Три схемы, пороги, экономика и код.Составная оценка (composite scoring) на Jev: рейтинги и скоринг из нескольких критериевКак на Jev собрать рейтинг из нескольких критериев: разбить оценку на атомарные Score, нормализовать шкалы и сложить с весами в коде. Пример отбора резюме.Определение намерений (intent routing) на Jev: чат-боты и поддержкаКак с помощью Jev определять намерение пользователя и передавать запрос нужному обработчику — коду, профильной LLM или оператору. Схема, вопросы, код и пороги.Как проектировать систему на Jev: пошаговый подходКак спроектировать систему на Jev: код управляет процессом, модель принимает узкие решения. Семь шагов от декомпозиции state и вопросов до маршрутизации по уверенности.Продвинутые вопросы в Jev: что умеют примитивы кроме базовогоПродвинутые приёмы вопросов Jev: JSON в instructions и criteria, контрастные описания вариантов, шкалы с примерами, критерии Noul и обход таксономии через Choice.Jev и LangChain: обвязка (harness) для агентовКак подключить Jev к LangChain: пакет langchain-typesafe, TypeSafeClassifier, middleware для выбора модели и проверки вызовов инструментов, своя обвязка агента.Agent skill Jev: как дать ИИ-агенту (Claude Code, Cursor и др.) знания о JevКак установить официальный скилл TypeSafe в Claude Code, Codex, Cursor и другие агенты, чтобы они писали код для Jev по документации, а не придумывали поля API.Ошибки API Jev: 401, 422, 429, 529 — причины и решенияРазбираем ошибки API Jev: неверный ключ 401, валидация 422, лимиты 429 и перегрузка 529. Какие исключения бросают SDK, что повторять и чем отличаются ошибки шлюзов.Асинхронный Python-клиент Jev: пачки запросов, лимиты, повторыКак обработать тысячи документов через Jev на Python: AsyncTypeSafeClient, очередь с воркерами, темп под лимит 1200 запросов в минуту, RetryPolicy и таймауты.