Context API trích xuất toàn bộ ngữ cảnh từ bất kỳ trang web nào
Sử dụng Perplexity Context API để cung cấp cho các tác nhân AI Markdown sạch, liên kết và các đoạn văn liên quan từ trang web được lưu trong bộ nhớ đệm hoặc trang web trực tiếp.

Khi ai đó đặt câu hỏi cho chatbot, một tác nhân AI có thể cần đọc nhiều trang web để trả lời. Kết quả tìm kiếm thông thường thường chỉ trả về các đoạn trích. Tìm nạp trực tiếp một trang có thể trả về HTML thô, chứa đầy thanh điều hướng, biểu ngữ cookie và quảng cáo. Các tác nhân cần ngữ cảnh của trang ở định dạng mà mô hình có thể sử dụng, còn nhà phát triển cần một cách để kiểm soát mức độ mới của ngữ cảnh đó.
Hôm nay, chúng tôi ra mắt Perplexity Context API, có khả năng đọc tối đa 10 URL và trả về Markdown sạch, HTML, liên kết cùng các đoạn trích dựa trên truy vấn cho từng trang. Thông tin đến từ chỉ mục web khổng lồ của Perplexity hoặc từ một lần tìm nạp trực tiếp. Các tác nhân có thể chỉ định độ mới cho từng yêu cầu và xác thực nguồn của từng kết quả.
Context API hỗ trợ nhiều định dạng
Các tác nhân có thể khởi tạo yêu cầu bằng cách cung cấp danh sách URL và chỉ định các định dạng đầu ra. API trả về một kết quả cho mỗi URL theo đúng thứ tự đó.
Context API hỗ trợ nhiều định dạng phản hồi:
- Markdown: Nội dung trang dưới dạng Markdown sạch, sẵn sàng để đưa vào ngữ cảnh của mô hình.
- HTML: HTML của trang, dành cho các ứng dụng tự thực hiện phân tích cú pháp.
- Liên kết: Các liên kết trên trang dưới dạng URL tuyệt đối, không trùng lặp và theo thứ tự xuất hiện trên trang để tác nhân có thể quyết định nơi cần truy cập tiếp theo.
- Đoạn trích: Các đoạn văn của trang liên quan nhất đến truy vấn được cung cấp, trong giới hạn token mà nhà phát triển đặt cho từng trang.
Context API chọn ra các đoạn văn liên quan đến truy vấn từ mỗi trang thay vì tạo bản tóm tắt. Nhờ đó, mô hình nhận được nguyên văn của trang nhưng chỉ ở những đoạn được chọn, nên có ít văn bản cần xử lý hơn.
Mỗi kết quả thành công cũng bao gồm siêu dữ liệu như tiêu đề, mô tả, ngôn ngữ, tác giả và ngày xuất bản, cùng với các thẻ Open Graph của trang. Để tạo Markdown, Context API chia trang thành các khối và một mô hình chấm điểm từng khối là nội dung chính hay nội dung rập khuôn. Chỉ các khối nội dung được giữ lại.
Thiết yếu cho các tác vụ cần bức tranh toàn cảnh
Tìm được một trang liên quan không phải lúc nào cũng đủ để hoàn thành công việc. Với Context API, các tác nhân có thể truy xuất nội dung cần thiết từ các URL được chọn để hoàn thành những tác vụ phức tạp.
- Triển khai tích hợp API: Một kết quả tìm kiếm có thể chỉ ra đúng tài liệu nhưng không bao gồm các tham số bắt buộc, hướng dẫn xác thực hoặc các trường hợp lỗi. Context API có thể giúp tác nhân lập trình truy xuất tài liệu và tài liệu tham khảo API để viết mã tích hợp dựa trên những chi tiết đó.
- So sánh giá hiện tại: Mức giá niêm yết có thể phụ thuộc vào giới hạn sử dụng, điều khoản thanh toán hoặc điều kiện áp dụng không có trong đoạn trích tìm kiếm. Tác nhân có thể yêu cầu tìm nạp trực tiếp các trang giá được chọn và đọc những điều kiện đó trước khi so sánh.
- Trả lời câu hỏi về chính sách: Đoạn trích chính sách đổi trả có thể nêu thời hạn đổi trả tiêu chuẩn nhưng bỏ qua các ngoại lệ đối với một số sản phẩm hoặc khu vực cụ thể. Tác nhân hỗ trợ có thể truy xuất trang chính sách để câu trả lời của mình tính đến những ngoại lệ đó.
- Nghiên cứu trên nhiều nguồn: Một đoạn trích tìm kiếm có thể nêu ra một phát hiện mà không kèm phương pháp luận, các điều kiện giới hạn hoặc lập luận xung quanh. Tác nhân nghiên cứu có thể truy xuất các bài viết và báo cáo được chọn, sau đó so sánh bằng chứng thay vì chỉ dựa vào các đoạn trích.
Kiểm soát độ mới và xử lý URL một cách đáng tin cậy
Theo mặc định, trước tiên Context API sẽ kiểm tra chỉ mục web của Perplexity để tìm bản sao của trang đã được tìm nạp trong vòng hai ngày qua. Nếu không có, API sẽ tìm nạp trang trực tiếp. Nhà phát triển có thể đổi max_age_seconds thành 0 để luôn đọc trang trực tiếp, phù hợp với giá cả, tỷ số và tin nóng. Với tài liệu tham khảo hiếm khi thay đổi, họ có thể tăng giá trị này. Đặt cache_only thành true cho các khối lượng công việc không bao giờ được kích hoạt yêu cầu trực tiếp.
Mỗi kết quả ghi lại việc nội dung đến từ bản sao được lưu trữ hay từ lần tìm nạp trực tiếp, cũng như thời điểm tìm nạp.
Các URL trong một yêu cầu được tìm nạp song song, mỗi URL có quỹ thời gian và trạng thái riêng. Một trang chậm hoặc bị lỗi không làm hỏng các trang khác. Trạng thái cho biết điều gì đã xảy ra với từng URL, để tác nhân chỉ cần thử lại những trang bị hết thời gian chờ và giữ lại phần còn lại.
Context API trả về nội dung đầy đủ và dùng được
Chúng tôi đã thử nghiệm Context API so với Firecrawl, Exa, Parallel, Keenable và Context.dev trên 1.000 URL được lấy mẫu từ các yêu cầu tìm nạp thực tế của tác nhân. Tập dữ liệu bao gồm 715 trang web, trong đó có các nguồn chính phủ, học thuật và các trang không phải tiếng Anh. Sau đó, một mô hình giám khảo riêng biệt chấm điểm các kết quả đầu ra mà không biết nhà cung cấp nào đã tạo ra từng kết quả.
Biểu đồ đo lường hiệu suất theo ba tiêu chí:
- Khả dụng: Tỷ lệ URL trả về nội dung thực của trang, không phải trang lỗi hoặc kết quả trống.
- Độ thu hồi dữ kiện: Mô hình giám khảo thu thập các dữ kiện chính có trên một trang từ tất cả nhà cung cấp, sau đó kiểm tra xem mỗi kết quả đầu ra chứa những dữ kiện nào. Lần tìm nạp thất bại được tính điểm 0.
- Độ chính xác nội dung: Tỷ lệ văn bản trả về là nội dung trang, không phải thông báo cookie, thanh điều hướng hay quảng cáo, tính trung bình trên tất cả URL. Mỗi lần tìm nạp thất bại được tính 0 điểm.
Trong đánh giá này, Context API trả về nội dung dùng được cho 92,3% URL, thu được 87,9% dữ kiện chính và đạt 80,3% về độ chính xác nội dung.
Giá
Context API có giá 1 USD cho mỗi 1.000 URL được tìm nạp. Nhà phát triển trả phí cho mỗi URL trả về ok. Các URL thất bại không bị tính phí.
Bắt đầu
curl --request POST https://api.perplexity.ai/v1/context \
--header "Authorization: Bearer $PERPLEXITY_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"urls": ["https://info.cern.ch/hypertext/WWW/TheProject.html"],
"formats": ["markdown"]
}'Mỗi kết quả trả về kèm theo Markdown của trang, các đoạn văn khớp với truy vấn, siêu dữ liệu của trang và trạng thái. Hãy kiểm tra trạng thái của từng kết quả trước khi sử dụng nội dung.
Đọc tài liệu Context API hoặc xem tài liệu tham khảo API.