# Bắt đầu nhanh: tạo mẫu

Ví dụ này lưu một mẫu mở URL được truyền vào lúc chạy và trả về địa chỉ cuối cùng sau mọi lần chuyển hướng. Hãy chạy các đoạn mã theo thứ tự trong cùng một phiên Bash trên macOS hoặc Linux; trên Windows, hãy dùng WSL. Bạn cần ứng dụng MoreLogin trên máy tính phiên bản V2.73.0 trở lên, curl 7.76 trở lên, jq và uuidgen. Hãy giữ lại các tệp được tạo ra, vì [ví dụ chạy mẫu](/vi/browser-rpa/run-api-example) và [khôi phục yêu cầu](/vi/browser-rpa/local-api#kh%C3%B4i-ph%E1%BB%A5c) sẽ dùng chúng.

## 1. Khám phá khả năng và hợp đồng

Đặt cổng thành cổng Local API hiển thị trong ứng dụng MoreLogin. Các lệnh được chạy trong một thư mục tạm riêng tư, vì phản hồi thực tế của mẫu và lượt chạy có thể chứa giá trị nhạy cảm.

```bash
umask 077
RPA_BASE_URL='http://127.0.0.1:40000/api/rpa/browser/v1'
RPA_DIR="$(mktemp -d)" && cd "$RPA_DIR"
rpa_curl() {
  curl --fail-with-body -sS --max-time 30 "$@"
}
```

Nếu bạn đã bật xác thực Local API, hãy thêm header `Authorization` được mô tả trong [Xác thực](/vi/api-reference/getting-started/authentication) vào lệnh `curl` trong `rpa_curl`.

Kiểm tra xem ứng dụng có hỗ trợ các thao tác mà ví dụ này dùng hay không, rồi ghi lại bản sửa đổi danh mục. Các yêu cầu ghi sẽ gửi lại giá trị này trong header `X-RPA-Catalog-Revision`.

```bash
rpa_curl "$RPA_BASE_URL/capabilities" -o capabilities.json &&
jq '.data | {operations, limits, docs}' capabilities.json &&
jq -e '.data.operations as $ops | ["listNodeTypes","getNodeType","validateWorkflow","createTemplate"] - $ops | length == 0' capabilities.json &&
RPA_CATALOG_REVISION="$(jq -er '.data.catalogRevision' capabilities.json)"
```

Đọc hợp đồng của bốn loại nút trong ví dụ. Lệnh cuối cùng chỉ thành công khi mọi hợp đồng đều có thể soạn thảo, được hỗ trợ khi chạy, có thể chạy qua API và có tài liệu đầy đủ. [Trường chung và cấu trúc quy trình](/vi/browser-rpa/node-contract-guide) giải thích từng trường của hợp đồng.

```bash
rpa_curl --get "$RPA_BASE_URL/node-types" --data-urlencode 'q=gotoUrl' -o node-types.json &&
rpa_curl "$RPA_BASE_URL/node-types/start" -o start.contract.json &&
rpa_curl "$RPA_BASE_URL/node-types/end" -o end.contract.json &&
rpa_curl "$RPA_BASE_URL/node-types/browser_gotoUrl" -o browser_gotoUrl.contract.json &&
rpa_curl "$RPA_BASE_URL/node-types/browser_getUrl" -o browser_getUrl.contract.json &&
jq -s -e 'all(.[]; .data | .authorable and .runtimeSupported and .externalRunnable and .documentationComplete)' *.contract.json
```

Tác nhân AI có thể bắt đầu từ các hướng dẫn cục bộ: `rpa_curl "$RPA_BASE_URL/llms.txt"` liệt kê Skill (`/docs/SKILL.md`) và hướng dẫn API. Các đường dẫn bắt đầu bằng `/` được phân giải theo `http://127.0.0.1:<port>`.

## 2. Xác thực toàn bộ bản đề xuất

Lưu phần thân sau thành `create.json`. Đặt cho mỗi nút một tiêu đề mô tả việc nút đó làm. Nút `end` trả về `message` của nó dưới dạng `outputs.result` của lượt chạy; ở đây, message này là đầu ra `data.value` của nút `url_result`.

```json
{
  "title": "Return the final page URL",
  "description": "Visit the supplied page and return its final URL",
  "workflow": {
    "editorVersion": 2,
    "editorParametersVersion": 1,
    "variables": {
      "type": "object",
      "properties": {
        "targetUrl": {
          "type": "string",
          "description": "Absolute HTTP(S) URL to open"
        }
      },
      "required": [
        "targetUrl"
      ]
    },
    "nodes": [
      {
        "id": "start",
        "type": "start",
        "data": {
          "title": "Read the target URL parameter"
        }
      },
      {
        "id": "visit",
        "type": "browser_gotoUrl",
        "data": {
          "browserAction": "gotoUrl",
          "browserUi": {
            "inputs": {
              "url": "${targetUrl}",
              "postWaitMs": 0
            },
            "exception": {
              "timeout": 30000,
              "policy": "interrupt"
            }
          },
          "title": "Open the supplied page"
        }
      },
      {
        "id": "url_result",
        "type": "browser_getUrl",
        "data": {
          "browserAction": "getUrl",
          "browserUi": {
            "inputs": {
              "type": "href"
            },
            "exception": {
              "timeout": 30000,
              "policy": "interrupt"
            }
          },
          "title": "Read the final URL after navigation"
        }
      },
      {
        "id": "end",
        "type": "end",
        "data": {
          "inputsValues": {
            "status": {
              "type": "constant",
              "content": "success"
            },
            "message": {
              "type": "ref",
              "content": [
                "url_result",
                "data",
                "value"
              ]
            }
          },
          "title": "Report the final page URL"
        }
      }
    ]
  },
  "dependencies": []
}
```

```bash
jq '{purpose:"save",source:{kind:"inline",template:.}}' create.json > validate-save.json &&
rpa_curl "$RPA_BASE_URL/validations" -H 'Content-Type: application/json' \
  --data-binary @validate-save.json -o validation-save.json &&
jq '.data | {valid,issues,truncated,runtimeChecks}' validation-save.json &&
jq -e '.data.valid == true and .data.truncated == false' validation-save.json
```

Đọc báo cáo xác thực, bao gồm cả cảnh báo và các kiểm tra khi chạy. Chỉ tiếp tục khi `valid` là `true` và báo cáo không bị cắt bớt. Bước xác thực không mở trình duyệt.

## 3. Lưu mẫu và ghi lại phiên bản

```bash
([ -s create.key ] || uuidgen > create.key) &&
rpa_curl "$RPA_BASE_URL/templates" -H 'Content-Type: application/json' \
  -H "X-RPA-Catalog-Revision: $RPA_CATALOG_REVISION" \
  -H "Idempotency-Key: $(cat create.key)" \
  --data-binary @create.json -D created.headers -o created.json &&
head -n 1 created.headers &&
jq '.data | {id,version,revisionId,warnings}' created.json
```

HTTP 201 nghĩa là mẫu đã được lưu. Hãy giữ lại phản hồi đã chuẩn hóa, gồm quy trình, ID, phiên bản và ID bản sửa đổi, cùng với `ETag` trong `created.headers`. Khóa trong `create.key` định danh ý định ghi này: chỉ dùng lại khóa này để thử lại đúng yêu cầu đó, và tạo khóa mới cho mỗi lần ghi mới. Nếu yêu cầu hết thời gian chờ, hãy làm theo [khôi phục yêu cầu](/vi/browser-rpa/local-api#kh%C3%B4i-ph%E1%BB%A5c) trước khi gửi một yêu cầu ghi khác.

Sau khi danh sách mẫu được làm mới, mẫu cũng xuất hiện trong mục **Mẫu tùy chỉnh** của ứng dụng máy tính. Để thay đổi mẫu sau này, hãy đọc phiên bản mới nhất của mẫu, xác thực bản đề xuất hoàn chỉnh với `source.base`, rồi gửi chỉnh sửa kèm `If-Match` hiện tại của mẫu. Xem [Chỉnh sửa mẫu hiện có](/vi/browser-rpa/local-api#ch%E1%BB%89nh-s%E1%BB%ADa-m%E1%BA%ABu-hi%E1%BB%87n-c%C3%B3).

Tiếp theo: [chạy mẫu đã lưu bằng API](/vi/browser-rpa/run-api-example).