Tool tree
gradeNot graded
add_to_cartAction
Gửi yêu cầu thêm sản phẩm vào giỏ hàng hiện tại khi người dùng yêu cầu. Không đặt hàng hay thanh toán. quantity là số lượng thêm, mặc định 1. price_id và attributes lấy từ lựa chọn sản phẩm; bỏ trống dùng lựa chọn mặc định của website. Trả JSON với status submitted; cần kiểm tra giỏ hàng để xác nhận kết quả, không tự động thử lại vì có thể tăng số lượng lần nữa.
View tool JSON
{
"name": "add_to_cart",
"kind": "act",
"impl": "imperative",
"description": "Gửi yêu cầu thêm sản phẩm vào giỏ hàng hiện tại khi người dùng yêu cầu. Không đặt hàng hay thanh toán. quantity là số lượng thêm, mặc định 1. price_id và attributes lấy từ lựa chọn sản phẩm; bỏ trống dùng lựa chọn mặc định của website. Trả JSON với status submitted; cần kiểm tra giỏ hàng để xác nhận kết quả, không tự động thử lại vì có thể tăng số lượng lần nữa.",
"inputSchema": {
"type": "object",
"properties": {
"product_id": {
"type": "string",
"pattern": "^[1-9][0-9]*$",
"description": "Mã sản phẩm (Int32 dương)."
},
"quantity": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 1
},
"price_id": {
"type": "integer",
"minimum": 0,
"default": 0,
"description": "Mã lựa chọn giá; 0 dùng mặc định của website."
},
"attributes": {
"type": "string",
"default": "",
"description": "Các mã thuộc tính phân cách bằng dấu phẩy; rỗng dùng mặc định của website."
}
},
"required": [
"product_id"
],
"additionalProperties": false
}
}search_productsAnswer
Tìm sản phẩm theo từ khóa, có phân trang. Trả chuỗi JSON gồm query, page, page_size, total, total_pages, products. Mỗi sản phẩm có product_id để gọi get_product_detail, name, price dạng số, currency và in_stock. Không tìm thấy trả products rỗng và total bằng 0. Lỗi tải dữ liệu làm tool thất bại.
View tool JSON
{
"name": "search_products",
"kind": "answer",
"impl": "imperative",
"description": "Tìm sản phẩm theo từ khóa, có phân trang. Trả chuỗi JSON gồm query, page, page_size, total, total_pages, products. Mỗi sản phẩm có product_id để gọi get_product_detail, name, price dạng số, currency và in_stock. Không tìm thấy trả products rỗng và total bằng 0. Lỗi tải dữ liệu làm tool thất bại.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "Tên, mã hoặc từ khóa sản phẩm."
},
"page": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991,
"default": 1,
"description": "Trang kết quả, bắt đầu từ 1."
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 32,
"default": 20,
"description": "Số sản phẩm mỗi trang (tối đa 32)."
}
},
"required": [
"query"
],
"additionalProperties": false
}
}get_product_detailAnswer
Lấy chi tiết sản phẩm theo product_id từ search_products hoặc mã người dùng cung cấp. Trả chuỗi JSON chứa product_id, name, category, brand, price dạng số, currency và in_stock; trả chuỗi JSON null nếu không tìm thấy. Lỗi tải dữ liệu làm tool thất bại.
View tool JSON
{
"name": "get_product_detail",
"kind": "answer",
"impl": "imperative",
"description": "Lấy chi tiết sản phẩm theo product_id từ search_products hoặc mã người dùng cung cấp. Trả chuỗi JSON chứa product_id, name, category, brand, price dạng số, currency và in_stock; trả chuỗi JSON null nếu không tìm thấy. Lỗi tải dữ liệu làm tool thất bại.",
"inputSchema": {
"type": "object",
"properties": {
"product_id": {
"type": "string",
"minLength": 1,
"description": "Mã định danh sản phẩm."
}
},
"required": [
"product_id"
],
"additionalProperties": false
}
}