شروع › مستندات Jev

شروع سریع

ترجیح می‌دهید مستقیم شروع کنید؟ هر آنچه برای شروع فوری لازم دارید این‌جاست.

آخرین به‌روزرسانی: مدل: jev-1.13.0 منبع بازبینی‌شده در منبع انگلیسی

امتحانش کنید: Playground

Playground را باز کنید و وارد شوید.
هر متنی را به‌عنوان 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.

یک پرسش اضافه کنید. یک پرسش Noul را امتحان کنید: "Does this message express urgency?"

{
  "urgency": {
    "type": "noul",
    "instructions": "Does this message express urgency?"
  }
}

پرسش‌های بیشتری اضافه کنید. Noul، Choice و Score را در یک فراخوانی ترکیب کنید و همه‌ی نتایج را یک‌جا ببینید.

فراخوانی کنید: API

کلید API خود را از داشبورد بگیرید.
یک درخواست POST به endpoint بفرستید.
برای همه‌ی جزئیات، مرجع API را ببینید.

POST https://api.typesafe.ai/v1/systemone
Authorization: Bearer <API_KEY>
Content-Type: application/json

نمونه‌ی دستور cURL

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

بدنه‌ی درخواست و پاسخ

{
  "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"
    }
  }
}

{
  "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
  }
}

کد بنویسید: SDK پایتون

SDK را نصب کنید (نیازمند Python نسخه‌ی ۳٫۱۰ یا بالاتر):

pip install typesafe-sdk

uv add typesafe-sdk

از SDK استفاده کنید. کلاینت TYPESAFE_API_KEY را از محیط می‌خواند و به‌طور پیش‌فرض jev-latest را فراخوانی می‌کند.

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ها را ببینید.

با ایجنت بسازید: Agent skill

اسکیل TypeSafe را نصب کنید تا ایجنت کدنویسی شما با API، پریمیتیوها و الگوها آشنا شود:

claude plugin marketplace add typesafe-ai/skills
claude plugin install typesafe@typesafe-ai

npx skills add typesafe-ai/skills --skill typesafe-ai

در ایجنت‌های دیگر، هنگام نصب ایجنت خود را انتخاب کنید. نصب به‌صورت پیش‌فرض محلیِ پروژه است؛ برای نصب سراسری -g اضافه کنید. سپس به ایجنت کدنویسی خود بگویید هنگام ساختن از اسکیل TypeSafe استفاده کند. جزئیات بیشتر در بخش Agent skill.