LiquidAI: d1
Quy trình quyết định văn bản của Liquid AI d1 đánh giá bằng chứng được cung cấp theo các kết quả cố định và trả về xác suất, một lựa chọn danh mục hoặc điểm thang tiêu chí. Mô hình hỗ trợ phân loại, định tuyến, lọc theo mức liên quan và xếp mức ưu tiên mà không sinh câu trả lời bằng vă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.
d1 là mô hình quyết định được lưu trữ trên máy chủ của Liquid AI dành cho các tác vụ phân loại, định tuyến và chấm điểm có giới hạn. Hồ sơ này bao quát quy trình quyết định văn bản của mô hình: cung cấp bằng chứng dưới dạng trạng thái, định nghĩa một hoặc nhiều câu hỏi và nhận đáp án dạng số có kiểu trên các kết quả đã biết. Liquid mô tả các quyết định này là những phép đánh giá trả về xác suất trực tiếp, không sinh ra token đầu ra nào. Kết quả hữu ích là một quyết định đã định nghĩa cùng độ bất định của nó, không phải một đoạn văn bản mới được soạn.
Chuẩn bị bằng chứng và câu hỏi cùng nhau
Hãy cung cấp văn bản giúp đưa ra quyết định, bao gồm ngữ cảnh cần thiết để diễn giải nó. Giữ trạng thái tách biệt với chỉ dẫn mô tả điều cần đánh giá. Một tin nhắn hỗ trợ có thể cần mô tả sản phẩm hoặc sự cố; một đoạn tài liệu có thể cần câu hỏi tìm kiếm của người dùng. Hãy định nghĩa tập đáp án trước khi đặt câu hỏi, và gán cho mọi phương án một ý nghĩa phù hợp với quy trình dự kiến. Nhãn ngắn có thể đóng vai trò khóa đầu ra ổn định, còn phần mô tả giải thích ranh giới giữa chúng.
Hãy dùng các câu hỏi có tên trên một trạng thái dùng chung. Một tên rõ ràng như intent, urgency hoặc relevant giữ cho đầu ra gắn với quyết định mà nó đại diện. Ví dụ, một tin nhắn báo rằng một trang bị lỗi có thể phục vụ việc chọn ý định, thang tiêu chí mức khẩn cấp và kiểm tra có/không về lỗi được báo cáo. Mỗi câu hỏi nên giữ tiêu chí riêng thay vì gộp cả ba nhận định vào một nhãn mơ hồ.
Choice cho danh mục và định tuyến
Câu hỏi choice chọn một nhãn từ một tập không có thứ tự và trả về phân phối trên các phương án có tên. Hãy định nghĩa các phương án thông qua mô tả tiêu chí; kết quả bao gồm lựa chọn được chọn, các xác suất và độ tin cậy. Với việc sắp xếp tài liệu, hãy định nghĩa các thư mục hoặc chủ đề khả dĩ và nói rõ nội dung nào thuộc về từng mục. Với định tuyến yêu cầu, hãy mô tả các điểm đến thực sự tồn tại. Ứng dụng có thể dùng nhãn trả về để chọn bước tiếp theo, đồng thời giữ các xác suất cạnh tranh để rà soát.
Một tác vụ lưu trữ tài liệu minh họa có thể tách câu hỏi về sản phẩm, sự cố tích hợp và vấn đề truy cập, kèm phương án other cho nội dung nằm ngoài các định nghĩa đó. Hãy giữ ranh giới cụ thể: một tin nhắn không thể xác thực khác với một tin nhắn hỏi cách cấu hình tính năng. Nhãn trả về chọn giữa các ý nghĩa đã cung cấp; nó không tạo ra điểm đến còn thiếu và không thực thi thay đổi trong hệ thống khác.
Noul cho kiểm tra điều kiện và mức liên quan
Câu hỏi noul trả về xác suất từ 0 đến 1 rằng điều kiện có/không đã định nghĩa là đúng. Liquid minh họa các kiểm tra nhị phân cho kiểm duyệt nội dung và mức liên quan của đoạn văn. Hãy nêu điều kiện chính xác và chọn cách sử dụng xác suất kết quả: gắn cờ trường hợp có khả năng khớp, lọc một đoạn văn hoặc chuyển trường hợp chưa chắc chắn sang rà soát. Ngưỡng thuộc về tác vụ sử dụng kết quả, và không nên coi xác suất là một phán quyết về sự thật được bảo đảm.
Với lọc theo mức liên quan, hãy cung cấp cả truy vấn và đoạn văn ứng viên. Hỏi liệu đoạn văn đó có giúp trả lời truy vấn hay không, rồi giữ đoạn văn gốc cùng xác suất của nó. Cách này có thể hỗ trợ chọn tài liệu nguồn cho một câu trả lời sau đó mà không cần d1 tự soạn câu trả lời. Nếu mức liên quan cần nhiều cấp độ thay vì một điều kiện có/không, hãy định nghĩa một thang tiêu chí có thứ tự và dùng câu hỏi score.
Score cho các cấp độ có thứ tự
Câu hỏi score đặt trạng thái lên một thang tiêu chí gồm các cấp độ có thứ tự và có mô tả. Chỉ số cấp độ bắt đầu từ 0, và điểm là vị trí có trọng số xác suất của chúng, có thể nằm giữa các cấp độ. Kết quả cũng bao gồm phân phối cấp độ và độ tin cậy. Với mức khẩn cấp, hãy định nghĩa điều gì phân biệt sự cố không có tác động tức thời, bất tiện đáng kể và tác vụ bị chặn. Vì vậy, một thang tiêu chí bốn cấp có chỉ số từ 0 đến 3; điểm kỳ vọng của nó không tự động là một danh mục được đánh số từ 1 đến 4.
Hãy dùng điểm phân số để sắp xếp hoặc tổng hợp khi đó là kết quả mong muốn, và giữ toàn bộ phân phối khi sự mơ hồ có ý nghĩa. Các danh mục như phòng ban không có thứ tự tự nhiên và thuộc về câu hỏi choice. Độ tin cậy tóm tắt mức độ rõ ràng của đáp án được báo cáo trong giao diện theo tài liệu; nó cần được giữ tách biệt với điểm mong muốn của tác vụ và với giả định rằng quyết định chắc chắn đúng.
Nhiều câu hỏi và các ứng dụng của nhà sản xuất
Nhiều câu hỏi có thể đánh giá cùng một trạng thái trong một lần gọi tới nhà sản xuất, mỗi câu hỏi giữ kiểu và xác suất riêng. Các ví dụ văn bản của Liquid bao gồm lọc phiếu hỗ trợ, xếp tài liệu vào hệ phân loại thư mục, chọn đường dẫn tìm kiếm mã, chọn trong số các hành động khả dụng của tác tử và quyết định giữ lại phần nào của đầu ra công cụ. Tất cả các quy trình này đều có một quyết định tiếp theo có giới hạn. Một bước tìm kiếm mã có thể chọn thư mục triển vọng dựa trên mô tả; một bước chọn nội dung có thể chọn keep (giữ), trim (cắt bớt) hoặc drop (loại bỏ) cho tài liệu được cung cấp. Ứng dụng bao quanh vẫn lấy dữ liệu nguồn và thực hiện thao tác đã chọn.
Phạm vi và sản phẩm quyết định hữu ích
Các thành phần cơ bản theo tài liệu phù hợp với kết quả đã biết, đánh giá theo thang tiêu chí và kiểm tra điều kiện. Văn bản mới, bản tóm tắt, mã và hội thoại mở cần một quy trình sinh, chứ không được hàm ý trong kết quả quyết định của d1. Hãy chuẩn bị câu hỏi xoay quanh bằng chứng quan sát được và giữ định nghĩa của câu hỏi cùng đầu ra để có thể diễn giải nhãn hoặc điểm về sau.
Hãy giữ mỗi trạng thái tập trung vào bằng chứng trả lời các câu hỏi đã định nghĩa, và tách các tác vụ quyết định không liên quan để tiêu chí của chúng luôn rõ ràng. Giữ tài liệu nguồn phù hợp, định nghĩa ý nghĩa dự phòng khi các danh mục chưa bao quát hết, và đánh giá ngưỡng xác suất bằng các ví dụ có nhãn từ tác vụ. Một sản phẩm hữu ích ghi lại danh mục được chọn hoặc điểm kỳ vọng cùng phân phối, danh tính câu hỏi và bằng chứng gốc.
Ailoot Ultra · System One POST /v1/systemone liquid/d1
liquid/d1Bắt đầu
Quy trình quyết định văn bản của Liquid AI d1 đánh giá bằng chứng được cung cấp theo các kết quả cố định và trả về xác suất, một lựa chọn danh mục hoặc điểm thang tiêu chí. Mô hình hỗ trợ phân loại, định tuyến, lọc theo mức liên quan và xếp mức ưu tiên mà không sinh câu trả lời bằng vă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 liquid/d1 | 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 $0.00008 / 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 $0.00008 / 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": "liquid/d1",
"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']='liquid/d1'
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 liquid/d1
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 · LiquidAI: d1
- Có những đầu vào và kết quả nào?
POST /v1/systemone·liquid/d1:text→decisions- Yêu cầu sử dụng những trường nào?
POST /v1/systemone·liquid/d1:model,provider,questions,session_id,state,trace,user