# Início rápido: criar um modelo

Este exemplo salva um modelo que abre uma URL informada no momento da execução e retorna o endereço final, incluindo qualquer redirecionamento. Execute os trechos na ordem, em uma única sessão do Bash no macOS ou no Linux; no Windows, use o WSL. Você precisa do cliente desktop MoreLogin V2.73.0 ou posterior, do curl 7.76 ou posterior, do jq e do uuidgen. Guarde os arquivos gerados, porque o [exemplo de execução](/pt/browser-rpa/run-api-example) e a [recuperação de solicitações](/pt/browser-rpa/local-api#recupera%C3%A7%C3%A3o) usam esses arquivos.

## 1. Consultar recursos e contratos

Use a porta da Local API exibida no cliente MoreLogin. Os comandos são executados em um diretório temporário privado, porque as respostas reais de modelos e execuções podem conter valores sensíveis.

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

Se você ativou a autenticação da Local API, adicione o cabeçalho `Authorization` descrito em [Autenticação](/pt/api-reference/getting-started/authentication) ao comando `curl` em `rpa_curl`.

Verifique se o cliente oferece suporte às operações usadas neste exemplo e registre a revisão do catálogo. As solicitações de gravação enviam esse valor de volta no cabeçalho `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)"
```

Leia os contratos dos quatro tipos de nó usados no exemplo. O último comando só é bem-sucedido se todos os contratos puderem ser usados na criação de modelos, tiverem suporte em tempo de execução, puderem ser executados pela API e estiverem totalmente documentados. [Campos comuns e estrutura do fluxo](/pt/browser-rpa/node-contract-guide) explica cada campo do contrato.

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

Agentes de IA podem começar pelos guias locais: `rpa_curl "$RPA_BASE_URL/llms.txt"` lista a Skill (`/docs/SKILL.md`) e o guia da API. Os caminhos que começam com `/` são resolvidos em relação a `http://127.0.0.1:<port>`.

## 2. Validar o candidato completo

Salve o corpo a seguir como `create.json`. Dê a cada nó um título que descreva o que ele faz. O nó `end` retorna sua `message` como o `outputs.result` da execução; aqui, a mensagem é a saída `data.value` do nó `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
```

Leia o relatório de validação, incluindo os avisos e as verificações de tempo de execução. Continue somente quando `valid` for `true` e o relatório não estiver truncado. A validação não abre nenhum navegador.

## 3. Salvar o modelo e registrar a versão

```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 significa que o modelo foi salvo. Guarde a resposta normalizada, que inclui o fluxo, o ID, a versão e o ID da revisão, e também o `ETag` em `created.headers`. A chave em `create.key` identifica esta intenção de gravação: reutilize-a apenas para repetir a mesma solicitação e gere uma nova chave para uma nova gravação. Se a solicitação exceder o tempo limite, siga a [recuperação de solicitações](/pt/browser-rpa/local-api#recupera%C3%A7%C3%A3o) antes de enviar outra gravação.

Depois que a lista de modelos for atualizada, o modelo também aparecerá em **Modelos Personalizados** no cliente desktop. Para alterá-lo mais tarde, leia a versão mais recente, valide o candidato completo com `source.base` e envie a edição com o `If-Match` atual. Consulte [Editar um modelo existente](/pt/browser-rpa/local-api#editar-um-modelo-existente).

Próximo passo: [executar o modelo salvo com a API](/pt/browser-rpa/run-api-example).