# RPA trình duyệt

RPA trình duyệt tự động hóa các tác vụ lặp lại trong một hồ sơ trình duyệt Chromium cục bộ: mở trang, tương tác với phần tử, đọc kết quả và điều khiển luồng thực thi bằng điều kiện và vòng lặp. Bạn xây dựng quy trình dưới dạng một mẫu, lưu mẫu vào tài khoản MoreLogin của bạn, rồi chạy mẫu trên một hồ sơ trình duyệt, trong ứng dụng máy tính hoặc qua Local API của RPA trình duyệt.

Phần này dành cho nhà phát triển và tác nhân AI cần tạo và chạy mẫu bằng mã. Để tự động hóa điện thoại đám mây Android, hãy xem [RPA điện thoại đám mây](/vi/rparobotic-process-automation/01-overview/01-rpa-introduction).

## Yêu cầu

- Ứng dụng MoreLogin trên máy tính phiên bản V2.73.0 trở lên đang chạy và đã đăng nhập. Mẫu được lưu trong tài khoản đang đăng nhập và xuất hiện trong mục **Mẫu tùy chỉnh** của ứng dụng.
- Có thể truy cập Local API tại `http://127.0.0.1:<port>/api/rpa/browser/v1`. Hãy dùng cổng Local API hiển thị trong phần cài đặt của ứng dụng; cổng mặc định là `40000`.
- Cơ chế xác thực truy cập giống như ở các phần khác của Local API. Xem [Xác thực](/vi/api-reference/getting-started/authentication).
- Lượt chạy cần một hồ sơ trình duyệt Chromium (`browserTypeId: 1`).
- `GET /capabilities` trả về các thao tác, giới hạn và URL tài liệu mà ứng dụng và tài khoản của bạn có thể dùng. Hãy kiểm tra endpoint này trước khi xây dựng mẫu.


## Khái niệm chính

| Khái niệm | Ý nghĩa |
|  --- | --- |
| Mẫu | Một quy trình đã lưu, kèm tiêu đề, mô tả và các phụ thuộc vào mẫu con. Mỗi lần lưu sẽ tạo một phiên bản mới. |
| Quy trình | Cây nút có thứ tự trong một mẫu. Quy trình bắt đầu bằng một nút `start` và kết thúc bằng một nút `end`. |
| Nút | Một bước, chẳng hạn mở URL hoặc nhấp vào phần tử. Mỗi loại nút có một hợp đồng xác định đầu vào và đầu ra của loại nút đó. |
| Môi trường | Hồ sơ trình duyệt mà một lượt chạy sử dụng. `environmentId` là `envId` của hồ sơ trong [Local API trình duyệt](/vi/api-reference/browser/local-api). |
| Lượt chạy | Một lần thực thi một phiên bản mẫu đã lưu trên một môi trường. Lượt chạy có các bản ghi thực thi nút và tạo phẩm. |
| Biên nhận yêu cầu | Kết quả đã lưu của một yêu cầu ghi được gửi kèm `Idempotency-Key`. Dùng biên nhận này để biết điều gì đã xảy ra sau khi hết thời gian chờ. |


## Khác biệt giữa API này và các endpoint Local API khác

Các endpoint của RPA trình duyệt không dùng định dạng `{code, msg, data}` được mô tả trong [Định dạng phản hồi chung](/vi/api-reference/getting-started/response-format).

- Các endpoint này trả về mã trạng thái HTTP thực, chẳng hạn 201, 202, 409, 412, 422, 429 và 503.
- Phần thân phản hồi thành công là `{data, meta}` và phần thân phản hồi lỗi là `{error, meta}`. Mã lỗi là chuỗi, chẳng hạn `RPA_VALIDATION_FAILED`; xem [Mã lỗi](/vi/browser-rpa/api/error-codes).
- Yêu cầu ghi dùng các header `Idempotency-Key`, `If-Match` và `X-RPA-Catalog-Revision`. Xem [Header bắt buộc cho yêu cầu ghi](/vi/browser-rpa/local-api#header-b%E1%BA%AFt-bu%E1%BB%99c-cho-y%C3%AAu-c%E1%BA%A7u-ghi).
- Lỗi xác thực truy cập dùng định dạng 401 tiêu chuẩn của Local API.


## Bắt đầu

1. [Bắt đầu nhanh](/vi/browser-rpa/quickstart): Khám phá khả năng và hợp đồng nút, sau đó xác thực và lưu một mẫu trả về URL cuối cùng của trang.
2. [Chạy mẫu bằng API](/vi/browser-rpa/run-api-example): Kiểm tra trước phiên bản đã lưu, bắt đầu một lượt chạy và đọc kết quả.
3. [Trường chung và cấu trúc quy trình](/vi/browser-rpa/node-contract-guide): Tìm hiểu bố cục quy trình, tham chiếu, thời gian chờ và cơ chế thử lại.
4. [Danh mục nút](/vi/browser-rpa/nodes): Tra cứu đầu vào, giá trị mặc định, tham chiếu và đầu ra của từng nút.
5. [Tham chiếu Local API](/vi/browser-rpa/local-api): Tìm mọi endpoint, các header mà yêu cầu ghi cần, và cách khôi phục sau khi hết thời gian chờ hoặc xung đột phiên bản.


Để chạy mẫu thủ công, hãy xem [Chạy mẫu trong ứng dụng máy tính](/vi/browser-rpa/run).