このページでは、エンジニアでない方がJinba Trailの最初の5分で行うことを順に説明します。アカウントを作成し、最初から用意されているサンプルオートメーションを理解し、「＋新規」ダイアログから自分のオートメーションを作成します。
「オートメーション」は、基盤となるBrowserflowエンジンがFlowと呼ぶものに対するプロダクト上の用語です。エンジンのドキュメントを読んだことがある場合は、Jinba Trailとはで両者の用語対応を確認できます。

​
1. サインアップ

サインアップページに移動し、3つのフィールドを入力します。
  • メールアドレス
  • パスワード — 8文字以上
  • 組織名 — 任意。空欄のままにすると、Jinba Trailはメールアドレスをもとに組織名を付けます（例: you@company.com's org）
アカウントを作成をクリックします。
メール確認ステップはなく、OAuth/SSOもありません。メールアドレスとパスワードでサインアップすると、そのまま利用可能なアカウントにログインします。メールアドレスとパスワードの組み合わせを登録した人は誰でもすぐに入れるため、他のアカウントと同じようにパスワードを扱い、弱いパスワードを使い回さないでください。
内部的には、サインアップは1つのアトミックな操作です。ユーザーレコードを作成し、まったく新しい組織（組織名フィールド、または上記のフォールバックから命名）を作成し、その組織にあなたをOWNERとして追加します。これらはすべて単一のリクエストで行われます。別途「あとで組織を作成する」ステップはなく、サインアップ時点では他のロールもまだ存在しません。作成した組織のオーナーは常にあなたです。
あとでサインインすると、所属している最も古い組織に解決されます。将来2つ目の組織に追加された場合（下のメールアドレスによるメンバー追加の説明を参照）でも、サインイン後に入るのは最初の組織です。

​
2. サンプルオートメーションを確認する

本当に空の組織で初めてオートメーション一覧を開くと、Jinba Trailは**get-order-status**という実際に動作するサンプルオートメーションを一度だけ投入します。これはあなたが作成したものではありません。オートメーションがどのようなものか分からないまま空の画面を見ることにならないよう、最初から用意されています。
  • これはスタブではなく、完全に公開済みで呼び出し可能なエンドポイントです。「注文IDから注文の配送状況を調べる」のようなタスクを示します。
  • シードは、組織のオートメーション一覧が空のときにだけ実行されます。シードに失敗した場合（例: 一時的なネットワーク不調）、ページには手動で再試行するためのサンプルを追加ボタンが表示されます。壊れた空の状態のまま、静かに放置されることはありません。
  • これは組織ごとに一度だけ発生します。サンプルか自分で作成したものかを問わず、少なくとも1つのオートメーションが存在した後は、あとですべて削除しても再シードされません。
自由に開いて、Build Studioで手順を確認し、よいオートメーションがどのような形になるかの参考にしてください。そのうえで、自分のオートメーションを作成します。

​
3. 自分のオートメーションを作成する

オートメーション一覧から、ヘッダーの**＋新規**をクリックします。ダイアログには次の項目があります。
1

名前

URLセーフなスラッグです。使えるのは小文字、数字、ハイフンのみです（例: get-order-status）。これはオートメーションの呼び出し可能なエンドポイントの一部になるため、組織内で一意である必要があります。重複する名前は、フィールド上のインラインエラー「この名前はすでに使われています」で拒否されます。
2

サイト（必須）

対象サイトのURLです（例: https://example.com）。これは必須です。これがないとBuild Studioがブラウザーを向ける先を持てないため、フォームとその背後のAPIはどちらも、サイトなしの送信を拒否します。
3

タスク（任意）

実行してほしい内容を自然言語で説明します。例: 「注文 ID から注文状況を確認する」。ドラフトの作成には必須ではありませんが、記録エージェントはこれを使って何をするべきかを判断します。そのため、記録を開始する前にほぼ必ず入力することになります。
4

パラメータ（任意）

型付きの入力を先に宣言します。名前、型（string、number、またはboolean）、必須かどうか、任意の例の値を指定します。ここで追加した内容は、最初のオーサリングセッションに投入されます。記録エージェントはこれらのパラメータと例の値をすぐにコンテキストとして持つため、最初の試行で推測ではなく実際のデータを適切なフィールドに入力できます。あとからBuild Studioでいつでも追加できますが、ここで入力しておくと、最初の記録で扱える具体的な材料ができます。
作成して記録をクリックします。これによりオートメーションがドラフトとして作成され、すぐに記録のためBuild Studioへ移動します。そこで記録を完了して公開するまでは、公開状態で呼び出せるものはまだありません。
名前フィールドの同じURLセーフスラッグルールと、サイトフィールドの「必須」ルールは、このダイアログだけでなくサーバー側でも検証されます。そのため、直接API呼び出しを行っても、不正な名前やサイトのないオートメーションを紛れ込ませることはできません。

​
チームメイトを追加する

組織に他の人を招待したい場合、一般的な「招待リンクを送り、相手がクリックして承認する」フローではありません。OWNERとして、相手のメールアドレスを直接入力してメンバーを追加します。メンバーシップは即座に付与され、pending/acceptedの状態も、相手がクリックするリンクもありません。そのメールアドレスのアカウントがまだ存在しない場合は、その場で作成されます。追加された人がここで確認することは何もないため、追加したことをプロダクト外で直接知らせてください。

​
次のステップ

Build Studio

新しいオートメーションを記録します。タスクを説明し、エージェントがライブブラウザーを操作する様子を確認し、レビューして公開します。

Jinba Trailとは

ホスト型プロダクトが、その基盤にあるオープンソースのBrowserflowエンジンとどのように関係しているかを説明します。