Tool của agent

Mô tả của một toolCông cụ (tool)ToolViệc agent làm được ngoài viết chữ: tìm trong kho tri thức, tìm trên web, đọc tệp, tạo artifact, hoặc thao tác trong ứng dụng kết nối.Mở trong Thuật ngữ là chỉ dẫn duy nhất mô hình đọc trước khi quyết định gọi tool đó. Vì vậy mỗi mô tả được viết để chặn đúng lỗi nó cần phòng, và nhiều mô tả dành nhiều chữ cho lúc không nên gọi hơn là cho việc tool làm.

Quy tắc chính

1. Phạm vi lấy từ lượt. Mỗi tool xác định những gì nó được chạm tới ở backend, nên không gì mô hình viết ra có thể nới rộng phạm vi đó.
2. Danh sách cho phép quyết định. Agent không khai báo tool nào thì không được cung cấp tool tuỳ chọn nào.
3. Một số tool luôn bật. Câu hỏi làm rõ, gợi ý, tính toán, read_tool_result và read_transcript không mở rộng quyền gì, nên lượt nào cũng có.
4. Tool không được cung cấp sẽ bị từ chối. Lời từ chối chỉ nêu tên tool, không tiết lộ gì thêm.
5. Quy tắc đi cùng tool. Hướng dẫn về một tool chỉ vào prompt ở những lượt tool đó được đăng ký.

Danh mục tool

Tool	Nhóm	Được cung cấp khi	Đọc / ghi	Giới hạn chính
list_files, search_files, read_file	Workspace	Mọi lượt (bộ workspace)	Đọc	search_files: tối đa 5 chuỗi, tối đa 3 dòng ngữ cảnh mỗi phía
write_file, edit_file, delete_file	Workspace	Mọi lượt (bộ workspace)	Ghi	write_file: tối đa 3 tệp mỗi lô; thay cả tệp bị từ chối khi tệp dài hơn vài nghìn ký tự
run_code	Code	Có trong danh sách cho phép	Đọc và ghi workspace	Không mạng, không thông tin xác thực, không cài gói; tối đa 3 ref toolResults
Máy tính	Tính toán	Luôn bật	Đọc	Làm tròn 12 chữ số có nghĩa
read_tool_result	Kết quả đã lưu	Luôn bật	Đọc	Tối đa 3 ref mỗi lần gọi; maxChars mặc định 4.000 (1.024–20.000)
read_transcript	Các lượt trước	Luôn bật	Đọc	Mặc định 6.000 ký tự, tối đa 20.000
Câu hỏi làm rõ	Tạm dừng	Luôn bật	—	Tối đa một câu trả lời được đề xuất
suggest_next_actions	Gợi ý	Luôn bật	—	—
Tìm, ghi, quên bộ nhớ	Bộ nhớ	Công tắc bộ nhớ bật và mô hình embedding có trong danh mục	Tìm là đọc; ghi và quên là ghi	Tìm bộ nhớ trả ít kết quả hơn tìm tài liệu
Tìm tri thức	Tài liệu	Agent gắn tri thức và có mô hình embedding	Đọc	—
read_document	Tài liệu	Agent gắn tri thức, hoặc cuộc trò chuyện có tài liệu đính kèm	Đọc	Tối đa 40.000 ký tự mỗi lần gọi
search_attachments	Tài liệu	Cuộc trò chuyện có tệp đính kèm (cần mô hình embedding)	Đọc	Chỉ các tệp đính kèm trong cuộc trò chuyện này
Kiểm tra ngân sách	Ngân sách	Công tắc riêng	Đọc	Tháng dương lịch theo UTC
Tìm cuộc trò chuyện cũ	Lịch sử	Công tắc riêng	Đọc	Chỉ khớp chữ do người dùng viết
research_web và đọc trang	Web công khai	Có nhà cung cấp được duyệt	Đọc	research_web đọc tối đa 3 trang; đọc trang có hạn mức mỗi lần gọi thấp nhất bộ
create_artifact, rewrite_artifact, update_artifact	Artifact	Có trong danh sách cho phép	Ghi	Tệp trực quan phải được kiểm tra trước khi lưu
inspect_artifact, measure_layout, print_pdf	Duyệt artifact	Đi kèm các tool artifact sẵn có	Đọc (print_pdf ghi một PDF vào workspace)	10 trang mỗi lần kiểm tra
Trình nạp skill	Skill	Có skill đã xuất bản được gắn	Đọc	Một tên skill mỗi lần gọi
update_tasks	Danh sách việc	Có sẵn trong runtime (không gọi route nào của portal)	Trạng thái chỉ trong runtime	Tối đa 20 việc, một việc đang làm
search_tools, list_tools, get_tool_schema	Khám phá tool	Danh mục của portal	Đọc	search_tools: tối đa 5 truy vấn mỗi lần gọi

Tool ứng dụng (MCP) đến từ danh sách cho phép của tổ chức, cộng thêm vào bộ này — xem Ứng dụng và MCP.

Đăng ký tool

Danh sách tool được chốt trước khi vòng lặp bắt đầu. Đầu mỗi lượt:

Ngân sách và cuộc trò chuyện cũ mỗi thứ có công tắc riêng, vì tiền và lịch sử trò chuyện là hai rủi ro khác nhau.

Tool thêm gì vào prompt

Mỗi đoạn hướng dẫn của runtime đều bị tính tiền ở mọi lần gọi mô hình của mọi lượt. Vì vậy quy tắc về một tool đi cùng tool đó: lượt không có tool artifact thì không mang đoạn nào về lưu artifact. Phần còn lại trong hướng dẫn chung là phần đúng với bất kỳ bộ tool nào.

• Các đoạn được gom ngay tại chỗ đăng ký, nên không thể lệch khỏi tool của nó.
• Đoạn trùng bị bỏ — ba tool tìm kiếm dùng chung một đoạn về truy vấn không chạy được.
• Thứ tự theo thứ tự đăng ký, vì prompt là tiền tố được cache, còn một tập hợp sẽ đổi thứ tự giữa các lượt.

Định nghĩa tool cũng tính tiền như vậy, với hai mức trần:

Chỉ số	Con số
Danh mục rộng nhất một lượt có thể nhận	40.122 ký tự cho 27 tool
Phần lượt nào cũng trả (sáu tool workspace và bốn tool bên cạnh)	13.456 ký tự trong số đó
Một lượt đo thực tế dựng slide	System prompt + định nghĩa = 13.281 token, 43% tổng lượng đọc qua 11 lần gọi mô hình

Tool nào đẩy một trong hai con số vượt trần sẽ làm một test thất bại; người thêm tool phải nâng trần trong cùng thay đổi hoặc viết ngắn lại.

Ngữ cảnh prompt

Tin nhắn riêng của lượt mở đầu bằng việc mô hình đang nói chuyện với ai và bây giờ là mấy giờ:

• tên, phòng ban và tổ chức (không có mã định danh);
• giờ hiện tại theo múi giờ của người gọi, kèm tên múi giờ.

Phần này nằm trong tin nhắn của lượt chứ không trong system prompt, vì đồng hồ ghi đến từng phút. System prompt đổi mỗi phút sẽ là một tiền tố mới ở mỗi lượt, và cache mà mọi lần gọi sau đọc từ đó sẽ bị ghi lại với giá đầy đủ. Ai chi trả là một khối mã định danh riêng, không hiển thị cho ai.

Trình duyệt báo múi giờ khi bắt đầu lượt; lượt giữ múi giờ đó và khi tiếp tục sẽ hiển thị đúng múi giờ ấy. Lượt không có múi giờ được hiểu là UTC — với người ở UTC+7 sau năm giờ chiều, điều đó nghĩa là ngày hôm qua.

Khám phá các nhóm tool