Căn cứ dữ liệu web cho Decisions API

Các mô hình ra quyết định AI nhanh và tiết kiệm chi phí, nhưng chúng chỉ biết những gì người dùng gửi cho chúng và những gì chúng học được trong quá trình huấn luyện. Với các câu hỏi về những dữ kiện thay đổi, chẳng hạn như liệu một người có còn là CEO của một công ty hay không, hoặc một sản phẩm đã có bản phát hành mới chưa, mô hình cần thông tin cập nhật để trả lời chính xác.

Kể từ hôm nay, Decisions API của Perplexity đã có thể tìm kiếm trên web trước khi trả lời.

Thêm một thiết lập, "mode": "web_grounding" vào bất kỳ yêu cầu Decisions API nào, và Perplexity Fast Search sẽ chạy một truy vấn cho mỗi câu hỏi. Kết quả được thêm vào state của bạn làm bằng chứng, nhờ đó mô hình ra quyết định trả về xác suất dựa trên thông tin hiện có trên web ngay lúc này. State cũng có thể là một URL để chỉ mô hình đến một trang web cụ thể thay vì nhập văn bản của trang đó.

Trên PWS-Decisions, một bộ đánh giá chuẩn công khai gồm 100 câu hỏi phụ thuộc vào các dữ kiện hiện tại trên web, độ chính xác đã tăng từ 51% lên 86% với thời gian phản hồi thông thường dưới 400 ms.

Mô hình ra quyết định trả về một con số làm câu trả lời cho mỗi câu hỏi. Người dùng gửi nội dung dưới dạng state (văn bản, JSON hoặc hình ảnh) kèm theo một hoặc nhiều câu hỏi. Với câu hỏi noul (có hoặc không), kết quả là xác suất của câu trả lời có. Với câu hỏi choice, kết quả là xác suất cho từng lựa chọn do người dùng xác định. Với câu hỏi score, kết quả là xác suất cho từng mức trong thang tiêu chí đánh giá của bạn và điểm số kỳ vọng.

Mô hình có hai nguồn thông tin: state mà người dùng gửi và những gì nó học được trong quá trình huấn luyện. Như vậy là đủ cho một câu hỏi như "Bài đánh giá này có báo cáo lỗi sản phẩm không?" Nhưng chưa đủ để trả lời "Người này có còn là CEO không?" Câu trả lời có thể đã thay đổi sau quá trình huấn luyện và không có gì trong state cho biết điều đó. Tính năng căn cứ dữ liệu web bổ sung nguồn thứ ba: web, được tìm kiếm tại thời điểm gửi yêu cầu. State cũng có thể là một URL, vì vậy người dùng có thể chỉ mô hình đến một trang web thay vì văn bản.

Grounding chạy trong cổng API trước khi gọi mô hình. Với mỗi câu hỏi trong một yêu cầu, cổng sẽ tạo một truy vấn Fast Search. Các truy vấn chạy song song. Cổng hợp nhất kết quả, loại bỏ các URL trùng lặp và nối bằng chứng vào state: tiêu đề, URL và văn bản của trang. Nếu state là một URL, truy vấn tìm kiếm sẽ mang theo URL đó, nhờ vậy chính trang ấy được trả về làm bằng chứng và mô hình trả lời dựa trên văn bản của trang. Mô hình trả về xác suất giống như với bất kỳ yêu cầu Decisions API nào. Nếu một lượt tìm kiếm thất bại hoặc hết thời gian chờ, mô hình sẽ trả lời dựa trên bất kỳ bằng chứng nào đã nhận được. Phản hồi bao gồm search_results để người dùng có thể xem những gì mô hình đã thấy. Yêu cầu của người dùng và cấu trúc của phản hồi vẫn giữ nguyên. Điều thay đổi là bằng chứng mà mô hình có được khi trả lời.

Chúng tôi đã gửi 328 nhận định đúng hoặc sai đến cùng một mô hình ra quyết định hai lần, một lần có căn cứ dữ liệu web và một lần không. Các nhận định được chia giữa tin tức tháng 10 năm 2026 và các dữ kiện hiếm gặp từ Wikipedia, và mỗi nhận định đúng đều có một nhận định sai tương ứng chỉ khác ở một chi tiết. Không có bằng chứng nào được cung cấp trong state.

Khi không có web grounding, Decisions API trả lời đúng 56,4 phần trăm số nhận định, gần như chỉ ngang mức đoán mò. Khi có web grounding, API trả lời đúng 97,3%, giảm số lỗi từ 143 xuống còn 9. Cái giá phải đánh đổi là tốc độ: độ trễ trung vị tăng từ 139 ms lên 366 ms, và độ trễ ở phân vị thứ 95 tăng từ 514 ms lên 742 ms.

PWS-Decisions là một benchmark công khai gồm các câu hỏi đóng về điều kiện đủ của tài khoản, khả năng của sản phẩm, quy tắc chính sách và các sự kiện diễn biến nhanh. 100 câu hỏi được công khai và được chấm điểm theo mức khớp chính xác với câu trả lời tham chiếu. Chúng tôi đã chạy các câu hỏi này trên Decisions API + Web Grounding (pplx-decider-v1.2) vào ngày 4 tháng 11 năm 2026 và API đã trả lời đúng 86 câu. Các kết quả khác bên dưới là bảng xếp hạng do các tác giả của benchmark công bố. Kết quả 51% mà họ ghi nhận cho Decisions API khi không có Web Grounding khớp với lần chạy của chính chúng tôi.

Các yêu cầu Decisions API + Web Grounding trả về trong 370 ms ở mức trung vị và 685 ms ở phân vị thứ 95, được đo từ máy khách của chúng tôi trên 100 câu hỏi công khai. Các tác giả của bộ đánh giá chuẩn báo cáo 560 ms và 710 ms cho API của họ trên toàn bộ tập 300 câu hỏi, được đo từ máy khách của họ vào ngày 29 tháng 10 năm 2026. So với bảng xếp hạng đã công bố, Decisions API + Web Grounding có độ chính xác cao nhất trên tập công khai và thời gian phản hồi trung vị dưới 400 ms.

Bật tính năng căn cứ dữ liệu web để trả lời những câu hỏi mà dữ liệu không thể trả lời: khi dữ kiện đã thay đổi sau quá trình huấn luyện và có thông tin mới được đăng tải trên web. Một số ví dụ:

Sàng lọc tài khoản khách hàng dựa trên tin tức gần đây. "Đã huy động vốn trong 90 ngày qua chưa?" trên toàn bộ danh sách tài khoản.
Theo dõi các công cụ bạn phụ thuộc vào. "Có bản phát hành ổn định nào mới hơn phiên bản chúng ta đã cố định không?" được kiểm tra theo lịch.
Xác nhận trước khi tác nhân hành động. "Sự kiện này có còn diễn ra không?" được kiểm tra trước khi tác nhân đặt chỗ.

Mỗi câu trả lời là một xác suất mà mã của nhà phát triển có thể dựa vào để hành động, kèm theo các nguồn web làm căn cứ.

Thêm "mode": "web_grounding" vào bất kỳ yêu cầu Decisions API nào. State có thể là văn bản, chẳng hạn như một nhận định hoặc một bản ghi, hoặc một URL.

Kiểm chứng một nhận định dựa trên web:

bash

curl -X POST https://api.perplexity.ai/v1/decisions \
  -H "Authorization: Bearer $PERPLEXITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pplx-decider-v1.2",
    "mode": "web_grounding",
    "state": "Claim: The James Webb Space Telescope launched in December 2021.",
    "questions": {
      "supported": {
        "type": "noul",
        "instructions": "Is the claim true?"
      }
    }
  }'

Phản hồi bổ sung search_results, tức các trang mà mô hình đã đọc. Vào ngày 4 tháng 11, yêu cầu này trả về xác suất cho câu trả lời “có” trên 0,99, với hồ sơ tàu vũ trụ của NASA là kết quả đầu tiên.

Hướng mô hình đến một trang bằng cách truyền URL của trang đó làm state:

bash

curl -X POST https://api.perplexity.ai/v1/decisions \
  -H "Authorization: Bearer $PERPLEXITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pplx-decider-v1.2",
    "mode": "web_grounding",
    "state": "https://pypi.org/project/requests/",
    "questions": {
      "newer_stable_release": {
        "type": "noul",
        "instructions": "Has this package published a stable release newer than 2.31.0 as of today?"
      }
    }
  }'

Trong thư viện Python của Perplexity, hãy truyền mode trong phần thân yêu cầu:

python

from perplexity import Perplexity

client = Perplexity()

response = client.decisions.create(
    model="pplx-decider-v1.2",
    state="Claim: The James Webb Space Telescope launched in December 2021.",
    questions={"supported": {"type": "noul", "instructions": "Is the claim true?"}},
    extra_body={"mode": "web_grounding"},
)

print(response.answers["supported"].noul)

Mỗi lượt tìm kiếm hoàn tất có giá 0,001 USD, cộng thêm vào chi phí token đầu vào. Bằng chứng tìm kiếm được tính vào token đầu vào. Một yêu cầu sử dụng Web Grounding có thể bao gồm tối đa 100 câu hỏi.

Hãy bắt đầu bằng cách tìm hiểu tài liệu về web grounding.

Cách mô hình ra quyết định hoạt động

Cách tính năng căn cứ dữ liệu web hoạt động

Kiểm thử tính năng căn cứ dữ liệu web

PWS-Decisions

Những gì nhà phát triển có thể xây dựng

Bắt đầu