پرسش‌ها (پریمیتیوها) › مستندات Jev

Noul noul

یک پرسش بله/خیر که احتمال «بله» بودن پاسخ را برمی‌گرداند.

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

وقتی پاسخ بله یا خیر است از Noul استفاده کنید: آیا پیام درخواست بازپرداخت دارد، آیا رزومه به سیستم‌های توزیع‌شده اشاره می‌کند، آیا نظر حاوی داده‌ی شخصی است. پاسخ Noul یک عدد است: احتمال «بله» بودن، که ۰ یعنی خیر و ۱ یعنی بله.

ساختار درخواست

type"noul"الزامی

همیشه "noul".

instructionsstring | object | arrayالزامی

پرسش بله/خیر یا گزاره‌ای برای قضاوت.

criteria{ true?, false? }اختیاری

شیئی با توصیف‌های true و false از معنای بله و خیر.

from typesafe_sdk import Noul, NoulCriteria, TypeSafeClient

with TypeSafeClient() as client:
    response = client.system_one(
        model="jev-latest",
        state="I have asked three times now. Can I please just talk to a real person?",
        questions={
            "is_human_escalation": Noul(
                instructions="Is the customer asking for a human agent?",
            ),
            "is_repeat_contact": Noul(
                instructions="Has the customer contacted support about this before?",
                criteria=NoulCriteria(
                    true="Mentions a prior attempt, ticket, or that they have asked before",
                    false="No sign of any previous contact",
                ),
            ),
        },
    )
    print(response.answers["is_human_escalation"].noul)
    print(response.answers["is_repeat_contact"].noul)

import { noul, TypeSafeClient } from "@typesafe-ai/sdk";

const client = new TypeSafeClient();
const response = await client.systemOne({
  state: "I have asked three times now. Can I please just talk to a real person?",
  questions: {
    is_human_escalation: noul("Is the customer asking for a human agent?"),
    is_repeat_contact: noul("Has the customer contacted support about this before?", {
      true: "Mentions a prior attempt, ticket, or that they have asked before",
      false: "No sign of any previous contact",
    }),
  },
});
console.log(response.answers.is_human_escalation.noul);

{
  "model": "jev-1.13.0",
  "answers": {
    "is_human_escalation": {
      "type": "noul",
      "noul": 0.99
    },
    "is_repeat_contact": {
      "type": "noul",
      "noul": 0.93
    }
  },
  "usage": {
    "input_tokens": 360,
    "output_tokens": 39
  }
}

خواندن یک Noul

عدد هم پاسخ است و هم میزان قطعیت. نزدیک ۱ بله‌ی قوی، نزدیک ۰ خیر قوی و نزدیک ۰٫۵ یعنی مدل احتمال مشابهی به بله و خیر می‌دهد. Noul فیلد confidence جداگانه ندارد، چون توزیعش فقط دو حالت دارد و همین یک عدد آن را کامل توصیف می‌کند. در ابزار زیر پاسخ‌های واقعی ثبت‌شده‌ی jev-1.13.0 را با آستانه‌های مختلف مسیریابی کنید:

جای آستانه به هزینه‌ی اشتباه بستگی دارد. وقتی عمل‌کردن به بله و خیر به یک اندازه آسان است ۰٫۵ را بگذارید. وقتی عمل به بله‌ی کاذب گران است (خبرکردن کسی یا پرداخت بازپرداخت) آن را بالا ببرید. وقتی از دست دادن یک بله‌ی واقعی گران است (نادیده گرفتن یک مشکل ایمنی) پایینش بیاورید. مقادیر میانی می‌توانند به یک انسان سپرده شوند.

مقدار Noul مقیاسی از خودِ موضوع پرسش نیست؛ احتمال «بله» است. «آیا نامزد در پایتون قوی است؟» برای کسی که روزانه دو سال پایتون نوشته ۰٫۸۱ و برای کسی که هشت سال نوشته ۰٫۹۲ می‌گیرد؛ در حالی که Score چهارسطحی برای همین دو نفر ۲٫۰۵ و ۲٫۸۹ می‌دهد. اگر پرسش درباره‌ی «درجه» است، از Score استفاده کنید.

نوشتن یک پرسش Noul

در هر Noul فقط یک پرسش بله/خیر. «آیا مشتری عصبانی است و بازپرداخت می‌خواهد؟» را به دو Noul بشکنید و در کد ترکیب کنید.
پرسش را طوری بنویسید که مقدار بالا یعنی بله. «آیا پیام حاوی داده‌ی شخصی است؟» روشن است؛ «آیا پیام عاری از داده‌ی شخصی است؟» معنا را وارونه می‌کند.
گزاره هم به‌خوبی پرسش کار می‌کند: برای «The customer is requesting a refund»، مقدار نزدیک ۱ یعنی گزاره درست است.
مرز بله و خیر را بی‌ابهام کنید. «آیا نامزد هیچ تجربه‌ی پایتونی دارد؟» خوب کار می‌کند. وقتی مرز ظریف است، criteria با توصیف true و false اضافه کنید.

مدیریت چند پاسخ Noul در کد

YES = 0.8
NO = 0.2

def route(message: str) -> None:
    with TypeSafeClient() as client:
        response = client.system_one(
            model="jev-latest",
            state=message,
            questions=SUPPORT_QUESTIONS,
        )

    answers = response.answers
    wants_human = answers["is_human_escalation"].noul
    repeat = answers["is_repeat_contact"].noul

    if NO < wants_human < YES or NO < repeat < YES:
        # مدل در هیچ جهتی مطمئن نیست. یک انسان تصمیم بگیرد.
        send_to_review(message)
        return

    priority = "high" if repeat > YES else "normal"
    if wants_human > YES:
        route_to_agent(message, priority=priority)
    else:
        route_to_bot(message, priority=priority)

آستانه‌ها در کد شما زندگی می‌کنند. اگر بازبین‌ها پیام‌های زیادی می‌بینند فاصله‌ی NO تا YES را کم کنید؛ اگر مسیریابی‌های اشتباه زیادی عبور می‌کند آن را زیاد کنید.

دستورالعمل ساختاریافته

دستورالعمل می‌تواند به‌جای رشته یک شیء باشد: پرسش در یک فیلد و داده‌ی تکمیلی در بقیه. مثلاً مقایسه‌ی رزومه‌ای که تازه رسیده با رکوردهای پایگاه داده، یک Noul برای هر رکورد، همه در یک فراخوانی:

from typesafe_sdk import Noul, TypeSafeClient

SAME_PERSON = "Is the resume for the same person as `potential_duplicate`?"


def duplicate_questions(candidates: list[dict]) -> dict[str, Noul]:
    """یک Noul برای هر رکورد نامزد؛ همه همان پرسش را می‌پرسند."""
    return {
        f"same_as_record_{candidate['id']}": Noul(
            instructions={
                "potential_duplicate": {
                    "name": candidate["name"],
                    "location": candidate["location"],
                    "last_employer": candidate["last_employer"],
                },
                "question": SAME_PERSON,
            },
        )
        for candidate in candidates
    }


def find_duplicates(resume: dict, candidates: list[dict]) -> list[str]:
    with TypeSafeClient() as client:
        response = client.system_one(
            model="jev-latest",
            state={"resume": resume},
            questions=duplicate_questions(candidates),
        )
    return [qid for qid, answer in response.answers.items() if answer.noul > 0.7]