Perplexity ra mắt pplx: Công cụ CLI đưa sức mạnh tìm kiếm AI trực tiếp vào terminal

Perplexity vừa phát hành pplx, một ứng dụng dòng lệnh (command line client) chính thức cho Search API của họ. Công cụ này trả về kết quả tìm kiếm có căn cứ và văn bản được trích xuất từ trang web, tất cả đều ở định dạng JSON. Theo tài liệu đi kèm, công cụ này nhắm đến cả người dùng cá nhân lẫn các tác nhân lập trình (coding agents). Đây không phải là một ứng dụng chat. Nó không có chế độ hội thoại, không cho phép chọn mô hình và không có tính năng tổng hợp câu trả lời.

Hai bề mặt, một hợp đồng đầu ra

Công cụ này cung cấp chính xác hai bề mặt làm việc. pplx search web thực hiện tìm kiếm web trực tiếp. pplx content fetch truy xuất một URL và trả về văn bản đã được làm sạch từ trang web đó.

Hợp đồng xoay quanh chúng mới là phần thú vị. Theo Agent Skill chính thức của pplx-cli, thành công đồng nghĩa với mã thoát (exit code) là 0 và trả về chính xác một đối tượng JSON trên stdout. Kết quả tìm kiếm trả về {hits: [{url, title, domain, snippet,...}], total, saved_to?}.

Mọi thất bại đều trả về mã thoát 1 với stdout trống. Một đối tượng lỗi JSON sẽ được gửi đến stderr, có cấu trúc {"error":{"code","message","command","hint"?}}. Các mã lỗi được ghi nhận bao gồm AUTHENTICATION, UNKNOWN_ARGUMENT, ARGUMENT_ERROR và BAD_REQUEST. Tài liệu lưu ý rằng danh sách này chưa đầy đủ, vì vậy người gọi nên xử lý phân nhánh dựa trên error.code.

Đường dẫn cài đặt và hỗ trợ nền tảng

Việc cài đặt chỉ cần một lệnh shell duy nhất để truyền một script vào sh:

Đọc file install.sh sẽ cho thấy những gì nó thực sự thực hiện. Nó tải xuống manifest.json từ bản phát hành mới nhất và trích xuất thẻ (tag) cũng như phiên bản. Sau đó, nó ghim mọi bản tải xuống còn lại vào thẻ đó, nhằm tránh xung đột với quá trình xuất bản đồng thời.

Nó lấy SHA256SUMS và file nhị phân của nền tảng, xác minh tổng kiểm tra (checksum) và cài đặt vào ~/.local/bin/pplx. Không cần quyền sudo. Một biên lai được ghi vào ~/.config/pplx/pplx-receipt.json, nhưng chỉ sau khi file nhị phân được cài đặt chạy thành công.

Phạm vi hỗ trợ nền tảng giới hạn ở ba mục tiêu: macOS trên Apple Silicon, Linux x86_64 và Linux arm64. Bất kỳ nền tảng nào khác đều sẽ thoát với thông báo lỗi. Không có bản dựng cho Windows và macOS trên chip Intel.

Kinh tế học về cửa sổ ngữ cảnh là mối quan tâm thiết kế hàng đầu

Tính năng đặc thù nhất cho tác nhân (agent) là quản lý ngân sách token. --output-dir ghi toàn bộ tập kết quả vào một file JSON. --stdout-preview[=<CHARS>] cắt bớt các trường chuỗi dài trong stdout, thêm các dấu hiệu...<truncated>.

Kỹ năng này cảnh báo rõ ràng về cái bẫy: --stdout-preview sẽ không hoạt động nếu không có thư mục lưu trữ. Nó chỉ cắt bớt khi kết quả cũng được lưu thông qua --output-dir hoặc $PPLX_OUTPUT_DIR. Nếu sử dụng độc lập, nó sẽ trả về đầu ra đầy đủ, và mỗi kết quả tìm kiếm có thể lên tới nhiều KB.

Kết quả tìm kiếm được lưu tại {dir}/web/{rand}.json và các nội dung truy xuất tại {dir}/fetch/{rand}.json. Các file chỉ được ghi sau khi yêu cầu thành công. PPLX_OUTPUT_DIR thiết lập mặc định cho không gian làm việc để không cần phải lặp lại flag này.

Đối với việc truy xuất nội dung, kỹ năng này bổ sung kiểm tra tính chính xác thay vì kiểm tra chi phí. Hãy xác minh lỗi và is_paywall trong đầu ra trước khi tin tưởng nội dung. --html thêm một trường raw_html được lấy trực tiếp qua trình thu thập dữ liệu (crawler), và --no-cache buộc thực hiện truy xuất trực tiếp.

Những điểm chính cần lưu ý

Nguồn: perplexityai/perplexity-cli, pplx-cli SKILL.md, api-platform-developers, Perplexity API pricing, Rate limits and usage tiers, và Search API quickstart

Michal Sutter là một chuyên gia khoa học dữ liệu với bằng Thạc sĩ Khoa học Dữ liệu từ Đại học Padova. Với nền tảng vững chắc về phân tích thống kê, học máy và kỹ thuật dữ liệu, Michal xuất sắc trong việc chuyển đổi các tập dữ liệu phức tạp thành những thông tin chi tiết có giá trị thực tiễn.