Quyết định

POST /v1/systemone đánh giá một state dựa trên các câu hỏi được đặt tên và trả về một câu trả lời được định kiểu cho mỗi câu hỏi. Phản hồi là JSON đồng bộ: một xác suất, một tên tùy chọn hoặc một điểm số mà mã của bạn có thể so sánh và phân nhánh. Nó không trả về văn bản được tạo.

Quyết định hay trò chuyệnCopy Anchor Link

Endpoint quyết định không chấp nhận messages, tools, stream hoặc các điều khiển trò chuyện khác, và nó không khả dụng trong Batch. Hãy giữ cấu hình mô hình trò chuyện chính của bạn riêng biệt.

Chọn một mô hìnhCopy Anchor Link

curl "https://api.tokenlab.sh/v1/models?recommended_for=decision" \
  -H "Authorization: Bearer sk-your-api-key"

Bạn cũng có thể lọc bằng category=decision. Đọc GET /v1/models/{model} cho mô hình đã chọn trước khi bạn gửi yêu cầu và gửi ID mô hình một cách rõ ràng. Các ví dụ trên trang này sử dụng jev-1.13.

Cấu trúc yêu cầuCopy Anchor Link

instructions và mỗi tiêu chí cũng chấp nhận một chuỗi, đối tượng JSON hoặc mảng JSON. Yêu cầu sẽ từ chối các trường không xác định.

Đánh giá một ticketCopy Anchor Link

curl https://api.tokenlab.sh/v1/systemone \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-1.13",
    "state": "I was charged twice. Please refund the duplicate payment.",
    "questions": {
      "refund_requested": {"type": "noul", "instructions": "Is a refund requested?"},
      "department": {
        "type": "choice", "instructions": "Which team should handle this?",
        "criteria": {"refunds": "Charges and refunds", "technical": "Software bugs"}
      },
      "urgency": {
        "type": "score", "instructions": "Rate urgency",
        "criteria": ["Routine enquiry", "Money affected", "Safety emergency"]
      }
    }
  }'

Phản hồi giữ lại tên các câu hỏi của bạn trong answers. Các giá trị dưới đây chỉ mang tính minh họa:

{
  "model": "jev-1.13",
  "answers": {
    "refund_requested": {"type": "noul", "noul": 0.97},
    "department": {"type": "choice", "choice": "refunds"},
    "urgency": {"type": "score", "score": 1}
  },
  "usage": {"input_tokens": 96, "output_tokens": 12}
}

Sử dụng các câu trả lờiCopy Anchor Link

• Mỗi câu hỏi nhận được một câu trả lời cùng type, dưới cùng một tên.
• Câu trả lời noul là một xác suất, không phải Boolean. Hãy chọn ngưỡng của riêng bạn cho mỗi hành động.
• Câu trả lời choice luôn là một trong những tên tùy chọn bạn đã gửi.
• Câu trả lời score lập chỉ mục cho mảng criteria của bạn: 1 ở trên có nghĩa là "Money affected".
• Kiểm tra các quyết định dựa trên các trường hợp đã được gắn nhãn của riêng bạn trước khi chúng kích hoạt hoàn tiền, leo thang hoặc các hành động khác.

Sử dụng từ MCPCopy Anchor Link

TokenLab MCP server cung cấp evaluate_decisions trong các profile core và full. Gọi list_models với {"category":"decision"} và get_model trước, sau đó truyền cùng model, state và questions làm đối số công cụ. Đọc structuredContent.answers và structuredContent.usage từ kết quả. Công cụ trả về kết quả đồng bộ và không sử dụng thăm dò tác vụ bất đồng bộ.

Sử dụng từ các SDKCopy Anchor Link

TokenLab JavaScript SDK 0.1.2+ cung cấp evaluateDecisions(body); Python SDK 0.1.2+ cung cấp evaluate_decisions(body). Phần body là cùng một JSON như yêu cầu HTTP. Cả hai đều bảo toàn các câu trả lời được định kiểu và mức sử dụng, và không tự động phát lại yêu cầu thất bại. Xem SDKs.

Chi phí và thử lạiCopy Anchor Link

• Các quyết định được tính phí theo token, từ usage.input_tokens và usage.output_tokens trong phản hồi, theo giá token hiện tại của mô hình.
• Giá có thể thay đổi. Đọc chi tiết giá của mô hình hoặc Pricing API thay vì mã hóa cứng giá.
• Một mô hình có thể báo cáo token đầu ra ngay cả khi giá đầu ra của nó bằng không.
• Các yêu cầu tuân theo tùy chọn phân phối của bạn. Xem Thanh toán và định giá.
• Thời gian chờ (timeout) khiến kết quả không chắc chắn. Kiểm tra yêu cầu trong nhật ký hoặc Console của bạn trước khi gửi lại yêu cầu trả phí.

Các lỗi thường gặpCopy Anchor Link

Tham chiếu APICopy Anchor Link