英語から自動翻訳されています。

英語で読む
Proxy Mail QA

カスタムフィールド

サインアップフォームのすべてのフィールドに入力。

会社の規模や「当社を知ったきっかけ」など、フォーム独自のフィールドに何を入れるかを Proxy Mail QA に一度教えてください。チームが Proxy Mail QA for Chrome から得るのと同じ回答を、コーディングエージェントも毎回 form_values から得ます。誰も教えていないものは推測され、確認用の印が付きます。

Free プラン · プロジェクトあたり 50 個のカスタムフィールド · 既製の電話番号・ID 番号・税番号フィールド · MCP server、REST、npm、Python で form_values · Proxy Mail QA for Chrome

仕組み

一度教えるだけ。

  1. エージェントに頼む

    「サインアップフォームのカスタムフィールドを設定して」。エージェントは各画面のフィールドを form_values に送り、推測されるフィールドや空のままになるフィールドを一覧にし、あなたが同意したカスタムフィールドを保存します。

  2. ページから教える

    Proxy Mail QA for Chrome がフォームに入力した後、推測したフィールドや空のままのフィールドの横にある Teach を選び、入れる値を選んでから Save and fill を選びます。

  3. または Project settings で追加

    名前を付け、フィールドの見分け方(テスト ID、名前、またはサイトの各言語でのラベル内の語)と、入れる値を指定します。すべての言語で 1 つのページに限定するか、1 つのサイトに限定するか、どこでも使うかを選べます。

  4. すべての入力で使用

    プロジェクトのすべてのエージェント、テスト、チームメイトがそのフィールドに同じ回答を得ます。また、同じアカウントには毎回同じ回答が入ります。

コーディングエージェント向け

エージェントも同じ回答を得ます。

form_values は、ページが示す各フィールドに回答します。カスタムフィールドで決まるフィールドは kind custom で、誰も教えていないフィールドは kind guess と推測の根拠付きで返されるため、エージェントが送信前に確認します。

各フィールドに何を入れるかを尋ねる

MCP server の form_values、または POST /v1/form-values。各画面で site と page を送ると、そのサイトやページに限定したカスタムフィールドが適用されます。

form_values
{
  "site": "staging.acme.dev",
  "page": "/signup",
  "fields": [
    { "id": "size", "type": "select", "label": "Company size",
      "test_id": "company-size", "options": [ … ] },
    { "id": "web", "type": "url", "label": "Website" }
  ]
}

返ってきた値を入力する

値は同じテスト用アドレスから得られるため、次回も同じアカウントには同じ回答が入ります。

回答
{ "values": [
  { "id": "size", "kind": "custom", "value": "11-50",
    "rule": { "id": "…", "name": "Company size" } },
  { "id": "web", "kind": "guess", "from": "type",
    "value": "https://www.example.com",
    "note": "Guessed from its type. Check it suits your test, …" }
] }

フィールドがフォームを妨げるときに保存する

エージェントがカスタムフィールドを保存するのは、あなたが依頼したとき、または必須フィールドがフォームを妨げる場合にあなたが同意したときだけです。

save_custom_field
{
  "name": "Company size",
  "match": { "on": "test_id", "text": "company-size" },
  "value": { "kind": "option", "option": "11–50" },
  "tag_answer": true
}

またはテストから

npm パッケージと Python ヘルパーにも同じ呼び出しがあります。複数画面にわたるサインアップでは、画面ごとに 1 回呼び出します。

signup.spec.ts
const first = await qa.formValues({ fields, site: 'staging.acme.dev', page: '/signup' });
// …fill it, press Continue, then on the next screen:
const next = await qa.formValues({ fields: teamFields, address: first.address, site: 'staging.acme.dev', page: '/signup/team' });
await qa.saveCustomField({ name: 'Team size', match: { on: 'name', text: 'team_size' }, value: { kind: 'option', option: '2–10' } });

MCP ドキュメントの form_valuesREST でのカスタムフィールド

既製フィールド

電話番号と ID 番号を安全に入力。

作り上げた値を入れるべきでないフィールドがあります。電話番号は誰かに届くかもしれず、ID フィールドのランダムな数字は実在の人物のものかもしれません。既製フィールドを追加すると、Proxy Mail QA はそうなり得ない値をすべてのエージェントとテストで入力します。そのような値がない場合、フィールドは注記付きで空のままです。

電話番号

どのプロジェクトにもあります。英国、オーストラリア、米国、カナダでフィクション用に確保された番号を入力し、追加したほかの国ではアプリ独自のテスト番号を入力するので、テストで誰かに SMS が送られることはありません。

国民 ID 番号、税番号、パスポート番号

マイナンバーなどの国民 ID、個人の納税者番号、パスポート番号で、形式に従い実在の人物と一致しないものです。Proxy Mail QA に安全な値がある場合はそれを、ない場合はテストモードでの確認用に KYC ベンダーのサンドボックス値を使います。追加できるのはプロジェクトのリードのみです。個人の納税者番号は KYC ベンダーからのみ提供されます。

VAT 番号と法人の税番号

企業の番号についても同様です。Proxy Mail QA には安全な VAT 番号がなく、英国の VAT チェックはすべての偽の番号を拒否するため、KYC ベンダーのサンドボックス値にない限り、VAT 番号フィールドは注記付きで空のままです。

よく使われるもの

性別、言語、役職、チームの規模、業種、知ったきっかけには、フィールド自身の選択肢から 1 つが入ります。同じアカウントには同じ選択肢が入ります。

規約のチェックボックス

チェックを入れた状態、または規約に同意していない場合にフォームが何を表示するかをテストするため、チェックを外した状態にします。

サイトの言語で

それぞれ、英語、ドイツ語、フランス語、スペイン語、イタリア語、ポルトガル語、オランダ語、中国語、日本語で、何を尋ねているかによって対象のフィールドを見つけます。そのフィールド用のカスタムフィールドがある場合は、そちらが優先されます。

ドキュメントの既製フィールド電話番号や ID のフィールドを安全にテストする

推測

残りを入力し、推測した内容を表示します。

カスタムフィールドのないフィールドには、フィールドが示す内容から値が入り、推測と表示されます。同じアカウントには毎回同じ推測が入ります。

プレースホルダー内の例

「Acme Ltd」や「e.g. Hiring manager」はそのまま入力されます。「Enter your company size」のような指示は入力されません。

選択肢の 1 つ

アカウントごとに異なる実際の選択肢を選ぶため、一連のテストアカウントでドロップダウン全体をカバーできます。「Choose…」のようなプレースホルダーの選択肢はスキップされます。

型、パターン、ラベル

Web サイトには https://www.example.com を、数値にはフィールドの範囲内の値を、役職には QA Engineer を、郵便番号にはペルソナの国のものを入れます。

デフォルトはすべてのフィールド

プロジェクトで別の設定をしない限り、カスタムフィールドのないすべてのフィールドに推測が入ります。新規と既存のプロジェクトの両方に適用されます。

または必須フィールドのみ

フォームで必須とされたフィールドだけに推測が入ります。任意フィールドに不自然な値を受け付けないアプリ向けです。任意フィールドは空のまま残されます。

またはオフ

これまでどおり、組み込みの値とカスタムフィールドだけが入力されます。Project settings で変更するか、1 回の呼び出しだけなら form_values の guess で変更します。

入力しないもの

一部のフィールドはあなたが入力します。

設定にかかわらず、これらは推測されず、理由とともに空で返されます。

  • 支払いフィールド

    カード番号、CVC、有効期限、IBAN、請求先情報。テストカードは支払いプロバイダーのテストモードで使うものなので、カスタムフィールドも設定できません。

  • ID 番号と税番号

    パスポート、国民保険番号、VAT、税務 ID は推測しません。既製フィールドは、Proxy Mail QA に安全な値がある場合、実在の人物と一致しない偽の値を入力します。カスタムフィールドはチームが公開する固定のテスト値を入力します。ただし、個人 ID にランダムな数字を入れることはありません。

  • パスワードとシークレット

    入力されるのはアカウント自身のパスワードだけです。PIN、キー、トークン、秘密の質問は入力されません。また、カード番号、秘密鍵、記載の形式のいずれかの API キー やトークンに見える値は拒否されます。

  • 他から届くコード

    ワンタイムコード、プロモーションコード、クーポンコード、紹介コードは、メールまたはあなたから得るものです。作った値ではフォームが通りません。

  • CAPTCHA とアップロード

    入力されません。カラーピッカーや、非表示、無効、読み取り専用のフィールドも同様です。

  • 同意のチェックボックス

    チェックなしも有効な回答で、チェックを入れると何かに同意することになります。チームが常にチェックするものには Ticked を教えてください。

複数画面にわたる登録

すべての画面で同じアカウントを。

会社の詳細、チームの規模、オンボーディングの質問は、Next の後に来ることがよくあります。Proxy Mail QA for Chrome は最初の画面で作成したアカウントでそれらを入力します。Next を押したり送信したりはしません。

  1. このステップを入力

    後続の画面では、最初の空のフィールドにあるボタンで、同じテストアカウント、そのカスタムフィールドと推測を使って入力します。カードには「Filled step 2 of 3」のように画面数が表示されます。

  2. またはショートカット

    Alt+Shift+F でも同じ操作ができます。ページまたはポップアップで始めたサインアップでは、ポップアップの Fill this page も使えます。ショートカットは chrome://extensions/shortcuts で変更できます。

  3. Next の後の質問

    Next や Continue を押すと(ボタンの文言は 9 言語で読み取ります)、新しい画面がサインアップの一部かどうかを尋ねます。Keep this screen を選ぶと、それ以降そのサイトの後続の各画面を自動で入力します。リードだけがサイトを変更できるプロジェクトでは、先にリードに確認します。

  4. または各画面を自動で入力

    サインアップが常に続くサイトでは、Keep this screen を選ぶか、Project settings → Sites → Sign-up goes over several screens をオンにします。Next を押した後の新しい各画面が入力され、カードに入力内容が表示されます。

エージェントとテストは、同じアドレスと、各画面のサイトとページ(またはネイティブアプリの画面名を screen として)を指定して、画面ごとに form_values を 1 回呼び出します。各サイトのサインアップ画面は Project settings → Sites → Sign-up screens に一覧表示されます。

チームが管理を維持

リードが決め、メンバーは依頼します。

変更をリードに限定

Project settings → General のスイッチ 1 つで、プロジェクトのサイトとカスタムフィールドを変更できるのをリードだけにできます。リードがオンにするまではオフです。

メンバーは代わりに依頼

メンバーは、拡張機能の Teach、アプリ、またはエージェントから、メモを添えてリードに依頼します。リードは Project settings で承認または却下し、メールは最大で 1 時間に 1 回届きます。

すべてアクティビティログに記録

保存または削除されたすべてのカスタムフィールド、推測の設定へのすべての変更、すべての依頼と回答を、誰がどこから行ったか(「Claude Code から」を含む)とともに記録します。

FAQ

よくある質問

Proxy Mail QA はフォームが動くかを確認しますか?

いいえ。各フィールドの値を渡すだけで、確認はアプリが行います。フォームがその値を受け付けるか、その後どうなるかは、テストやエージェントが確認します。

エージェントと拡張機能には同じ値が渡されますか?

はい、チーム独自のカスタムフィールドについては一致します。カスタムフィールドはプロジェクトに属し、そのリスト、ランダムな数字、推測はテスト用アドレスから決まるため、同じアカウントには form_values でも Proxy Mail QA for Chrome でも同じ値が入ります。ただし、Proxy Mail QA for Chrome 0.9.0 は既製フィールドを入力せず、電話番号、番地、市区町村、地域、郵便番号は独自の方法で推測します。

知らないフィールドはどうなりますか?

プレースホルダー、選択肢、パターン、ラベル、または型から推測した値が入り、推測であることとその根拠が示されます。ただし、プロジェクトが必須フィールドのみ推測する設定、または推測しない設定の場合は除きます。支払いフィールド、ID 番号、シークレット、コード、CAPTCHA、同意チェックボックス、アップロードは推測しません。

複数言語のサイトでも動きますか?

はい。/signup のようなページは /de/signup や /fr/signup も対象になります。ラベルでフィールドを見分けるカスタムフィールドには、Referral code、Empfehlungscode、Code de parrainage のように各言語のラベルを登録できます。テスト ID や name は通常どの言語でも同じなので、1 つで足ります。

支払いフィールドに入力できますか?

いいえ。カードや銀行のフィールドには入力せず、カスタムフィールドも作れません。支払いプロバイダーのテストモードとテストカードを使ってください。

電話番号や ID 番号のフィールドには何が入りますか?

form_values では、プロジェクトの既製フィールドが提供する値のみです。すべてのプロジェクトに Phone number があり、架空用に確保された番号か、アカウントの国でのアプリのテスト番号を入力します。ID と納税者番号のフィールドは、リードが既製フィールドを追加するまで空のままです。既製フィールドは形式に従い実在の人物と一致しない値を提供します。安全な値がない電話番号、ID、納税者番号のフィールドは注記付きで空のままです。

推測を止められますか?

はい。Project settings → Custom fields の Fill fields it doesn’t know には Every field、Required fields only、Off の 3 つの選択肢があります。エージェントは form_values に guess off を渡して、1 回の呼び出しだけ止めることもできます。

1 つのプロジェクトにカスタムフィールドはいくつ作れますか?

Free でも Team でも 50 個で、それぞれ最大 10 個のフレーズを探します。それぞれ 1 つのサイト、またはそのサイトの 1 ページ(全言語)に限定するか、すべてのサイトで使えます。

その他の機能

サインアップフォーム全体を、毎回同じように入力。

無料アカウントを作成し、エージェントを接続して、フォーム独自のフィールドに何を入れるかを伝えてください。

このページについて質問がありますか?

質問はどの言語でもかまいません。ドキュメントからすぐに回答を得ることも、Proxy Mail QA チームに質問を送ることもできます。チームからの返信は英語です。