# クイックスタート：テンプレートを作成する

この例では、実行時に渡された URL を開き、リダイレクトがあればリダイレクト後の最終的なアドレスを返すテンプレートを保存します。スニペットは、macOS または Linux の 1 つの Bash セッションで順番に実行してください。Windows では WSL を使用します。MoreLogin デスクトップクライアント V2.73.0 以降、curl 7.76 以降、jq、uuidgen が必要です。生成されたファイルは削除せずに残しておいてください。[実行の例](/ja/browser-rpa/run-api-example)と[リクエストのリカバリー](/ja/browser-rpa/local-api#%E3%83%AA%E3%82%AB%E3%83%90%E3%83%AA%E3%83%BC)で使用します。

## 1. 機能と契約を確認する

ポートは、MoreLogin クライアントに表示される Local API のポートに合わせてください。実際のテンプレートや実行のレスポンスには機密性の高い値が含まれることがあるため、コマンドは非公開の一時ディレクトリで実行します。

```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 の認証を有効にしている場合は、[認証](/ja/api-reference/getting-started/authentication)で説明している `Authorization` ヘッダーを、`rpa_curl` 内の `curl` コマンドに追加してください。

この例で使用する操作をクライアントがサポートしていることを確認し、カタログリビジョンを記録します。書き込みリクエストでは、この値を `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)"
```

この例で使用する 4 つのノードタイプの契約を読み取ります。最後のコマンドは、すべての契約が作成可能で、ランタイムでサポートされ、API から実行でき、ドキュメントが完備している場合にのみ成功します。契約の各フィールドについては、[共通フィールドとワークフロー構造](/ja/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
```

AI エージェントは、ローカルのガイドから始めることができます。`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` として返します。この例の message は、`url_result` ノードの出力 `data.value` です。

```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 は、テンプレートが保存されたことを示します。ワークフロー、ID、バージョン、リビジョン ID を含む正規化されたレスポンスと、`created.headers` 内の `ETag` を保持しておいてください。`create.key` のキーは、この書き込みの意図を識別します。このキーは同じリクエストを再試行するときにだけ再利用し、新しい書き込みには新しいキーを生成してください。リクエストがタイムアウトした場合は、別の書き込みを送信する前に[リクエストのリカバリー](/ja/browser-rpa/local-api#%E3%83%AA%E3%82%AB%E3%83%90%E3%83%AA%E3%83%BC)の手順に従ってください。

テンプレート一覧が更新されると、このテンプレートはデスクトップクライアントの**カスタムテンプレート**にも表示されます。後で変更する場合は、最新バージョンを読み取り、`source.base` を指定して完全な候補を検証してから、現在の `If-Match` を付けて編集を送信します。[既存のテンプレートを編集する](/ja/browser-rpa/local-api#%E6%97%A2%E5%AD%98%E3%81%AE%E3%83%86%E3%83%B3%E3%83%97%E3%83%AC%E3%83%BC%E3%83%88%E3%82%92%E7%B7%A8%E9%9B%86%E3%81%99%E3%82%8B)を参照してください。

次は、[保存したテンプレートを API で実行](/ja/browser-rpa/run-api-example)します。