Đọc trang web trong n8n AI agent với WebReaderAPI

Vì sao dùng node HTTP Request làm tool?

Vì nó đã làm đủ mọi thứ API này cần: một request GET, một header và hai tham số truy vấn. n8n ghi rõ node HTTP Request có thể chạy như node thường hoặc được gắn vào AI agent như một tool, và một số tùy chọn chỉ có ở dạng tool.

Không có gì của chúng tôi để cài hay cập nhật, và khóa nằm trong credential store của n8n chứ không nằm trong workflow. Hãy cấp cho n8n một khóa riêng, để lượng dùng của nó hiển thị tách biệt với các script khác và bạn có thể thu hồi riêng. Tạo nhiều khóa API, ví dụ mỗi agent hoặc dự án một khóa, và thu hồi bất kỳ khóa nào từ dashboard của bạn.

Model chọn URL để đọc như thế nào?

Để model định nghĩa tham số url. n8n hiện một nút cạnh các trường tham số phù hợp để giao giá trị cho model, và bạn cũng có thể tự viết biểu thức bằng hàm $fromAI() của n8n. Hàm nhận một key, một description, một type và một default tùy chọn, ví dụ key url, description "The http or https address of the page to read" và type string.

n8n ghi rõ $fromAI() chỉ hoạt động trong các tool gắn với node AI Agent. Hãy viết description của tool bằng lời lẽ dễ hiểu, chẳng hạn "Reads a public web page and returns its main content as Markdown", để agent biết khi nào nên gọi nó.

Vì sao bật Optimize Response?

Vì mọi thứ một tool trả về đều đi vào context của model. Optimize Response là tùy chọn chỉ dành cho tool, giúp giảm dữ liệu truyền cho model. Với response type JSON bạn có thể chỉ gồm các field được chọn; giữ title, final_url và markdown và bỏ phần còn lại.

Hãy giới hạn độ dài ngay phía chúng tôi bằng max_chars, tùy chọn cắt Markdown trước khi nó rời khỏi API. Các response type HTML và Text của node có tùy chọn Truncate Response riêng, nhưng với phản hồi JSON của chúng tôi thì max_chars là cách kiểm soát đơn giản hơn.

Làm sao dùng API trong một workflow chạy theo lịch?

Dùng node HTTP Request như node thường, không phải tool, đặt sau một Schedule Trigger. Gán cho nó một url cố định, chẳng hạn changelog hoặc trang giá bạn theo dõi, và gửi field markdown sang node tiếp theo: một file, một database, một tin nhắn chat hoặc so sánh với lần chạy trước.

Mỗi lần chạy đọc một trang cho mỗi URL. Theo dõi 20 trang mỗi ngày một lần tốn khoảng 600 credit một tháng cho các trang không cần trình duyệt, nên 10.000 trang (3,75 US$) dùng được hơn một năm. Credit trả trước không bao giờ hết hạn: số trang chưa dùng vẫn ở trong tài khoản của bạn cho đến khi bạn dùng.

Điều gì xảy ra khi một trang từ chối việc đọc?

Node nhận phản hồi lỗi với mã như blocked_by_robots hoặc target_refused, và không bị tính phí. Chúng tôi tôn trọng robots.txt: crawler của chúng tôi tự nhận là WebReaderAPI, tuân theo các quy tắc dành cho nó hoặc cho tất cả robot, và không đọc trang mà website không cho phép. Trang bị từ chối không bị tính phí. Trong agent, hãy để tool trả về lỗi để model giải thích hoặc thử nguồn khác; trong workflow chạy theo lịch, chuyển lỗi sang một nhánh ghi log. Trang lỗi liệt kê mọi mã.

Tôi có thể thử gọi trước khi dựng workflow không?

Chạy cùng lệnh gọi đó trong terminal bằng curl, như trong các công thức curl. Nếu chạy được ở đó mà lỗi trong n8n, nguyên nhân nằm ở cài đặt node, thường nhất là giá trị credential thiếu tiền tố Bearer hoặc tham số url bị để trống.