Bộ nhớ, tài liệu và web

Các tool này giúp agent chạm tới những gì nằm ngoài cuộc trò chuyện: điều nó nhớ về bạn, tài liệu của tổ chức, ngân sách của bạn, các cuộc trò chuyện cũ và web công khai. Mỗi tool xác định phạm vi từ lượt, ở backend.

Quy tắc chính

Bộ nhớ được gọi khi cần, không nạp sẵn. Agent tự tìm khi cần.
Phát biểu và trích đoạn tách riêng. Trích đoạn tài liệu có thể được trích dẫn; một phát biểu đã nhớ không được mượn uy tín đó.
Lỗi truy cập trông như không tồn tại. Tài liệu lượt không được đọc bị từ chối như thể không có.
Trang web là tư liệu, không phải chỉ dẫn. Địa chỉ nội bộ và loopback bị từ chối.

Bộ nhớ và tài liệu

Phát biểu trong bộ nhớ và trích đoạn tài liệu nằm trong cùng một kho, phân biệt theo nguồn gốc. Cả hai lượt tìm đều embed ngôn ngữ tự nhiên qua proxy mô hình, gộp từ khoá và ngữ nghĩa thành một xếp hạng, và trả về kết quả; không vector nào vào ngữ cảnh mô hình.

Chúng vẫn là hai tool vì trích đoạn có thể được trích dẫn, còn một phát biểu trợ lý từng viết về ai đó không được mượn uy tín ấy. Tìm bộ nhớ trả ít kết quả hơn tìm tài liệu.

Ghi bộ nhớ

Một lần ghi bộ nhớ tồn tại lâu hơn cuộc trò chuyện, nên mô tả của nó thận trọng.

Một lô lưu mỗi dữ kiện một bản ghi; không khử trùng lặp khi ghi.
Thay thế sẽ lưu dữ kiện mới trước rồi mới loại dữ kiện cũ, nên trường hợp xấu nhất của hai lần gọi riêng là một bản trùng.
Quên dừng việc gợi nhớ nhưng giữ bản ghi, và bạn có thể khôi phục.
Lần ghi không nêu phạm vi: mọi phát biểu đều vào tập dữ liệu của người đang trò chuyện.
expiresAt tuỳ chọn cho phát biểu thời hạn ngắn hơn; không có thì nó tồn tại đến khi bị quên hoặc thay thế.
Lần ghi bị từ chối là một mục trong danh sách lỗi kèm mã và thông báo của backend, vì “không được phép” là dứt khoát còn “backend sập” thì không.

Bạn quản lý bộ nhớ trong Settings → Memory.

Đọc tài liệu

read_document ghép các đoạn chưa bị thay thế, nên câu trả lời là bản sửa mới nhất.

Tài liệu phải nằm trong kho tri thức agent này gắn và người sở hữu lượt đọc được — hoặc là tệp đính kèm ở bất kỳ đâu trong cuộc trò chuyện này. Mọi lỗi đều bị từ chối như thể tài liệu không tồn tại.
Lần đọc nêu trạng thái lập chỉ mục của tài liệu và chờ tối đa một phút nếu tài liệu đang được đọc. Tài liệu lỗi trả về lý do và không có văn bản.
Khoảng trang chỉ đọc các đoạn trên những trang đó; tài liệu không đánh số trang từ chối khoảng trang.
Một lần gọi trả tối đa 40.000 ký tự dù nêu bao nhiêu tài liệu. Tài liệu bị ngân sách cắt mang vị trí để đọc tiếp, và việc cắt được khai báo.
Dùng cùng cơ chế cửa sổ với việc đọc trang web (bên dưới).

Liệt kê nguồn nêu từng kho tri thức cùng tài liệu của nó, cho biết giới hạn đã bỏ bớt bao nhiêu, và nêu cả kho tri thức rỗng.

Tệp đính kèm

read_document được cung cấp khi agent gắn tri thức hoặc cuộc trò chuyện có tài liệu đính kèm.
search_attachments được cung cấp khi có tệp đính kèm và chỉ chạm tới tài liệu đính kèm trong cuộc trò chuyện đó. Nó tách riêng khỏi tìm tri thức để tệp bạn gửi không bị xếp hạng chung với thư viện của tổ chức. Giống tìm tri thức, nó cần mô hình embedding của tổ chức.

Cách xử lý tệp đính kèm nằm ở Quy trình tri thức; cách xếp hạng ở Truy xuất.

Ngân sách

Tool ngân sách kiểm tra phần phòng ban theo người sở hữu lượt, không theo agent; chi tiêu của một người luôn là của họ.

Lời từ chối mang mã riêng thay vì số 0 hay sự cố.
Ngân sách là ngân sách hiệu lực, đọc từ chính sách cụ thể nhất đang có — của riêng người đó, của phòng ban hay của tổ chức — dù cao hơn hay thấp hơn. Xem Ngân sách và chính sách.
Phần còn lại không bao giờ âm.
Kỳ là tháng dương lịch theo UTC, kèm cả hai mốc trong câu trả lời.

Cuộc trò chuyện cũ

Tìm cuộc trò chuyện cũ khớp theo từ, nên mô hình gửi cách diễn đạt nó đoán với nhiều cách viết.

Chỉ những gì người dùng viết mới được khớp và trả về — không bao giờ có đầu ra tool hay tóm tắt suy luận.
Cuộc trò chuyện của ai được xác định từ lượt. Cuộc đã lưu trữ vẫn trong phạm vi; cuộc đã xoá thì không.
Không khớp là danh sách rỗng, không phải lỗi.
Mỗi kết quả là một tin nhắn, nên một cuộc trò chuyện có thể khớp nhiều lần. Trace gom kết quả theo cuộc trò chuyện, nêu mỗi cuộc một lần và cho biết bao nhiêu tin nhắn đã khớp.

Web công khai

Kiểm tra nhà cung cấp và mạng chạy trước khi danh sách tool được tạo. Tìm kiếm đi qua nhà cung cấp được tổ chức duyệt và việc trích xuất trang chạy trong tài khoản của nhà cung cấp đó. Yêu cầu “Google” nghĩa là tìm kiếm, không bao giờ là tự ghép URL trang kết quả để đọc.

Tìm kiếm: `research_web`

Tìm mọi góc cùng lúc và đọc tối đa ba trang.
Giữ riêng đoạn trích theo nhóm, trang đã đọc, lượt tìm lỗi và lượt đọc lỗi.
Kết quả giữ theo nhóm truy vấn đã tìm ra: thứ hạng là phần lớn tín hiệu của công cụ tìm kiếm, và hai danh sách xếp hạng không có điểm chung để gộp.

Đọc một trang

Đọc trang chỉ trả văn bản; không có điều hướng hay bấm, và hạn mức mỗi lần gọi thấp nhất bộ. Địa chỉ có thể đến từ người dùng, từ kết quả tìm kiếm hoặc từ hiểu biết của mô hình về trang web.

Trường	Ý nghĩa
`contentStart`, `nextCursor`, `truncated`, cảnh báo	Trang chưa đầy đủ — chỉ đọc tiếp đến mức câu hỏi cần
`render=true`	Render một trang tĩnh không rỗng nhưng thiếu nội dung động

Nhà cung cấp

Dịch vụ nào tìm và dịch vụ nào đọc là cấu hình của tổ chức, xác định theo từng lượt từ các dịch vụ đã bật. Tool được cung cấp miễn còn một dịch vụ trả lời được.

Cấu hình	Tìm kiếm	Đọc
Có Firecrawl (ưu tiên cho cả hai)	Firecrawl — kết quả xếp hạng, không kèm nội dung trang	Firecrawl
Không có Firecrawl	Tavily	Bộ tải trang riêng của portal

Qua Firecrawl, trang về dưới dạng Markdown của nội dung chính, đã render, đi theo chuyển hướng, và đọc được cả PDF kể cả bản quét. Đọc lại trong cửa sổ cache của Firecrawl được trả từ cache. Tìm kiếm không yêu cầu nội dung trang vì research_web chọn trang cần đọc sau khi xếp hạng, thay vì trả tiền cho mọi kết quả.
Không có Firecrawl, đường nhanh trích HTML tĩnh, văn bản hoặc lớp chữ của PDF. Trang chỉ là khung JavaScript được render trong phiên AgentCore Browser biệt lập, chỉ đọc. Trang PDF cần OCR và tài nguyên trình duyệt bị chặn được báo là bị lược.

An toàn

Mô tả của cả hai tool web nhắm vào hai lỗi:

tìm trên web khi câu trả lời nằm trong tài liệu của tổ chức;
coi trang web đang “nói chuyện” với mô hình là chỉ dẫn — agent này có tool ghi.

Schema từ chối mọi thứ không phải địa chỉ web, và phía tải trang từ chối địa chỉ nội bộ và loopback, kể cả metadata của máy chủ đám mây. Kết quả tool cũng đi qua guardrails của tổ chức.

Liên quan

Cài đặt bộ nhớ Xem, quên và khôi phục những gì trợ lý nhớ. Guardrails Các kiểm tra áp lên prompt và kết quả tool. Truy xuất Cách tìm tri thức xếp hạng các đoạn. Quy tắc tool Gom lô, vắng mặt và sự cố, thử lại.