TypeSafe Decisions

Sử dụng Jev để phán định điều kiện, phân loại, chấm điểm và lựa chọn công cụ.

Decisions sử dụng Jev để đánh giá văn bản hoặc trạng thái nghiệp vụ và trả về câu trả lời có thể đọc trực tiếp trong mã. API trả về JSON đồng bộ và không hỗ trợ phản hồi dạng luồng.

POST/v1/decisions

Xác thực

bearerAuth

Xác thựcBearer <token>

Sử dụng API Key do trang web hiện tại cấp.

Vị trí truyền: header

Nội dung yêu cầu

application/json

Định nghĩa kiểu TypeScript

Sử dụng kiểu request body trong TypeScript.

model*string

ID mô hình quyết định có thể gọi trên trang web hiện tại.

state*string||array<unknown>

Nội dung hoặc trạng thái nghiệp vụ cần đánh giá. Tất cả câu hỏi trong một yêu cầu dùng chung state.

questions*

Ánh xạ câu hỏi không rỗng. Mỗi khóa là ID câu hỏi tùy chỉnh; câu trả lời sử dụng cùng ID.

Số thuộc tính1 <= properties

stream?false

Bỏ qua hoặc đặt thành false. API này không hỗ trợ stream: true.

Giá trị được phép

false

Nội dung phản hồi

`application/json`

curl -X POST "https://example.com/v1/decisions" \  -H "Authorization: Bearer your-api-key" \  -H "Content-Type: application/json" \  -d '{    "model": "jev-1.13.0",    "state": "My subscription was charged twice. Please refund the duplicate charge.",    "questions": {      "ticket": {        "type": "noul",        "instructions": "Does the customer explicitly request a refund?",        "criteria": {          "true": "The message explicitly asks for a refund.",          "false": "The message does not ask for a refund."        }      }    }  }'

{
  "model": "jev-1.13.0",
  "answers": {
    "ticket": {
      "type": "noul",
      "noul": 0.99
    }
  },
  "usage": {
    "input_tokens": 319,
    "output_tokens": 20
  }
}

Ví dụ yêu cầu

Các ví dụ dưới đây sử dụng jev-1.13.0. Chọn tình huống câu hỏi và ngôn ngữ lập trình để sao chép yêu cầu tương ứng.

Xác định có yêu cầu hoàn tiền không

curl --request POST 'https://api.agtcloud.cn/v1/decisions' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "jev-1.13.0",
  "state": "My subscription was charged twice. Please refund the duplicate charge.",
  "questions": {
    "ticket": {
      "type": "noul",
      "instructions": "Does the customer explicitly request a refund?",
      "criteria": {
        "true": "The message explicitly asks for a refund.",
        "false": "The message does not ask for a refund."
      }
    }
  }
}'

Loại câu hỏi

Loại	Mục đích	Trường trả về
`noul`	Xác định điều kiện có đúng không, chẳng hạn khách hàng có yêu cầu hoàn tiền không	`noul`: xác suất điều kiện đúng
`choice`	Chọn phân loại hoặc hành động từ các lựa chọn, chẳng hạn bộ phận xử lý yêu cầu hỗ trợ	`choice`, `probabilities`, `confidence`
`score`	Chấm điểm theo tiêu chí có thứ tự, chẳng hạn mức độ khẩn cấp của yêu cầu hỗ trợ	`score`, `legend`, `probabilities`, `confidence`

Cung cấp nội dung cần đánh giá trong state, câu hỏi và tiêu chí trong questions. Một yêu cầu có thể chứa nhiều câu hỏi và kết hợp cả ba loại; mọi câu hỏi dùng chung một state.

Đọc kết quả

answers sử dụng cùng ID câu hỏi với questions. Ví dụ, nếu ID câu hỏi là ticket, đọc câu trả lời từ answers.ticket.

Phán định: Đọc noul. Giá trị nằm trong khoảng 0–1; gần 1 thể hiện xu hướng đúng, gần 0 thể hiện xu hướng sai. Đặt ngưỡng phán định theo nhu cầu nghiệp vụ.
Phân loại: Đọc choice để lấy tên lựa chọn và dùng probabilities để xem xác suất của từng lựa chọn.
Chấm điểm: Đọc score. Các mức được đánh số từ 0 theo vị trí trong mảng criteria; ba mức tương ứng với 0–2 và điểm có thể là số thập phân. legend ánh xạ số mức với mô tả.

Đối với choice và score, confidence thể hiện mức độ chắc chắn của phân bố xác suất, không phải độ chính xác của câu trả lời. Xác suất, điểm và mức sử dụng Token thay đổi theo yêu cầu.

Lựa chọn công cụ sử dụng choice để trả về tên hành động, chẳng hạn lookup_payment. Ứng dụng thực hiện thao tác tiếp theo dựa trên tên đó; yêu cầu quyết định này không thực thi công cụ và không tạo OpenAI tool_calls.

Mức sử dụng Token và chi phí

usage.input_tokens và usage.output_tokens lần lượt ghi nhận mức sử dụng Token đầu vào và đầu ra. Jev chỉ tính phí Token đầu vào, không tính phí Token đầu ra; nhiều câu hỏi và mô tả lựa chọn cũng ảnh hưởng đến mức sử dụng đầu vào. Xem giá hiện tại tại Danh mục mô hình.

200application/json

400application/json

422application/json

`application/json`

`application/json`

`application/json`