{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ru/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Быстрый старт: создание шаблона"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"быстрый-старт-создание-шаблона","__idx":0},"children":["Быстрый старт: создание шаблона"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["В этом примере сохраняется шаблон, который открывает URL, переданный при запуске, и возвращает итоговый адрес с учётом перенаправлений. Выполняйте фрагменты по порядку в одном сеансе Bash в macOS или Linux; в Windows используйте WSL. Понадобятся настольный клиент MoreLogin V2.73.0 или новее, curl 7.76 или новее, jq и uuidgen. Не удаляйте созданные файлы: они нужны для ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/browser-rpa/run-api-example"},"children":["примера запуска"]}," и ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/browser-rpa/local-api#%D0%B2%D0%BE%D1%81%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5"},"children":["восстановления запросов"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1-запросите-возможности-и-контракты","__idx":1},"children":["1. Запросите возможности и контракты"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Укажите порт Local API, который показан в клиенте MoreLogin. Команды выполняются в закрытом временном каталоге, потому что реальные ответы с шаблонами и запусками могут содержать конфиденциальные значения."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"umask 077\nRPA_BASE_URL='http://127.0.0.1:40000/api/rpa/browser/v1'\nRPA_DIR=\"$(mktemp -d)\" && cd \"$RPA_DIR\"\nrpa_curl() {\n  curl --fail-with-body -sS --max-time 30 \"$@\"\n}\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Если вы включили аутентификацию Local API, добавьте в команду ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["curl"]}," внутри ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rpa_curl"]}," заголовок ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]},", описанный в разделе ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/api-reference/getting-started/authentication"},"children":["Аутентификация"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Убедитесь, что клиент поддерживает операции из этого примера, и запишите ревизию каталога. Запросы на запись передают её обратно в заголовке ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-RPA-Catalog-Revision"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"rpa_curl \"$RPA_BASE_URL/capabilities\" -o capabilities.json &&\njq '.data | {operations, limits, docs}' capabilities.json &&\njq -e '.data.operations as $ops | [\"listNodeTypes\",\"getNodeType\",\"validateWorkflow\",\"createTemplate\"] - $ops | length == 0' capabilities.json &&\nRPA_CATALOG_REVISION=\"$(jq -er '.data.catalogRevision' capabilities.json)\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Прочитайте контракты четырёх типов узлов из примера. Последняя команда завершается успешно, только если каждый контракт разрешает использование в шаблонах, поддерживается во время выполнения, допускает запуск через API и полностью задокументирован. Каждое поле контракта описано на странице ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/browser-rpa/node-contract-guide"},"children":["Общие поля и структура сценария"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"rpa_curl --get \"$RPA_BASE_URL/node-types\" --data-urlencode 'q=gotoUrl' -o node-types.json &&\nrpa_curl \"$RPA_BASE_URL/node-types/start\" -o start.contract.json &&\nrpa_curl \"$RPA_BASE_URL/node-types/end\" -o end.contract.json &&\nrpa_curl \"$RPA_BASE_URL/node-types/browser_gotoUrl\" -o browser_gotoUrl.contract.json &&\nrpa_curl \"$RPA_BASE_URL/node-types/browser_getUrl\" -o browser_getUrl.contract.json &&\njq -s -e 'all(.[]; .data | .authorable and .runtimeSupported and .externalRunnable and .documentationComplete)' *.contract.json\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"idea"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["AI-агенты могут начать с локальных руководств: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rpa_curl \"$RPA_BASE_URL/llms.txt\""]}," выводит ссылки на Skill (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/docs/SKILL.md"]},") и руководство по API. Пути, которые начинаются с ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/"]},", разрешаются относительно ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["http://127.0.0.1:<port>"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2-проверьте-шаблон-кандидат-целиком","__idx":2},"children":["2. Проверьте шаблон-кандидат целиком"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Сохраните следующее тело запроса в файл ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create.json"]},". Дайте каждому узлу название, которое описывает, что он делает. Узел ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end"]}," возвращает свой ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}," как ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["outputs.result"]}," запуска; здесь сообщение берётся из выходного значения ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.value"]}," узла ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url_result"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"title\": \"Return the final page URL\",\n  \"description\": \"Visit the supplied page and return its final URL\",\n  \"workflow\": {\n    \"editorVersion\": 2,\n    \"editorParametersVersion\": 1,\n    \"variables\": {\n      \"type\": \"object\",\n      \"properties\": {\n        \"targetUrl\": {\n          \"type\": \"string\",\n          \"description\": \"Absolute HTTP(S) URL to open\"\n        }\n      },\n      \"required\": [\n        \"targetUrl\"\n      ]\n    },\n    \"nodes\": [\n      {\n        \"id\": \"start\",\n        \"type\": \"start\",\n        \"data\": {\n          \"title\": \"Read the target URL parameter\"\n        }\n      },\n      {\n        \"id\": \"visit\",\n        \"type\": \"browser_gotoUrl\",\n        \"data\": {\n          \"browserAction\": \"gotoUrl\",\n          \"browserUi\": {\n            \"inputs\": {\n              \"url\": \"${targetUrl}\",\n              \"postWaitMs\": 0\n            },\n            \"exception\": {\n              \"timeout\": 30000,\n              \"policy\": \"interrupt\"\n            }\n          },\n          \"title\": \"Open the supplied page\"\n        }\n      },\n      {\n        \"id\": \"url_result\",\n        \"type\": \"browser_getUrl\",\n        \"data\": {\n          \"browserAction\": \"getUrl\",\n          \"browserUi\": {\n            \"inputs\": {\n              \"type\": \"href\"\n            },\n            \"exception\": {\n              \"timeout\": 30000,\n              \"policy\": \"interrupt\"\n            }\n          },\n          \"title\": \"Read the final URL after navigation\"\n        }\n      },\n      {\n        \"id\": \"end\",\n        \"type\": \"end\",\n        \"data\": {\n          \"inputsValues\": {\n            \"status\": {\n              \"type\": \"constant\",\n              \"content\": \"success\"\n            },\n            \"message\": {\n              \"type\": \"ref\",\n              \"content\": [\n                \"url_result\",\n                \"data\",\n                \"value\"\n              ]\n            }\n          },\n          \"title\": \"Report the final page URL\"\n        }\n      }\n    ]\n  },\n  \"dependencies\": []\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"jq '{purpose:\"save\",source:{kind:\"inline\",template:.}}' create.json > validate-save.json &&\nrpa_curl \"$RPA_BASE_URL/validations\" -H 'Content-Type: application/json' \\\n  --data-binary @validate-save.json -o validation-save.json &&\njq '.data | {valid,issues,truncated,runtimeChecks}' validation-save.json &&\njq -e '.data.valid == true and .data.truncated == false' validation-save.json\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Изучите отчёт о проверке, включая предупреждения и проверки времени выполнения. Продолжайте, только если ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["valid"]}," равно ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," и отчёт не усечён. Проверка не открывает браузер."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"3-сохраните-шаблон-и-запишите-версию","__idx":3},"children":["3. Сохраните шаблон и запишите версию"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"([ -s create.key ] || uuidgen > create.key) &&\nrpa_curl \"$RPA_BASE_URL/templates\" -H 'Content-Type: application/json' \\\n  -H \"X-RPA-Catalog-Revision: $RPA_CATALOG_REVISION\" \\\n  -H \"Idempotency-Key: $(cat create.key)\" \\\n  --data-binary @create.json -D created.headers -o created.json &&\nhead -n 1 created.headers &&\njq '.data | {id,version,revisionId,warnings}' created.json\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["HTTP 201 означает, что шаблон сохранён. Сохраните нормализованный ответ, в котором есть сценарий, ID, версия и ID ревизии, а также ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ETag"]}," из ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["created.headers"]},". Ключ в ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create.key"]}," идентифицирует это намерение записи: используйте его снова только при повторе того же запроса, а для новой записи генерируйте новый ключ. Если запрос завершится по тайм-ауту, выполните ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/browser-rpa/local-api#%D0%B2%D0%BE%D1%81%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5"},"children":["восстановление запроса"]},", прежде чем отправлять новый запрос на запись."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["После обновления списка шаблонов шаблон также появится в разделе ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Пользовательские шаблоны"]}," настольного клиента. Чтобы изменить его позже, прочитайте последнюю версию, проверьте полный шаблон-кандидат с ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["source.base"]}," и отправьте правку с текущим ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["If-Match"]},". См. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/browser-rpa/local-api#%D0%B8%D0%B7%D0%BC%D0%B5%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5-%D1%81%D1%83%D1%89%D0%B5%D1%81%D1%82%D0%B2%D1%83%D1%8E%D1%89%D0%B5%D0%B3%D0%BE-%D1%88%D0%B0%D0%B1%D0%BB%D0%BE%D0%BD%D0%B0"},"children":["Изменение существующего шаблона"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Далее: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/browser-rpa/run-api-example"},"children":["запустите сохранённый шаблон через API"]},"."]}]},"headings":[{"value":"Быстрый старт: создание шаблона","id":"быстрый-старт-создание-шаблона","depth":1},{"value":"1. Запросите возможности и контракты","id":"1-запросите-возможности-и-контракты","depth":2},{"value":"2. Проверьте шаблон-кандидат целиком","id":"2-проверьте-шаблон-кандидат-целиком","depth":2},{"value":"3. Сохраните шаблон и запишите версию","id":"3-сохраните-шаблон-и-запишите-версию","depth":2}],"frontmatter":{"seo":{"title":"Быстрый старт: создание шаблона"}},"lastModified":"2026-11-20T14:40:39.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ru/browser-rpa/quickstart","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}