# Швидкий старт: створення шаблону

У цьому прикладі зберігається шаблон, який відкриває URL, переданий під час запуску, і повертає кінцеву адресу з урахуванням можливих переспрямувань. Виконуйте фрагменти по черзі в одному сеансі Bash у macOS або Linux; у Windows використовуйте WSL. Потрібні настільний клієнт MoreLogin V2.73.0 або новіший, curl 7.76 або новіший, jq і uuidgen. Збережіть згенеровані файли: їх використовують [приклад запуску](/uk/browser-rpa/run-api-example) і [відновлення запитів](/uk/browser-rpa/local-api#%D0%B2%D1%96%D0%B4%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F).

## 1. Отримайте можливості та контракти

Укажіть порт Local API, який показано в клієнті MoreLogin. Команди працюють у приватному тимчасовому каталозі, оскільки реальні відповіді для шаблонів і запусків можуть містити конфіденційні значення.

```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 "$@"
}
```

Якщо ви ввімкнули автентифікацію Local API, додайте до команди `curl` у `rpa_curl` заголовок `Authorization`, описаний у розділі [Автентифікація](/uk/api-reference/getting-started/authentication).

Переконайтеся, що клієнт підтримує операції, які використовує цей приклад, і запишіть ревізію каталогу. Запити на запис надсилають її назад у заголовку `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)"
```

Прочитайте контракти чотирьох типів вузлів із прикладу. Остання команда виконується успішно, лише якщо кожен контракт придатний для створення сценаріїв, підтримується під час виконання, доступний для запуску через API і повністю задокументований. Кожне поле контракту пояснено на сторінці [Спільні поля та структура сценарію](/uk/browser-rpa/node-contract-guide).

```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
```

ШІ-агенти можуть почати з локальних посібників: `rpa_curl "$RPA_BASE_URL/llms.txt"` перелічує Skill (`/docs/SKILL.md`) і посібник з API. Шляхи, що починаються з `/`, задаються відносно `http://127.0.0.1:<port>`.

## 2. Перевірте повний шаблон-кандидат

Збережіть наведене нижче тіло запиту як `create.json`. Дайте кожному вузлу назву, яка описує, що він робить. Вузол `end` повертає своє значення `message` як `outputs.result` запуску; тут повідомленням є вихід `data.value` вузла `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
```

Прочитайте звіт перевірки, зокрема попередження та перевірки середовища виконання. Продовжуйте, лише коли `valid` має значення `true`, а звіт не обрізано. Перевірка не відкриває браузер.

## 3. Збережіть шаблон і запишіть версію

```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 означає, що шаблон збережено. Збережіть нормалізовану відповідь, яка містить сценарій, ідентифікатор, версію та ідентифікатор ревізії, а також `ETag` з `created.headers`. Ключ у `create.key` ідентифікує цей намір запису: використовуйте його повторно лише для повтору того самого запиту, а для нового запису згенеруйте новий ключ. Якщо запит завершиться тайм-аутом, скористайтеся [відновленням запитів](/uk/browser-rpa/local-api#%D0%B2%D1%96%D0%B4%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F), перш ніж надсилати інший запит на запис.

Після оновлення списку шаблонів шаблон також з'явиться в настільному клієнті в розділі **Власні шаблони**. Щоб пізніше змінити шаблон, прочитайте його останню версію, перевірте повний шаблон-кандидат із `source.base` і надішліть зміну з поточним `If-Match`. Див. [Редагування наявного шаблону](/uk/browser-rpa/local-api#%D1%80%D0%B5%D0%B4%D0%B0%D0%B3%D1%83%D0%B2%D0%B0%D0%BD%D0%BD%D1%8F-%D0%BD%D0%B0%D1%8F%D0%B2%D0%BD%D0%BE%D0%B3%D0%BE-%D1%88%D0%B0%D0%B1%D0%BB%D0%BE%D0%BD%D1%83).

Далі: [запустіть збережений шаблон через API](/uk/browser-rpa/run-api-example).