image_search

key: image.image_search nhóm: ImageAction hàm Client A13: image_search

Chức năng

Tìm tất cả vị trí khớp ảnh mẫu trên màn hình (tối đa max_results) và trả về danh sách tọa độ. Dùng khi cần lặp qua nhiều mục giống nhau.

Tham số (5)

Tên trên UI	payloadName	Kiểu	Mặc định	Mô tả
🚩 Image Input	`image_input`	string	`—`	Chức năng: Ảnh mẫu cho nhóm tìm kiếm theo độ tin cậy (confidence). Nhận link http(s) hoặc đường dẫn file trên máy Client. Bạn cần nhập mục này để action chạy đúng. Ví dụ 1: C:/images/cart_icon.png. Giải nghĩa: Ảnh mẫu nằm sẵn trên máy Client. Ví dụ 2: https://example.com/sample.png. Giải nghĩa: Tải ảnh mẫu từ web về rồi tìm. Ví dụ 3: ={{$json.image_input}}. Giải nghĩa: Ảnh mẫu do bước trước quyết định.
Confidence	`confidence`	string	`0.9`	Chức năng: Ngưỡng tin cậy của thuật toán dò ảnh, từ 0.01 đến 1. Hạ ngưỡng nếu hay không tìm thấy, nâng ngưỡng nếu hay bấm nhầm chỗ. Bạn có thể để trống nếu không cần dùng. Ví dụ 1: 0.9. Giải nghĩa: Mặc định, cân bằng giữa tìm được và tìm đúng. Ví dụ 2: 0.7. Giải nghĩa: Dễ dãi hơn — chịu được thay đổi nhỏ về màu sắc và tỉ lệ. Ví dụ 3: 0.98. Giải nghĩa: Rất chặt, gần như chỉ khớp khi giống hệt từng pixel.
Workflow	`workflow`	string	`workflow`	Chức năng: Nhãn dùng để đặt tên thư mục/file mà Client lưu ảnh. Đặt tên có ý nghĩa để sau này tìm lại bằng chứng cho đúng luồng. Bạn có thể để trống nếu không cần dùng. Ví dụ 1: login-flow. Giải nghĩa: Gom mọi ảnh của luồng đăng nhập vào một chỗ. Ví dụ 2: ={{$workflow.name}}. Giải nghĩa: Tự lấy tên workflow hiện tại của n8n. Ví dụ 3: checkout-2026-07. Giải nghĩa: Tách theo chiến dịch và theo tháng.
Full Page	`full_page`	boolean	`false`	Chức năng: Bật thì xử lý toàn bộ chiều dài trang bằng cách cuộn và ghép lại; tắt thì chỉ xử lý phần đang hiển thị trên màn hình. Bạn có thể để trống nếu không cần dùng. Ví dụ 1: false. Giải nghĩa: Chỉ lấy vùng đang nhìn thấy — nhanh và nhẹ. Ví dụ 2: true. Giải nghĩa: Quét/chụp cả trang dài, kể cả phần phải cuộn mới thấy. Ví dụ 3: ={{$json.flag}}. Giải nghĩa: Quyết định theo dữ liệu điều khiển.
Max Results	`max_results`	string	`20`	Chức năng: Số vị trí khớp tối đa được trả về. Giới hạn để tránh trả về hàng trăm kết quả khi ảnh mẫu quá phổ biến. Bạn có thể để trống nếu không cần dùng. Ví dụ 1: 1. Giải nghĩa: Chỉ cần vị trí khớp đầu tiên. Ví dụ 2: 20. Giải nghĩa: Mặc định, đủ để lặp qua một danh sách vừa phải. Ví dụ 3: 100. Giải nghĩa: Quét rộng khi cần đếm toàn bộ mục trên trang.

🚩 = bắt buộc. Ô rỗng của tham số tùy chọn sẽ bị loại khỏi payload.inputs — Client tự áp default.

Payload MQTT gửi đi

{
  "version": "great-lotus-pyauto-v1",
  "action": {
    "key": "image.image_search",
    "group": "ImageAction",
    "function": "image_search"
  },
  "inputs": {
    "image_input": {
      "type": "string",
      "value": ""
    },
    "confidence": {
      "type": "string",
      "value": 0.9
    },
    "workflow": {
      "type": "string",
      "value": "workflow"
    },
    "full_page": {
      "type": "boolean",
      "value": false
    },
    "max_results": {
      "type": "string",
      "value": 20
    }
  },
  "meta": {
    "requestId": "<16 hex>",
    "requestTopic": "WP2_PC176",
    "responseTopic": "RES_WP2_PC176",
    "waitForResponse": true,
    "responseTimeoutSec": 60
  }
}

Publish lên topic bạn nhập ở ô Topic; nếu bật Wait For Response, node chờ Client trả lời trên RES_<topic> với đúng meta.requestId. return: "NG" ⇒ node ném lỗi.

Sinh tự động bởi tools/gen_doc_html.js từ ACTION_SPECS (package n8n-nodes-c12_pyautogui_web@0.1.34) · 2026-07-22 · Đừng sửa tay file này — sửa _notes/ hoặc source rồi chạy lại npm run doc:build.