Nace.AI: Drex v1.5
Drex 1.5 đánh giá văn bản hoặc JSON được cung cấp theo các câu hỏi có kiểu và trả về xác suất, một nhãn được chọn hoặc điểm thang tiêu chí dạng phân số. Nace.AI ghi tài liệu về các quyết định chỉ dùng văn bản cho phân loại, định tuyến và xếp mức ưu tiên, với giới hạn trạng thái và yêu cầu riêng cho từng phiên bản.
Về mô hình
Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn.
Drex 1.5 là mô hình quyết định văn bản của Nace.AI. Mô hình đánh giá các dữ kiện được cung cấp theo những câu hỏi đóng và trả về đáp án dạng số có kiểu thay vì một câu trả lời viết mở. Một yêu cầu kết hợp một trạng thái với các câu hỏi có tên, và kết quả nhận diện từng đáp án bằng đúng tên câu hỏi đó. Nhờ vậy, quy trình nhận được một danh mục, xác suất hoặc vị trí cụ thể trên thang tiêu chí để sử dụng, còn hành động dựa trên kết quả đó do ứng dụng quyết định.
Chuẩn bị trạng thái
Trạng thái là thông tin mà mọi câu hỏi đều đề cập đến. Drex chấp nhận chuỗi, đối tượng, mảng, số, boolean hoặc null theo JSON, và trường state là bắt buộc. Hãy cung cấp bằng chứng có ý nghĩa dù null vẫn qua được bước kiểm tra hợp lệ của nhà sản xuất. Chuỗi phù hợp với tin nhắn, tài liệu hoặc bản chép lời; đối tượng phù hợp với dữ kiện đã được sắp xếp thành các trường. Hãy giữ thông tin ảnh hưởng đến quyết định và bỏ các trường không liên quan khi nội dung dài. Giữ định dạng đầu vào ổn định khi diễn giải ngưỡng xác suất, vì thay đổi cách biểu diễn có thể làm thay đổi đáp án.
Drex 1.5 chỉ đọc văn bản. Giao diện theo tài liệu từ chối nội dung hình ảnh, âm thanh, video và PDF trong trạng thái hoặc câu hỏi, bao gồm cả phương tiện đã mã hóa và đối tượng nội dung đa phương tiện. Hãy chuẩn bị chú thích, văn bản tài liệu đã nhận dạng hoặc bản chép lời trước khi dùng nội dung đó làm bằng chứng. Một địa chỉ dạng văn bản không phải là tài liệu hay hình ảnh đã được tải về: mô hình không thể mở nó. Với một yêu cầu hỗ trợ, trạng thái hữu ích là tin nhắn thực tế và ngữ cảnh liên quan, không phải tham chiếu đến nội dung mà mô hình chưa nhận được.
Xác suất có/không, lựa chọn hoặc điểm
Câu hỏi noul hỏi liệu một điều kiện có đúng hay không và trả về một số từ 0 đến 1 biểu thị xác suất ước tính của đáp án có. Hãy định nghĩa câu hỏi bằng chỉ dẫn không rỗng hoặc ít nhất một tiêu chí true/false không rỗng. Ví dụ, hãy hỏi liệu một tin nhắn có báo cáo tính năng bị hỏng hay không và xác định xem hoạt động chậm có được tính là hỏng không. Drex không áp đặt ngưỡng có/không sẵn có; quy trình sử dụng kết quả tự chọn cách diễn giải xác suất.
Câu hỏi choice chọn một nhãn được cung cấp từ một tập không có thứ tự và trả về xác suất cho mọi nhãn. Tiêu chí là một đối tượng có các khóa là nhãn được trả về, với mỗi phần mô tả là chuỗi hoặc null. Hãy dùng khóa ngắn, ổn định và mô tả rõ ranh giới giữa các danh mục. Một tác vụ định tuyến minh họa có thể phân biệt vấn đề truy cập, lỗi sản phẩm và câu hỏi chung, kèm danh mục other cho các tin nhắn không phù hợp. Nhãn được chọn hữu ích cho định tuyến; phân phối giúp nhận ra những trường hợp mà hai phương án vẫn khó tách biệt.
Câu hỏi score dùng một mảng nhãn cấp độ có thứ tự. Chỉ số bắt đầu từ 0, và điểm trả về là tổng của từng chỉ số cấp độ nhân với xác suất của nó. Vì vậy, điểm có thể rơi vào giữa các cấp độ có tên. Với thang mức độ nghiêm trọng, hãy định nghĩa điều gì phân biệt lỗi chỉ ảnh hưởng giao diện, lỗi có cách khắc phục tạm thời và tác vụ bị chặn hoàn toàn. Kết quả bao gồm chú giải cấp độ và các xác suất cùng với điểm kỳ vọng. Hãy giữ điểm phân số để tính trung bình hoặc theo dõi xu hướng; chọn cấp độ có xác suất cao nhất và làm tròn điểm kỳ vọng là trả lời những câu hỏi khác nhau.
Bằng chứng dùng chung và cách đọc kết quả
Nhà sản xuất cho phép từ một đến 512 câu hỏi về cùng một trạng thái. Hãy đặt cho mỗi câu hỏi một mã định danh không rỗng, có ý nghĩa, chẳng hạn category hoặc severity, để có thể hiểu đáp án tương ứng mà không cần tra cứu một câu hỏi được đánh số. Hãy tách các mối quan tâm độc lập thành câu hỏi riêng thay vì gộp nhiều yêu cầu vào một tiêu chí không rõ ràng. Một tin nhắn có thể phục vụ việc chọn danh mục, chấm điểm mức độ nghiêm trọng và kiểm tra điều kiện, mỗi câu hỏi giữ ý nghĩa riêng.
Đáp án choice và score bao gồm độ tin cậy tách biệt với phân phối xác suất. Nhà sản xuất phân biệt rõ độ tin cậy với xác suất cao nhất của các phương án; đừng tính giá trị này từ giá trị kia. Với quyết định có/không, hãy giữ xác suất thô cùng kết quả được chọn. Với lựa chọn chưa chắc chắn, hãy xem xét các xác suất cạnh tranh thay vì coi riêng nhãn thắng là bằng chứng của sự chắc chắn. Hãy định nghĩa ngưỡng rà soát dựa trên hậu quả của kết quả dương tính sai hoặc âm tính sai và dùng các trường hợp có nhãn mang tính đại diện để đánh giá chúng.
Phiên bản và giới hạn kích thước
Drex 1.5 ghi tài liệu hạn mức trạng thái 131,072 token và hạn mức hàng 139,264 token. Hạn mức hàng áp dụng cho trạng thái cộng với câu hỏi đơn dài nhất, bao gồm chỉ dẫn và các phương án của câu hỏi đó; đây không phải tổng của mọi câu hỏi trong yêu cầu. Trạng thái và các câu hỏi sau khi tuần tự hóa cũng phải nằm gọn trong 1,048,576 byte UTF-8. Một yêu cầu có thể thỏa mãn giới hạn byte nhưng vẫn vượt giới hạn token. Phiên bản 1.0 cũ hơn liệt kê riêng 32,768 token cho cả trạng thái lẫn hàng, vì vậy không nên áp dụng các giới hạn đó cho 1.5.
Nace ghi tài liệu drex-v1.5 là mã định danh có phiên bản của nhà sản xuất, còn drex-latest là bí danh thay đổi theo thời gian. Hãy nêu rõ phiên bản dự định khi quy trình phụ thuộc vào giới hạn của nó. Câu hỏi sai định dạng, thiếu trạng thái hoặc đầu vào quá cỡ là vấn đề kiểm tra hợp lệ cần sửa đầu vào, không phải lý do để đổi danh mục hay đoán đáp án. Hãy chuẩn bị tiêu chí xoay quanh bằng chứng quan sát được và giữ kết quả có kiểu, dữ kiện gốc cùng định nghĩa câu hỏi đi cùng nhau. Nhờ đó, quyết định có thể dùng cho định tuyến, xếp mức ưu tiên hoặc rà soát mà không nhầm một xác suất với một phán quyết được bảo đảm.
Ailoot Ultra · System One POST /v1/systemone nace-ai/drex-v1.5
nace-ai/drex-v1.5Bắt đầu
Drex 1.5 đánh giá văn bản hoặc JSON được cung cấp theo các câu hỏi có kiểu và trả về xác suất, một nhãn được chọn hoặc điểm thang tiêu chí dạng phân số. Nace.AI ghi tài liệu về các quyết định chỉ dùng văn bản cho phân loại, định tuyến và xếp mức ưu tiên, với giới hạn trạng thái và yêu cầu riêng cho từng phiên bản.
- Đầu vào được chấp nhận
- Văn bản
- Kết quả
- decisions
Có trên Ailoot · đầu vào & phương thức
Ailoot Ultra · System One POST /v1/systemone
- Đầu vào
text- Đầu ra
decisions- Định dạng đầu ra
- json
| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
|---|---|---|---|---|
Trườngmodel | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn nace-ai/drex-v1.5 | Mặc định— |
Trườngprovider | Loạischema | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngquestions | Loạiobject | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngsession_id | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngstate | Loạischema | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngtrace | Loạischema | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Trườnguser | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngquestions.<id>.type | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn noul, choice, score | Mặc định— |
Trườngquestions.<id>.instructions | Loạistring|object|array | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngquestions.<id>.criteria | Loạiobject|array | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: choice/score: bắt buộc; noul: tùy chọn. Tiêu chí của choice là đối tượng; score là mảng có minItems1. | Mặc định— |
Trườngquestions.<id>.criteria.true | Loạistring|object|array | Yêu cầuBắt buộc | Giá trị & giới hạn Áp dụng khi: Đã cung cấp đối tượng tiêu chí noul | Mặc định— |
Trườngquestions.<id>.criteria.false | Loạistring|object|array | Yêu cầuBắt buộc | Giá trị & giới hạn Áp dụng khi: Đã cung cấp đối tượng tiêu chí noul | Mặc định— |
Tổ hợp tư liệu đầu vào
noul · Bắt buộc: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Bắt buộc: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Bắt buộc: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Tham số phương thức và vòng đời
| Tham số | Hợp đồng |
|---|---|
Tham sốcontent_type | Hợp đồngapplication/json |
Tham sốrequired | Hợp đồngmodel, state, questions |
Tham sốmaterial_types | Hợp đồngtext |
Tham sốoptional_controls | Hợp đồngprovider, session_id, trace, user |
Tham sốmultimodal_input_binding | Hợp đồngnull |
Vòng đời: synchronous
Gửi ID mô hình chính xác và giữ lại toàn bộ phản hồi gốc.
Bảng giá
Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn.
- Chế độ nhanh
- Chưa chỉ định Khi chọn chế độ nhanh
- Chế độ Flex
- Chưa chỉ định Khi chọn chế độ flex
- Mức độ suy luận tối đa
- Chưa chỉ định Khi áp dụng mức điều chỉnh mặc định (default) cho mức độ suy luận tối đa
Mức phí Ailoot
Giá theo cấu hình
Đối chiếu từng khoản phí với điều kiện hiển thị. Dùng một mức phí cho mỗi nhóm cấu hình thay thế.
| Cấu hình | Biểu mức phí | Token ngữ cảnh, lớn hơn | Token ngữ cảnh, tối đa và bao gồm | Phí |
|---|---|---|---|---|
| Cấu hìnhGiá cơ sở cho token | Biểu mức phíMức phí cơ bản | Token ngữ cảnh, lớn hơn— | Token ngữ cảnh, tối đa và bao gồmKhông có giới hạn trên | Phí Đầu vào · Token đầu vào $0.00008 / 1K token Đầu ra · Token đầu ra $0 / 1K token Đầu vào · Đọc bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ — / 1K token |
| Cấu hìnhBậc 1 theo độ dài yêu cầu | Biểu mức phí— | Token ngữ cảnh, lớn hơn0 | Token ngữ cảnh, tối đa và bao gồmKhông có giới hạn trên | Phí Đầu vào · Token đầu vào $0.00008 / 1K token Đầu ra · Token đầu ra $0 / 1K token Đầu vào · Đọc bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ — / 1K token |
Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. Cách hoạt động của cơ chế tạm giữ và quyết toán →
Ví dụ yêu cầu
Ailoot Ultra · System One
{
"model": "nace-ai/drex-v1.5",
"questions": {
"is_bug": {
"criteria": {
"false": "The customer is asking a question or requesting a feature.",
"true": "The customer describes broken or unexpected product behavior."
},
"instructions": "Is the customer reporting a software defect?",
"type": "noul"
},
"team": {
"criteria": {
"account": "Login, permissions, or profile issues.",
"frontend": "Rendering, layout, or browser compatibility issues.",
"payments": "Checkout, billing, or payment processing issues."
},
"instructions": "Which team should own this ticket?",
"type": "choice"
},
"urgency": {
"criteria": [
"Can wait for the next release",
"Should be fixed this week",
"Blocking revenue right now"
],
"instructions": "How urgent is this ticket?",
"type": "score"
}
},
"state": {
"customer_tier": "enterprise",
"ticket": "My checkout page shows a blank screen after I click Pay. I have tried two browsers."
}
}set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='nace-ai/drex-v1.5'
Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/systemone \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT
Nhận và lưu kết quả
Ailoot Ultra · System One
json
Lưu tất cả kết quả đã hoàn tất
Lưu mọi phản hồi hoàn chỉnh, tệp và phần nội dung được trả về.
Giữ lại mọi câu trả lời được cung cấp theo ID câu hỏi với đúng kiểu dữ liệu, giá trị noul/choice/score, độ tin cậy, xác suất và chú giải. Toàn bộ JSON gốc chỉ được lưu và trả về sau khi quyết toán.
Nếu cần kiểm tra phản hồi gốc
Giữ nguyên thao tác ban đầu và phản hồi đầy đủ/một phần; không gửi lại POST.
Trường phản hồi
| Trường | Loại |
|---|---|
Trườngmodel | Loạistring |
Trườngid | Loạistring |
Trườngprovider | Loạistring |
Trườnganswers.<id>.type | Loạistring |
Trườnganswers.<id>.noul | Loạinumber |
Trườnganswers.<id>.choice | Loạistring |
Trườnganswers.<id>.score | Loạinumber |
Trườnganswers.<id>.confidence | Loạinumber |
Trườnganswers.<id>.probabilities | Loạiobject |
Trườnganswers.<id>.legend | Loạiobject |
Trườngusage.input_tokens | Loạiinteger |
Trườngusage.output_tokens | Loạiinteger |
Trườngusage.cost | Loạinumber |
Lỗi và bước tiếp theo
| Phản hồi | Điều kiện | Bước tiếp theo |
|---|---|---|
Phản hồi400 · invalid_request_error | Điều kiệnTrường bắt buộc, biểu diễn hoặc giá trị không hợp lệ | Bước tiếp theoSửa trường yêu cầu được chỉ ra. |
Bí danh
Bí danh mô hình
Ailoot Ultra nace-ai/drex-v1.5
Bí danh đường dẫn phương thức
Dùng các đường dẫn phương thức hiển thị ở trên.
ID gọi liên quan
FAQ · Nace.AI: Drex v1.5
- Có những đầu vào và kết quả nào?
POST /v1/systemone·nace-ai/drex-v1.5:text→decisions- Yêu cầu sử dụng những trường nào?
POST /v1/systemone·nace-ai/drex-v1.5:model,provider,questions,session_id,state,trace,user