オンボーディングガイド

AIエージェントの登録（サンドボックスとブラウザ）

SeekBytes の組織が必要な自動エージェント、またはエージェントを動かす運用者向けです。

最終確認日: 2026年10月23日（公開サイトと登録の取り決め）。

組織を作る方法は二つあります。経路Aは、人による確認も確認メールもないサンドボックス登録です。経路Bは、人がメールボックスを開けるときの人による登録ページです。

最初に読むもの

/robots.txt. 公開ページは取得できます。/api/、/*/Auth/、/swagger はクロール対象ではありません。文書化された登録 API を呼ぶこと、またはこの手順を終えるために登録ページを開くことは認められています。
/llms.txt. これはサイトの索引です。ページのアドレスに .md を付けると、そのページの Markdown 版を取得できます。
/.well-known/agent-register.json. このファイルは、二つの登録経路、API のアドレス、必要なヘッダー、メールまたは人による確認が必要かどうかを示します。

このページとそのファイルが食い違うときは、ヘッダー名、API のアドレス、メールまたは人による確認が必要かどうかはファイルに従ってください。

経路A: サンドボックス登録

エージェントが自分でリクエストを送れ、メールボックスを持たないときにこの経路を使います。Cloudflare の確認も確認メールもありません。

HTML フォームは、このアドレスのアカウント作成ページです。 /ja/Auth/AgentRegister

フォームはアカウント作成のように見えます。人による確認のウィジェットは出ません。組織、名、姓、メール、パスワード、パスワード確認を入力します。

パスワードは12文字以上で、大文字、小文字、数字、記号を含めてください。実際のパスワードは公開しないでください。

同じ登録を API に直接送れます。例のようにヘッダーと JSON 本文を送ります。例のアドレスとパスワードは自分のものに置き換えてください。

必要なヘッダー:

POST /api/Auth/register-agent-tenant
X-SeekBytes-Agent-Register: 1
Content-Type: application/json

{
  "tenancyName": "examplecompany",
  "name": "Example Company",
  "adminEmailAddress": "agent@example.com",
  "adminPassword": "<your-password>",
  "adminFirstName": "Agent",
  "adminLastName": "Operator",
  "isAgent": true
}

tenancyName は、空白を除いて小文字にした組織名です。Example Company は examplecompany になります。isAgent は true でなければなりません。

HTML フォームはサインインページに戻り、バナーは次です: Registration successful! You can sign in now. API の応答は次です: You're all set — we created your organization. You can sign in now.

メールアドレスはすでに確認済みです。SeekBytes はこの経路では確認、歓迎、営業のメッセージを送りません。

これでサンドボックス組織が作られます。管理アプリにサインインでき、既定の顧客ディレクトリとは分けて保たれます。

この経路では Skill Engine のドメイン準備は実行されません。顧客と同じ Skill Engine の準備が必要なときは経路Bを使います。

ヘッダーがないリクエスト、または isAgent が false のリクエストは拒否され、組織は作られません。

API がエージェント組織の登録は無効だと答えた場合は、人による登録ページを使うか SeekBytes に連絡してください。

経路B: ブラウザと人

エージェントが人のためにブラウザを操作するときは、人による登録ガイドを使います。Cloudflare の確認が成功し、メールボックスの所有者が確認リンクを開きます。その1回限りのトークンは公開しないでください。

人による登録（セルフサービス）

サインインページを開き、メールとパスワードを入力して送信します。サンドボックスのアカウントは確認メールなしでサインインできます。 /ja/Auth/Login

ブラウザはワンタイムコード付きで管理アプリへ続きます。管理アプリは読み込み完了まで少し時間がかかることがあります。ヘッダーに組織名が出た Control Tower が表示されるまで、そのページに留まってください。

チェックリスト

robots.txt、llms.txt、エージェント登録ファイルを読みます。
経路Aでは、サンドボックスのフォームを開くか、必要なヘッダーと isAgent true で API に POST します。
自分のメールと、規則を満たすパスワードを使います。パスワードは公開しないでください。
成功のバナーまたは API の成功メッセージを確認します。
経路Bでは人のガイドに従い、メールボックスの所有者から確認リンクを開きます。
サインインし、Control Tower に組織名が出るまで待ちます。

このページがまだ扱わないこと

追加サービスの依頼、API キーの作成、Skill Engine、Chat UI、Playwright Runner の呼び出しは、この隣に別のガイドとして追加します。サービス API のページは同じ節からリンクされています。

エージェント、API、連携