金融、マーケットプレイス、B2B ソフトウェアのサインアップフォームでは、メール以外の情報も求められます。携帯電話番号、国民 ID や税番号、本人確認用のパスポート、請求書用の VAT 番号などです。これらをテストするには、毎回それぞれの欄に何かを入力する必要があり、1 日に何十回もサインアップするコーディングエージェントが入力することもよくあります。何を入力するかが重要です。
でたらめな番号が無害ではない理由
- 電話番号は誰かにつながることがあります。 アプリがコードやウェルカムメッセージを送る場合、適当に作った番号が見知らぬ人のものかもしれません。テストを実行するたびにそうすれば、実在の人にメッセージを送ることになります。
- ランダムな数字が実在の ID であることがあります。 多くの ID 番号には短いチェックディジットがあるため、ランダムな数字でもチェックディジットが合えば、実在の人物の番号であることがよくあります。それをテスト用アカウント、ログ、スクリーンショットに保存することは、誰かの身分証番号を扱うことになります。
- エージェントは番号を作り出します。 必須の欄を通過するよう指示されると、コーディングエージェントはもっともらしい値を入力します。安全な値がなければ、もっともらしい値とは、実在するかもしれない番号のことです。
既製フィールド
Project settings → Custom fields → Add ready-made field では、プロジェクトのすべてのエージェントとテストに対して、これらの欄に Proxy Mail QA 独自の値が使われます。
| 項目 | 入力される内容 |
|---|---|
| 電話番号 | 英国(07700 900xxx)、オーストラリア(ACMA の 0491 57x xxx)、米国とカナダ(555-01xx)で架空用に確保された番号を、欄が求める形式で入力します。その他の国では、アプリ独自のテスト番号(国ごとに 1 つ)を使うか、何も入力しません。 |
| 国民 ID、個人の税番号、パスポート番号 | アカウントの国について公開されているテスト用の値、または発行されることのない形式の値を使います。国にそのような値がない場合は、ICAO の架空の国 Utopia のパスポートを使います。日本のマイナンバーや個人の税番号など、そのような値がないフィールドは空のままにし、メモを残します。または、KYC ベンダーのサンドボックス用の値を使います。 |
| VAT 番号と法人の税番号 | 同様に、実在の企業と一致することはありません。Proxy Mail QA には安全な VAT 番号がないため、VAT 番号フィールドは空のままにし、対応方法を書いたメモを残します。ただし、KYC ベンダーのサンドボックス用の値に VAT 番号がある場合は除きます。 |
| 性別、言語、役職、チームの規模、業種、サービスを知ったきっかけ | 欄の選択肢のうち 1 つを選び、同じアカウントには同じ選択肢を使います。 |
| 規約のチェックボックス | チェックを入れます。チェックがないときにフォームが表示する内容をテストする場合は、チェックを外します。 |
どのプロジェクトにも最初から電話番号のフィールドがあります。電話番号を推測で入力することはありません。このフィールドがない場合や無効な場合、電話番号の欄はテストに任せます。ID と税番号の欄は、プロジェクトのリードが既定のフィールドを追加するまで空のままです。既定のフィールドは、欄が何を求めているかを 9 つの言語で判断して対象の欄を見つけるため、「Mobile number」「Telefonnummer」「USt-IdNr.」はどれも一致します。テスト ID、name、ID でその欄を指定した独自のカスタムフィールドがあれば、そちらが優先されます。
コーディングエージェントを使う場合
エージェントは各画面の欄を MCP server の form_values に送ります。既定のフィールドで入力される欄は、欄の名前と値の出所を示すメモとともに kind: "custom" として返されます。安全な値がない欄はメモ付きの空の値として返されるため、エージェントは値を作り出さずにあなたに確認します。
{ "values": [ { "id": "mobile", "kind": "custom", "value": "07700 900736", "rule": { "id": "…", "name": "Phone number" }, "note": "A number set aside for fiction, which reaches nobody." }, { "id": "passport", "kind": "custom", "value": "U89634324", "rule": { "id": "…", "name": "Passport number" }, "note": "A shape that’s never issued, a passport of Utopia: …" } ]}架空用の番号がない国でアプリが使われる場合は、SMS プロバイダーのテスト番号をエージェントに伝え、追加するよう依頼します。電話番号の phones を指定して save_custom_field を使います。保存できるのはリードのエージェントだけで、それ以外の人のエージェントは、ロックされたプロジェクトではリードに依頼します。sign-up-form-setup の skill は、見つけた電話番号、ID、選択式の欄に既定のフィールドを提案し、あなたが同意したものだけを保存します。
テストモードで本人確認を行う場合
サインアップで ID の情報を KYC ベンダーに送る場合、そのサンドボックスには専用のテスト値が必要です。ID のフィールドの Values from を Stripe、Plaid、Onfido などのベンダーに設定するか、1 回の呼び出しだけなら kyc_sandbox を form_values に渡します。その値はテストモードではベンダーのチェックを通りますが、それ以外では通りません。field formats のページに、各国の形式と Proxy Mail QA が入力する値の一覧があります。
テストすること
- 電話番号の欄が、ユーザーが入力するどの形式(スペース、先頭の 0、国番号)でも番号を受け付けること。
- ID の欄のチェックが、チェックディジットが誤った番号を拒否し、その理由を表示すること。
- 政府のサービスを呼び出す VAT のチェックは、偽の番号が通らないため、テストではモックにすること。
- 利用規約のチェックボックスにチェックを入れずにサインアップすると、わかりやすいメッセージとともに拒否されること。
- 確認メールが届いて正しく機能すること。Proxy Mail QA がそのコードやリンクを待ちます。