カスタムフィールド:アプリ独自のサインアップフィールドに入力する
英語から自動翻訳されています。
英語で読むサインアップフォームはメールアドレスとパスワード以外にも、会社規模、「どこで知りましたか?」、VAT 番号、チーム規模のドロップダウン、利用規約のチェックボックスなどを求めます。カスタムフィールドは、そうしたフィールドに何を入れるかを、プロジェクトの全員のために一度で決めます。コーディングエージェントは form_values からそれを受け取り、Proxy Mail QA for Chrome はフォームの他の部分と一緒に入力するので、同じテスト用アカウントにはどちらからも同じ回答が入ります。誰も教えていないフィールドには推測した値が入り、確認できるよう印が付きます。
Proxy Mail QA は値を渡すだけです。フォームがその値を受け付けるかどうかは、テストで確認します。
- コーディングエージェントとテストスイート。MCP server、REST API、npm パッケージ、Python ヘルパー の
form_valuesを通じて使います。カスタムフィールドで決まるフィールドはkind: "custom"付きで、推測した値はkind: "guess"付きで返されます。 - 手動でテストする人。Proxy Mail QA for Chrome 0.9.0 以降を使います。フォームの他の部分と一緒にカスタムフィールドに入力し、ページから新しいカスタムフィールドを教えられます。
カスタムフィールドはプロジェクトに属します。そのため、ブラウザで教えたものはプロジェクトのすべてのエージェントとテストスイートで同じように入力され、エージェントが保存したものはブラウザでも同じように入力されます。
ページから教える
Section titled “ページから教える”Proxy Mail QA for Chrome 0.9.0 以降の場合:
フォームに入力する
Section titled “フォームに入力する”いつもどおり、メールアドレスのフィールドにあるボタンからサインアップフォームに入力します。カードには入力した内容が表示され、続いて 推測 と 未入力 が表示されます。これらは、カスタムフィールドにも組み込みの値にも該当しなかったフィールドです。
「教える」を選ぶ
Section titled “「教える」を選ぶ”フィールドの横の 教える を選びます。カードに「「Company size」には何を入れますか?」と表示され、フィールドの認識方法(テスト ID、name、ID、またはラベルの単語。変更 で他の方法を表示)と適用範囲(現在のサイトとページ、すべての言語)が示されます。別の言語のページでは、保存先 に、別の言語でこのフィールドに該当しうるカスタムフィールドが表示されます。別の言語の「Referral code」などを選ぶと、新しく作る代わりにそのカスタムフィールドにこのラベルを追加します。回答はそのまま残り、追加して入力 でフィールドにすぐ入力します。
入れる内容を指定する
Section titled “入れる内容を指定する”フィールドの選択肢から 1 つ選ぶ、テキストを入力する(アカウントの名、姓、ユーザー名、会社、ランダムな数字のチップを使えます)、アカウントごとに 1 つずつ使う回答のリストを指定する、または 生成する を選んでフィールドに合う値を Proxy Mail QA に作らせることができます。空のままにする を選ぶと、フィールドには何も入りません。プレビューには、このアカウントに入る値が表示されます。
保存して入力する
Section titled “保存して入力する”保存して入力 で、プロジェクトの全員向けに保存し、フィールドにすぐ入力します。ページから教えたカスタムフィールドは、そのサイトとページにのみ、すべての言語で適用されます。すべてのページで使う でサイト全体に、すべてのサイトで使う でプロジェクト全体に広げられます。
支払い、パスワード、CAPTCHA、アップロードのフィールドでは「教える」は表示されません。すでにカスタムフィールドがあるフィールドには代わりに 変更 が表示され、その教える画面には 削除 が加わります。
プロジェクト設定で追加する
Section titled “プロジェクト設定で追加する”アプリでプロジェクト切り替え → Project settings → Custom fields を開きます。カードにはボタンが 2 つあります。電話番号、ID や税番号、よくある選択肢、規約のチェックボックス(下記)には 既製フィールドを追加、独自のものには カスタムフィールドを追加 を使います。
- 名前:そのフィールドが何かを、人が呼ぶとおりに書きます(「Company size」)。アカウントと拡張機能のカードに表示されます。
- 認識方法:ラベルまたは name に含む、テスト ID が一致、name が一致、ID が一致 のいずれかと、そのテキストです。ラベルまたは name に含む では、サイトの各言語でのフィールドのラベルなど、フレーズを 1 行に 1 つずつ、最大 10 個まで入力します。
- 適用範囲:すべてのサイト、またはプロジェクトのサイトの 1 つです。
/signupなどのページを任意で指定できます。 - 入れる内容:テキスト、テスト用アカウントから、生成する、選択肢、リストから 1 つ、複数の選択肢、チェックボックス、そのままにする のいずれかです。選択肢やリストでは、回答でアカウントにタグを付ける も選べます。プレビューには、サンプルのペルソナ Jane Doe の回答が表示されます。
カスタムフィールドを保存 で追加されます。カードの各行には、カスタムフィールドがどのようにフィールドを認識するか、適用先、値、追加した人、日時、追加元(「拡張機能から」「Claude Code から」)が表示されます。編集と削除は行にあり、特定のサイトに限定したものはメニューに すべてのサイトで使用 があります。サインアップフォーム が作成したカスタムフィールドには、フォーム名の 作成元 タグがあり、そこからフォームを開けます。
プロジェクトのサイトは、Project settings → Sites の サイトを追加 で、またはそのサイト上で Proxy Mail QA for Chrome から追加します。ステージング、開発、ローカルなど本番に見えないサイト(add_site、POST /v1/project/sites)は、エージェントや API が追加します。本番に見えるサイトは、アプリで人が追加し、テスト用サイトであることを確認します。いずれの場合も、Chrome は各ユーザーに一度、そのサイトで拡張機能を許可するよう求めます。プロジェクトにサイトがない間は、アプリで作ったカスタムフィールドはすべてのサイトに適用されます。エージェントや API は、サイトが追加される前でもカスタムフィールドをそのサイトに限定できます。
既製フィールド
Section titled “既製フィールド”入力した値より Proxy Mail QA の方法で埋めた方がよいフィールドがあります。誰にも届いてはいけない電話番号や、実在の人物と一致してはいけない ID 番号などです。既製フィールドを追加 では、これらがグループ別に検索ボックス付きで一覧表示されます。
| グループ | 既製フィールド | 入力される内容 |
|---|---|---|
| 連絡先 | 電話番号 | 英国、オーストラリア、米国、カナダでは架空用に確保された番号。その他の国では、追加した場合はアプリ独自のテスト用番号 |
| 身分証明書 | 国民 ID 番号、個人の税番号、パスポート番号 | フィールドカタログの値で、形式に従い、実在の人物と一致しないものです。Proxy Mail QA に安全な値がある場合はそれを、ない場合は KYC ベンダーのサンドボックス値を使います。Proxy Mail QA には安全な個人の納税者番号がないため、KYC ベンダーのサンドボックス値にない限り、個人の納税者番号フィールドは注記付きで空のままです |
| ビジネス | VAT 番号、事業者の税番号 | 同様に、実在の企業と一致しない値です。Proxy Mail QA には安全な VAT 番号がないため、KYC ベンダーのサンドボックス値にない限り、VAT 番号フィールドは注記付きで空のままです |
| 選択肢 | 性別、どこで知りましたか?、言語、職種または役職、チームまたは会社の規模、業種 | フィールド自身の選択肢のいずれか。同じアカウントには同じ選択肢 |
| 同意 | 規約のチェックボックス | チェックを入れる、または規約に同意しなかったときのフォームの表示をテストするためにチェックしないままにする |
1 つ選ぶと、何に一致するか(Proxy Mail QA が読み取る 9 言語で、どの語句 の語句によってその種類と判断するすべてのフィールド)と、選んだ国のサンプルペルソナ Jane Doe に何を入力するかが表示されます。次に名前を付け、適用先(すべてのサイト、または 1 つのサイトとページ)といくつかのオプションを選んで追加します。既製フィールドの行には 既製 タグが表示されます。追加後に変更できるのは名前、適用先、オプションで、一致対象と入力内容は変わりません。すべてのサイト向けにすでに追加されているものには 追加済み と 開く が表示されます。
Proxy Mail QA for Chrome 0.9.0 は既製フィールドを埋めません。それらのフィールドは誰も教えていないものとして扱います。英国、米国、カナダのアカウントには、電話番号がオフでも架空用に確保された電話番号を推測し、ID や税番号、規約のチェックボックスはあなたに任せます。
電話番号。 どのプロジェクトにも最初からオンの状態で 1 つあります。入力時に電話番号が入るのは、必ずこれを通じてです。英国、オーストラリア、米国、カナダ以外のアカウントについては、フィールドを空のままにする(テストが番号を入力します)か、アプリのテスト用番号を使う を選び、SMS プロバイダーが提供するテスト用番号など、国ごとに 1 つ、最大 20 個まで番号を追加します。プロジェクトの全員に表示されるため、実在の人物の番号ではなく、アプリ独自のテスト用番号を使ってください。実在の番号に送ったテキストは、その人に届きます。電話番号をオフにすると、電話番号フィールドはテストに任されます。
ID と税番号。 ID と税番号のフィールド、および電話番号のテスト用番号を追加・変更できるのはプロジェクトのリーダーだけです。ロックされたプロジェクトのメンバーはリーダーに依頼します。値の取得元 は Proxy Mail QA の安全な値 です。アカウントの国について、公開されているテスト値(tier A)または発行されることのない形式(tier B)を使い、そのような値がないパスポートフィールドには、ICAO の架空の国 Utopia のパスポートを使います。ルールしかない国や、安全な値がない種類は、注記付きで空のままです。または KYC ベンダーのサンドボックス値を選ぶこともできます。これはテストモードでのみ、そのベンダーのチェックを通過します。Proxy Mail QA が ID を受け取って確認することはありません。
サインアップフォームから。 電話番号、ID、選択肢、規約のフィールドがある サインアップフォーム は、フォームを保存すると、そのフィールド用の既製フィールドをテスト ID で一致させて作成します。そのため、それはフォームのものとして残ります。
既製フィールドは、プロジェクトのカスタムフィールド 50 個の上限に含まれます。form_values は、既製フィールドが埋めるフィールドに対して kind: "custom"、カスタムフィールド名、値の取得元についての注記を返します。
エージェントやスクリプトから
Section titled “エージェントやスクリプトから”| 一覧 | 追加または変更 | 削除 | |
|---|---|---|---|
| MCP | list_custom_fields |
save_custom_field |
delete_custom_field |
| REST | GET /v1/project/custom-fields |
POST /v1/project/custom-fields |
DELETE /v1/project/custom-fields/{id} |
| npm | customFields() |
saveCustomField() |
deleteCustomField() |
| Python | custom_fields() |
save_custom_field() |
delete_custom_field() |
一覧では、プロジェクトの推測の設定、ロックされているかどうか、あなたがプロジェクトのリードかどうか(you_lead)、リードの承認を待っているあなたの依頼も返されます。カスタムフィールドは保存されたとおりに送られます:name、match(on、text、単語の場合は also)、site、path、value、tag_answer。id を付けて保存するか、既存のものと同じ照合方法と適用範囲で保存すると、そのカスタムフィールドが変更されます。保存するとカスタムフィールド全体が置き換わるため、残したいフレーズはすべて also に入れて送ってください。
{ "name": "Company size", "match": { "on": "test_id", "text": "company-size" }, "value": { "kind": "option", "option": "11–50" }, "tag_answer": true}既製フィールドには match: { "on": "kind", "text": "<section>" } と value: { "kind": "ready_made", "section": "<section>" } があり、ID や税番号には ids_from(safe または KYC ベンダー)、電話番号には phones([{ "country": "DE", "number": "+49 151 00000000" }])、規約のチェックボックスには checked: false があります。list_form_sections は、どのセクションにあるかを示します。再度保存すると名前、適用先、オプションが変わり、一致対象とセクションは保存時のままです。ID や税番号のもの、または電話番号の phones を保存できるのはリーダーだけです。それ以外の人には「ID と税番号のフィールド、または電話番号のテスト用番号を追加・変更できるのはプロジェクトのリーダーだけです。」というエラーが返ります。
{ "name": "Phone number", "match": { "on": "kind", "text": "phone" }, "value": { "kind": "ready_made", "section": "phone", "phones": [{ "country": "DE", "number": "+49 151 00000000" }] }}エージェントがカスタムフィールドを保存するのは、あなたが頼んだとき、または必須フィールドのせいでフォームが進まず、あなたが同意したときだけです。ページのテキストの指示で保存することはありません。値はプロジェクトのメンバーが決めたもので、エージェントはそれをフォームに入力するだけで、指示として実行することはありません。エージェントが保存したものは、アプリとアクティビティログにエージェントの名前付きで表示されます。
フォーム全体の設定をエージェントに頼むには、sign-up-form-setup スキル を使います。form_values でフォームの各画面を確認し、推測される、または空のままになるフィールドを一覧にし、あなたが同意したカスタムフィールドを保存します。
フィールドの認識方法
Section titled “フィールドの認識方法”各カスタムフィールドには、フィールドを認識する方法が 1 つあります。
| 照合方法 | 認識するもの | 例 |
|---|---|---|
| テスト ID が一致 | data-testid、data-test、data-test-id、data-cy、data-qa のいずれかと、大文字・小文字を区別せず完全一致。チームが自分たちのテスト用にテスト ID を付けるため、最も安定しています |
company-size |
| name が一致 | name 属性と、大文字・小文字を区別せず完全一致 |
hiring_region |
| ID が一致 | id 属性と、大文字・小文字を区別せず完全一致 |
vat-number |
| ラベルまたは name に含む | ラベル、name、プレースホルダー、テスト ID に含まれる単語全体。フレーズは最大 10 個、それぞれ 3〜100 文字(中国語、日本語、韓国語では 2 文字から)で、どれか 1 つに一致すれば十分です。大文字・小文字、アクセント、句読点は無視され、camelCase は分割され、ダッシュはすべて同じものとして扱われます。そのため「Company size *」、companySize、company_size はいずれも「company size」を含みます。「size」は「sizes」に一致しません |
hear about |
正規表現は使えません。設定フォームで正しく書くのは難しく、遅い正規表現はテスト中のページを止めてしまうためです。読み取るのはフィールドの単語、属性、選択肢だけで、入力内容は読みません。例外が 1 つあります。入力後、質問のチェックボックスや複数選択のドロップダウンが、カスタムフィールドなしで 未入力 に残った場合、Proxy Mail QA for Chrome はどれがチェックまたは選択されているかを読み取り、教える のリストの初期値にします。この情報は、教える で 保存して入力 または リードに依頼 を押さない限りページの外に出ません。押した場合は、リストでチェックされたままの回答が、そのカスタムフィールドの回答としてプロジェクトに送られます。
複数の言語のサイト
Section titled “複数の言語のサイト”ページのパスはすべての言語の同じページに適用されるため、/signup は /en/signup、/de-DE/signup、/zh-Hans/signup にも適用されます。テスト ID、name、ID は通常どの言語でも同じなので、これらで照合するカスタムフィールドは 1 つですべての言語に対応できます。
ラベルでフィールドを認識するカスタムフィールドは、各言語のラベルを探せます。アプリでは 1 行に 1 フレーズ、エージェントや API からは match.also で指定します。どれか 1 つに一致すれば十分です。
{ "name": "Referral code", "match": { "on": "words", "text": "referral code", "also": ["empfehlungscode", "code de parrainage"] }, "value": { "kind": "leave" }}- 単語全体で探してください。ドイツ語は単語をつなげるため、Empfehlung ではなく Empfehlungscode を探します。
- 中国語、日本語、韓国語のラベルには単語の間にスペースがないため、职位 のようにラベル全体を探してください。これらの言語では、フレーズは 2 文字でもかまいません。
- 選択肢はテキストで選ばれ、テキストは言語によって変わります。ドロップダウンの選択肢が翻訳されている場合は、言語ごとにカスタムフィールドを 1 つずつ保存し、それぞれ同じ方法でフィールドを認識させてください。サイトの主な言語用はページを指定せずサイトに限定し、他の各言語用はサイトと
/deなどその言語のパスに限定します。/de/signupでは/deに限定したものが優先されます。ページに限定したものは、サイト全体向けのものより優先されるためです。 - Proxy Mail QA for Chrome 0.9.0 以降では、別の言語のページで 教える を使うと、既存のカスタムフィールドにそのラベルを追加できます。保存先 でそのカスタムフィールドを選んでください。
- プロジェクトのすべてのサイト。アプリやエージェントで追加したときの既定です。
- 1 つのサイト:そのサイトのすべてのページです。アプリではプロジェクトのサイトの 1 つです。エージェントや API からは、ホストまたはサイトのパターンで、まだプロジェクトのサイトでなくてもかまいません。
- 1 つのサイトとページ:
/signupなどのパスは/signupと/signup/businessに適用されますが、/signupsには適用されません。アドレスの先頭の言語は無視されるため、/signupは/en/signupと/de-DE/signupにも適用されます。/deのように言語だけのパスは、その言語に限定されます。
form_values では、1 つのサイトやページ向けのカスタムフィールドは、リクエストがその site と page を送ったときだけ適用されます。すべてのサイト向けのカスタムフィールドは、ネイティブアプリのフォームにもラベルで照合して適用されます。
- 一部のフィールドは常に Proxy Mail QA 自身の値を使い、カスタムフィールドは適用されません。メールアドレスとその確認、パスワードとその確認、生年月日、国、サインインコードの入力欄、プロモーションやクーポンの入力欄、マーケティングの同意チェックボックスです。これらはアカウントを作るものか、年齢確認や国ごとのルールが読み取る事実だからです。
- オンで一致するカスタムフィールド は、名、姓、氏名、ユーザー名、会社といった、その他の組み込み値より優先されます。これにより、チームは誤った値(「表示名」が氏名と判断された場合など)を修正したり、独自の形式(
QA {first_name})を使ったりできます。テスト ID、name、ID で一致する独自のカスタムフィールドが最優先で、次にサインアップフォームが作成した既製フィールド、次にフィールドの種類で一致する既製フィールド、最後に語句で一致するカスタムフィールドです。 - 組み込みの値。従来どおりです。
- 推測。ここまでで空のままのフィールドに、プロジェクトの設定が対象とする場合に入ります。
会社、名、姓、氏名はオフにすることもできます。その場合、入力欄は空のままで、組み込みの値も推測も入りません。
国。 国はテスト用アカウント自身のものです。新しいアカウントには、国フィールドが選択肢として示す国の中から form_values が 1 つを選びます。アメリカ合衆国、なければイギリス、なければ一覧の最初の国で、テキストボックスの場合はアメリカ合衆国です。後の画面で初めて国を聞かれた場合も、その時点で同じ方法でアカウントに国が決まります。バージョン 0.9.0 以降、Proxy Mail QA for Chrome は国のドロップダウン、ラジオボタン、テキストボックス、候補付きのボックスに入力し、2 文字のコード、または英語、ページの言語、ドイツ語、フランス語、スペイン語、イタリア語、ポルトガル語、オランダ語、中国語、日本語の名前で国を見つけます。ページが独自に描画する国の一覧(React Select や Headless UI のメニューなど)は開きません。その場合は 未入力 に表示されるので、ご自身で選んでください。支払い画面では国の入力をユーザーに任せ、入力できなかった国は理由とともに 未入力 に表示されます。
1 つのフィールドに複数のカスタムフィールドが一致する場合、完全一致(テスト ID、name、ID)は「含む」より優先されます。ページに限定したものはサイトに限定したものより、サイトに限定したものはすべてのサイト向けのものより優先されます。フィールド内で見つかったフレーズが長いものが短いものより優先され、その後は古いものが優先されます。カスタムフィールドは、自宅と勤務先の電話番号のように、フォーム内で一致するすべてのフィールドに入力されます。ページから教えた場合、そこで複数に一致するときはその旨が表示されます。
カスタムフィールドはサインインフォームには適用されません。サインインフォームにはメールアドレスまたはユーザー名と、保存済みのパスワードだけが入力されます。
form_values と API は、サインインフォームとパスワードリセットフォームを同じように扱います。入力するのはメールアドレスまたはユーザー名だけで、保存済みのパスワードは入力しません。また、アドレスがなければアカウントは作成されません。
各カスタムフィールドには Project settings → Custom fields にスイッチがあります。オフにすると、Proxy Mail QA はそのカスタムフィールドが存在しないものとして無視します。そのフィールドには、次にオンになっているカスタムフィールド、次に組み込みの値、さらにプロジェクトの設定が対象とする場合は推測値が入力されます。ボックスを空のままにするには、代わりに そのままにする を使ってください。
オフのカスタムフィールドは一覧に残り、list_custom_fields と API では enabled: false と表示され、上限の 50 件にも数えられます。オフのものと同じ一致条件と場所でフィールドを教えると、再びオンになります。id で変更した場合はそのままです。
プロジェクトのメンバーなら誰でも切り替えられます。ただし、リードがプロジェクトをロックしている場合は、メンバーには オン または オフ と 変更を依頼 が表示され、エージェントや、作成者がリードではない API キー による変更は、依頼としてリードに送られます。エージェントは set_custom_field_enabled を使います。API では id と enabled を付けた PATCH /v1/project/custom-fields、Node では setCustomFieldEnabled(id, on)、Python では set_custom_field_enabled(field_id, on) です。
標準フィールドをオフにする
Section titled “標準フィールドをオフにする”会社名、名、姓、氏名には、それぞれ Project settings → Custom fields の 標準フィールド の下にスイッチがあります。オフにすると、そのボックスは空のままになります。組み込みの値も推測値も入りません。ただし、オンで一致するカスタムフィールドがあれば、生成する に設定されていても入力されます。ユーザー名、メールアドレス、パスワード、生年月日、国、マーケティング同意ボックスなど、その他の標準フィールドにはスイッチがありません。
form_values はそのフィールドに注記付きで value: null を返し、Proxy Mail QA for Chrome 0.9.0 以降は「プロジェクト設定で会社名がオフのため、空のままにしました。」として 未入力 に表示します。教えるボタンはありません。名、姓、氏名のボックスがあるフォームでは、氏名をオフにするとそのボックスは空のままになります。氏名がオンの場合、名と姓のボックスにすでに名前が入っているため、そのボックスは独立したフィールドとして扱われ、推測値が入ることがあります。
get_project、GET /v1/project、GET /v1/project/custom-fields は、オフになっているものを standard_fields_off に表示します。
プロジェクトのメンバーなら誰でも切り替えられます。ただし、リードがプロジェクトをロックしている場合は、メンバーには オン または オフ と 変更を依頼 が表示され、エージェントや、作成者がリードではない API キー による変更は、依頼としてリードに送られます。エージェントは set_standard_field を使います。API では field と on を付けた PATCH /v1/project/standard-fields、Node では setStandardField(field, on)、Python では set_standard_field(field, on) です。
値とプレースホルダー
Section titled “値とプレースホルダー”| 入力する内容 | 対象 | 保存形式 |
|---|---|---|
| テキスト | テキストボックス、テキストエリア、数値 | { "kind": "text", "text": "Testing the sign-up" } |
| テスト用アカウントから | テキストボックス、テキストエリア | { "kind": "template", "template": "GB{digits:9}" } |
| 生成する | チェックボックス以外のすべてのフィールド | { "kind": "generate" } |
| 選択肢 | ドロップダウン、ラジオボタン | { "kind": "option", "option": "11–50" } |
| リストから 1 つ | すべてのフィールド(ドロップダウンやラジオボタンの場合は選択肢のテキスト) | { "kind": "list", "items": ["Search", "A friend", "Podcast"] } |
| 複数の選択肢 | チェックボックスのグループ、複数選択できるドロップダウン | { "kind": "options", "options": ["Slack", "Figma"] } |
| チェックボックス | チェックボックス | { "kind": "checkbox", "checked": true } |
| そのままにする | すべてのフィールド。何も入力しません。組み込みの値も推測値も入りません | { "kind": "leave" } |
テンプレートでは {first_name}、{last_name}、{full_name}、{username}、{email}、{company}、{country}(ペルソナの国の英語名)、{digits:N}(N は 1 から 12)を使えます。例:{company} Ltd、qa-{username}、GB{digits:9}。不明なプレースホルダーは保存時に拒否されます。
個人 ID フィールド。 個人 ID フィールド(英語、ドイツ語、フランス語、スペイン語、イタリア語、ポルトガル語、オランダ語、中国語、日本語での社会保障番号や国民保険番号、パスポート、運転免許証、国民 ID)には、実在の人物のものである可能性があるため、ランダムな数字は入力されません。{digits:N} を含むテンプレートは、名前や一致条件がこれらを示すカスタムフィールドでは拒否され、これらと判断されるフィールドには入力されません。カードでは 未入力 に表示され、form_values は注記付きで value: null を返します。チームが公開している固定のテスト値、またはそのリストを指定してください。VAT 番号は個人のものではないため、GB{digits:9} で入力されます。
生成する。 Proxy Mail QA は、誰も教えていないフィールドに入力するときと同じように、プレースホルダー、選択肢、パターン、ラベル、型からフィールドに合う値を作ります。たとえば「役職」というフィールドには役職が入ります。プロジェクトの 知らないフィールドに入力する 設定の範囲で入力し、行には 生成済み と表示されます。Proxy Mail QA が推測しないフィールド(パスワード、コード、支払いフィールド、ID 番号や税番号など)は空のままになり、理由が 未入力 または form_values の注記に表示されます。組み込みの値を置き換えることはありません。名、姓、氏名、ユーザー名、会社名はペルソナ自身のものが使われます。作った値が実在の人物のものである可能性があるため、名前や一致条件が個人 ID を示すカスタムフィールドには「生成する」を保存できません。
複数の選択肢。 チームが使うツールなど、複数の回答を受け付ける質問向けです。すべてのアカウントにすべての選択肢が入ります。最大 20 個、各 100 文字までです。チェックボックスのグループでは、指定したものにチェックを入れ、グループ内の残りのチェックを外します。ただし、次の 3 種類のボックスはそのままにします。利用規約やプライバシーポリシーなどへの同意ボックス、マーケティングのボックス、そして独自のカスタムフィールドが チェックボックス または そのままにする に設定されているボックスです。チェックボックスは、同じ name を共有するか同じ質問の下にある場合に 1 つのグループとみなされるため、質問に一致すればすべてに入力されます。複数選択できるドロップダウンでは指定したものがすべて選択され、ほかの方法では入力できません。推測されることはなく、ほかの種類の値も合わないためです。ラジオボタンは 1 つしか選べないため、この種類は使えません。各選択肢は 選択肢 と同様にテキストで探します。ページにない選択肢がある場合は、残りを入力し、見つからなかった選択肢を注記で示します。同意ボックスやマーケティングのボックスは、画面に見えていてもページにないものとして扱われるため、指定するとその注記が出て、ボックスはそのままになります。独自のカスタムフィールドを持つボックスを指定しても注記は出ません。そのボックス自身のカスタムフィールドに従います。どの選択肢も入力できない場合、フィールドはそのままになり、理由が 未入力 または form_values の注記に表示されます。リストと同様に、本物のシークレットのように見えるものは保存時に拒否されます。
Proxy Mail QA for Chrome では、1 つの質問のチェックボックスは、質問の名前が付いた 未入力 の 1 行にまとめられます。その行の 教える では、ページ上でチェックされている状態から始めて選択肢ごとにチェックを表示し、それらすべてに対して 1 つのカスタムフィールドを保存します。複数選択できるドロップダウンも同じ方法で教えます。ページが独自に描画するリストは開かないため、チップのボックスなど複数選択できるものは 未入力 に表示されます。ご自身で選んでください。
同じアカウントには同じ回答が入ります。 「リストから 1 つ」、{digits:N}、「生成する」は、毎回ランダムに選ぶのではなく、テスト用アドレスとカスタムフィールドから決まります。そのため、拡張機能でも form_values でも、同じアカウントに再度入力すると同じ回答になります。別のアカウントには別の回答が入るため、複数のアカウントを作ればリスト全体を網羅できます。
フィールドに合わせる:
- 選択肢は、大文字と小文字、アクセント記号、スペース、ダッシュの種類を無視してテキストで探します。まず完全一致、次に前方一致、最後に選択肢の value で探します。プレースホルダーの選択肢(「選択してください…」、無効なもの、空のもの)には一致しません。一致するものがない場合、フィールドはそのままになり、理由が表示されます:「“11–50” という選択肢がありません。」
- フィールドの
maxlengthより長いテキストは収まるように切り詰められ、カードにその旨が表示されます。 - フィールドの
minとmaxの範囲外の数値や、patternが受け付けないテキストは、注記付きでそのままになります。チーム独自の形式を使うことが目的なので、合わせるための変更は行いません。 - テキストフィールドへのチェックボックスなど、フィールドに合わない値はそこには適用されず、次に一致するカスタムフィールドが適用される場合があります。
ユーザー名と名前。 ユーザー名、名、姓のフィールドに対するカスタムフィールドは、その形式を決めます(qa_{digits:4} なら qa_4821)。新しいアカウントはその形式で作成されるため、それがそのままアカウントのユーザー名や名前になります。以前に作成されたアカウントは自身のものを保持し、フォームで使った値はそのサイトで使ったものとして横に保存され、そのサイトでのサインインではそちらが優先されます(get_sign_in と拡張機能のサインイン)。上書きされるものはありません。
アカウントにタグを付ける。 選択肢やリストでは、回答をアカウントのタグにすることもできます。会社規模が「11–50」なら 11-50 というタグが付くので、後でテストから tags フィルターでそのようなアカウントを探せます。タグは小文字で最大 32 文字です。それより長い回答にはタグが付きません。
誰も教えていないフィールドの推測値
Section titled “誰も教えていないフィールドの推測値”カスタムフィールドも組み込みの値もないフィールドには、フィールドの内容から推測した値が入ります。送信前に確認できるよう、印が付きます。
Project settings → Custom fields → Fill fields it doesn’t know:
| 選択肢 | 動作 | fill_unknown_fields |
|---|---|---|
| すべてのフィールド(デフォルト) | カスタムフィールドのないフィールドには、プレースホルダー、型、選択肢から値が入ります。確認できるよう、それぞれに推測値の印が付きます | all |
| 必須フィールドのみ | フォームで必須とされているフィールドだけに推測値が入ります。任意のフィールドはユーザーに任せます。任意のフィールドに不自然な値を受け付けないアプリ向けです | required |
| オフ | 組み込みの値とカスタムフィールドだけを入力します。それ以外は、これまでどおりユーザーに任せます | off |
この設定は Proxy Mail QA for Chrome と form_values の両方に適用され、誰かが変更するまで、新旧すべてのプロジェクトのすべてのフィールドでオンになっています。拡張機能はプロジェクトの設定に従い、独自のスイッチはありません。エージェントは、依頼された場合に限り update_project(fill_unknown_fields)で変更します。form_values は guess(all、required、off)を受け取り、既知の値だけを使いたいテストなどのために 1 回の呼び出しで設定を上書きできます。変更できる人は、カスタムフィールドと同じです。
必須とみなされるもの: required 属性、aria-required="true"、または * や「(必須)」が付いたラベルです。ラジオボタンのグループは、いずれかが該当すれば必須とみなされます。任意のフィールドに印を付けるフォームでは、「(任意)」が付いていないすべてのフィールドが必須とみなされます。どちらの印もないフォームでは、必須フィールドのみ の場合は推測値が入らず、カードにその旨が表示されます。form_values からは、フォームが必須としているフィールドごとに required を送ってください。送らない場合、この設定ではすべてのフィールドが任意とみなされます。
推測値の出どころ
Section titled “推測値の出どころ”次のうち、フィールドが受け付ける値(maxlength、minlength、min、max、step、pattern)を最初に返したものを使います:
- プレースホルダー(例として読める場合):「Acme Ltd」、「50–100」、「例:採用担当者」(先頭の「例:」や「たとえば」は除きます)。「会社規模を入力してください」、「選択…」、「回答」など指示として読めるものは使わず、40 文字または 6 語を超えるものも使いません。
- ドロップダウンの実際の選択肢の 1 つ。アカウントごとに異なるものを選び、プレースホルダーの選択肢は選びません。選択肢がまだないドロップダウン(別の項目を選んだ後に読み込まれるもの)はユーザーに任せます。
- ラジオボタンの 1 つ。同じ方法で選びます。
- パターン。
[A-Z]{2}[0-9]{6}や\d{5}のような単純なものの場合です。 - 語句による値:「Job title」には QA Engineer、「Website」には
https://www.example.com、「Company size」には 10(または範囲内の数値)、「How did you hear」には Search、「City」「State」「Postcode」にはペルソナの国の、市区・地域・郵便番号が整合する場所(Mumbai、Maharashtra、400001)、「Address line 1」には架空の番地(1 Test Street、Teststraße 1)、日本語のフォームには都道府県、市区町村、番地、建物名をこの順序と表記で(〒100-0001、東京都、千代田区、千代田1-2-3、テストハイツ101、または 2 つの欄に分けて)、中国語のフォームには省、市、区を、フォーム独自のメニューがあればそこから選び、测试路1号 とともに、「Message」や「Notes」には「Test entry made by Proxy Mail QA.」が入ります。 - 種類による値:URL フィールドには
https://www.example.com、数値フィールドにはminまたは範囲の中央値、日付フィールドには今日、テキストエリアには「Test entry made by Proxy Mail QA.」、その他のテキストフィールドには「Test」が入ります。
電話番号。 電話番号フィールド(種類、autocomplete、Mobile や Telefon などの語句、電話番号のプレースホルダーで判断)は推測されません。埋めるのはプロジェクトの既製 電話番号 だけで、誰にも届かない架空用に確保された番号(英国では 07700 900xxx、オーストラリアでは ACMA の 0491 57x xxx の番号のいずれか、米国とカナダでは 202-555-01xx を、フィールドのパターンと長さに合う国内形式または国際形式で)、またはアカウントの国のアプリのテスト用番号を使います。誰かの番号である可能性があるため、プレースホルダーや、パターンに合わせて作った数字が入ることはありません。どちらもない場合や電話番号がオフの場合、form_values は注記付きで value: null を返します。Proxy Mail QA for Chrome 0.9.0 は電話番号を使いません。英国、米国、カナダのアカウントには 07700 900xxx または 202-555-01xx を推測し、その他の電話番号フィールドは 未入力 に表示します。他のフィールドのパターンに合わせて作る数字も、電話番号や ID 番号の形にはなりません。[0-9]{11} のように、パターンがそうした番号しか作れないフィールドは推測されず、同じ注記が付きます。[678][0-9]{6} や [0-9]{3}-[0-9]{4} のように、パターンが単独の 7 桁や 8 桁を作るフィールドも同様です。ただし、フィールドの語句がコード、社員番号、会員番号(Staff number、Member ID、Mitgliedsnummer、会員コード)を指し、Member contact のような連絡手段を指していない場合は、パターンどおりの数字が入ります。区切り文字付きの日付は推測されたままで、ZIP+4 は 9 桁のため、郵便番号フィールドにはパターンどおりの値が入ります。
推測はテスト用アドレスとフィールドにも基づくため、同じアカウントには、拡張機能からでも form_values からでも、同じ選択肢を含め同じ推測値が入ります。Proxy Mail QA for Chrome 0.9.0 は番地、市区、地域、郵便番号を独自の方法で推測するため、form_values の値と異なる場合があります。
拡張機能では、カードの完了行が推測の数を示し(「9 個のフィールドに入力し、4 個は推測です。送信前に確認してください。」)、各推測は Guessed に出どころと Teach とともに表示されます。カードが開いている間は、ページ上の各推測に破線の枠が付きます。form_values からは、推測に kind: "guess"、from(placeholder、option、pattern、words または type)とメモが付きます。
入力しないもの
Section titled “入力しないもの”設定にかかわらず、次のものは推測しません。カードはこれらを理由とともに Not filled に表示し、form_values はメモとともに value: null を返します。
| 対象 | 理由 |
|---|---|
| 支払いのフィールド:カード番号、CVC、有効期限、IBAN、ソートコード、請求先 | テスト用カードは決済プロバイダーのテストモードで使うものです。カスタムフィールドにはできません。範囲の広いカスタムフィールドでも入力されません。「number」に一致するものでも、カード番号は飛ばします |
| ID や税の番号:パスポート、国民保険、SSN、VAT、納税者番号 | 推測しません。既製フィールドは、Proxy Mail QA に安全な値がある場合、実在の人物と一致しない偽の値を入力します。カスタムフィールドはチームが公開する固定のテスト値を入力します。ただし、個人 ID にランダムな数字を入れることはありません |
| アカウント自身のもの以外のパスワードや秘密情報:PIN、API キー、トークン、秘密の質問 | 入力せず、カスタムフィールドにもできません |
| 他から届くコード:ワンタイムコードや確認コード(「Code」だけの名前のフィールドを含む)、プロモーション、クーポン、紹介、招待のコード | 作った値ではフォームが通りません |
| CAPTCHA | 入力しないもの |
| チェックボックスとスイッチ | 未チェックも有効な回答で、チェックすると何かに同意することになります。チームがいつもチェックするものは Ticked を教えてください |
| 複数の回答を選べるドロップダウン | 推測しません。Several options に設定したカスタムフィールドだけが入力します |
| ページが独自に描画する、複数の回答を選べるリスト(チップの入ったボックスなど) | 開かず、何も入力しません。回答はご自身で選んでください。form_values からは multiple: true で送信します |
| アップロード、カラーピッカー、非表示、無効、読み取り専用のフィールド | 入力しないもの |
| すでに値が入っているフィールド | ページやあなたが入れた値を推測で上書きすることはありません |
フィールドが空かどうかを知るために、拡張機能は値が入っているかを確認します。使うのはその有無だけで、フィールドの中身を保存したり送信したりすることはありません。例外が 1 つあります。入力の結果、ある質問のチェックボックスや複数の回答を選べるドロップダウンが、カスタムフィールドのないまま Not filled に残った場合、Proxy Mail QA for Chrome はどれがチェックまたは選択されているかを読み取り、Teach のリストの初期値にします。この情報はページ内にとどまります。ただし Teach で Save and fill または Ask a lead を押した場合は、リストでチェックされたままの回答を、そのカスタムフィールドの回答としてプロジェクトに送信します。
ID フィールドを埋める
Section titled “ID フィールドを埋める”ID と税番号は、プロジェクトのリーダーが追加する 既製フィールド で埋めます。エージェントは get_project から fill_id_fields を読み取れます。これは ID と税番号の既製フィールド 5 つがすべてオンのとき true になります。リーダーが fill_id_fields を指定して update_project を実行すると、それらを追加またはオフにでき、アクティビティログに記録されます。
複数画面にわたる登録
Section titled “複数画面にわたる登録”登録によっては、最初にメールアドレスを求め、Next の後の画面でパスワード、会社情報、チームの人数、オンボーディングの質問を求めます。カスタムフィールドと推測が最も役立つのは、こうした後の画面です。
手動で、Proxy Mail QA for Chrome を使って
Section titled “手動で、Proxy Mail QA for Chrome を使って”バージョン 0.9.0 以降、メールアドレスのフィールドから登録を始めると、後の画面にも同じテスト用アカウント(名前、ユーザー名、そのページ用のプロジェクトのカスタムフィールド、プロジェクトの設定に従った推測)が入力されます。方法は 3 つあります。
- Fill this step:新しい画面の最初の空のフィールドに表示されるボタンで、タイトルは「Fill this step as nadia.k@…」です。Fill this step を含むカードが開き、結果には画面の数が表示されます。ページにステップが表示されている場合は「Filled step 2 of 3」、そうでない場合は「Filled screen 2」です。
- ショートカット Alt+Shift+F でも同じことができます。
chrome://extensions/shortcutsで変更できます。 - 拡張機能のポップアップの Fill this page も同じ動作です。ページまたはポップアップから始めた登録に使え、ポップアップの Sign-up on this tab カード、またはそこで作成したアドレスのカードにあります。
アカウントは、最後の入力から 15 分間、ページの読み込みをまたいでも、プロジェクトのどのサイトでもタブに保持されます。そのため、app.acme.dev から auth.acme.dev へ移る登録も、両方がプロジェクトのサイトであれば同じアカウントを使い続けます。Fill this step は、サインインフォーム、メールアドレスのフィールドが空または別のアドレスが入っているフォーム(これらには専用のボタンがあります)、入力するものがない画面には表示されません。タブでサインインすると登録は終了するため、サインインコードの画面を次の画面として読むことはありません。
Next の後の質問
Section titled “Next の後の質問”バージョン 0.9.0 以降、Next または Continue を押して登録の新しい画面が表示されると、Proxy Mail QA for Chrome が「Is this the next screen of the sign-up?」と尋ねます。
- Keep this screen はそのページをサイトの登録画面に追加し、サイトの各画面の自動入力をオンにします。以降の画面はそれぞれ自動で入力されます。サイトを変更できるのがリードだけのプロジェクトでは、リードでない人は代わりにリードに依頼します。その画面は提案として表示され、リードが承認すると新しい画面がそれぞれ自動で入力されます。
- Not now を選ぶと、拡張機能のオプションで Ask on these sites again を選ぶまで、そのサイトでは再び尋ねません。
- Don’t ask again を選ぶと、この Chrome プロファイルでは、どのサイトでも質問しなくなります。拡張機能のオプションで再びオンにできます。
chrome://extensions→ Details → Extension options、またはポップアップの Options アイコンから Ask after Next or Continue をオンにしてください。 - × はこの登録に限って閉じます。
Submit や Create account の後、支払い画面、入力済みの画面、すでに各画面の自動入力が設定されたサイトでは尋ねず、1 回の登録で 2 回以上尋ねることもありません。質問が開いている間、パスワード保存の質問は待機します。ページのアドレスが 1 回の登録用に作られている場合(パスにメールアドレス、ID、長い番号、トークンが含まれる場合)、そのページはリストに追加されませんが、Keep this screen で設定はオンになります。
各画面の自動入力
Section titled “各画面の自動入力”登録が常に複数画面にわたるサイトでは、プロジェクトの誰でも Project settings → Sites → Sign-up goes over several screens をオンにできます。ただし、サイトを変更できるのがリードだけの場合(Only project leads change sites and custom fields)は、メンバーはリードに依頼します。Next の後の質問で Keep this screen を選ぶか、あなたの承認を得たエージェントの set_multi_step でもオンになります。オンにすると、最初の画面の後、Next を押して表示される新しい画面はそれぞれ、表示が落ち着いてから 0.5 秒後に入力されます。カードが開いて入力内容を表示するので、先に進む前に確認できます。Stop for this sign-up を押すと、次の登録までオフになります。
次へを押したり送信したりすることはありません。ボタンを押さずに現れたフォーム(ニュースレターのボックス、チャットウィンドウ)、サインインフォーム、支払い画面(どこかにカードフィールドがあるもの、または Stripe などの決済プロバイダーのフレーム)、自分で入力したフィールドには入力しません。15 分間入力がないか、10 画面を超えると停止します。
各サイトの登録画面
Section titled “各サイトの登録画面”プロジェクトの各サイトは、登録画面のリストを順番どおりに Project settings → Sites → Sign-up screens のサイトの行に保持します。画面がリストに入る方法は 3 つあります。
- Proxy Mail QA for Chrome の Keep this screen は、今いるページを保存します。
- 入力:Proxy Mail QA for Chrome が入力した後の画面はそれぞれ、登録の最初の画面とともに提案として追加されます。エージェントが登録のために
form_valuesに送るpageやscreenも同様です。ただし、リストが満杯(20)の場合は除きます。 - 手動:アプリの Add screen で、ページのパスまたはネイティブアプリの画面名と、任意の短い名前を指定します。エージェントからは
save_signup_screenを使います。
提案された画面には、誰かが保存するまで Suggested チップが付き、各行には出どころが表示されます(「Filled by Proxy Mail QA for Chrome」「Sent to form_values by Claude Code」「Added by priya@acme.dev」)。Keep、Rename、Remove は行のメニューにあります。パスのクエリと # 以降は除かれます。入力、form_values、Keep this screen は、1 回の登録用に作られたパス(メールアドレス、ID、長い番号、トークンを含むもの)を追加しません。メールアドレスを含むパスは手動でも追加できません。1 つのサイトに保持できる画面は 20 個までです。リストが満杯の場合、Proxy Mail QA for Chrome が入力した画面は、30 日間誰も見ていない提案の画面と置き換わります。form_values は何も追加も削除もしません。手動での追加は、画面を削除するまで拒否されます。手動やエージェントから画面を追加しても、各画面の自動入力はオンになりません。オンにするのは Keep this screen、スイッチ、set_multi_step です。
エージェントがサイトなしの screen として送るネイティブアプリの画面は、プロジェクトの App screens になり、サイトの後に専用のボックスで表示されます。
プロジェクトの誰でも変更できます。ただし、サイトを変更できるのがリードだけの場合は、メンバーは Suggest a screen、Ask to keep、Ask to rename、Ask to remove を使い、自分の提案は名前の変更や削除ができます。提案を削除すると、保存を待っている依頼も取り下げられます。リードが保存の依頼を却下すると、その提案はリストから外れます。
| サイトとその画面 | サイトを追加 | 各画面を自動で入力 | 画面を追加・名前を変更 | 画面を削除 | |
|---|---|---|---|---|---|
| MCP | get_project (sites, app_screens) |
add_site |
set_multi_step |
save_signup_screen |
remove_signup_screen |
| REST | GET /v1/project/sites |
POST /v1/project/sites |
PATCH /v1/project/sites |
POST /v1/project/sites/screens |
DELETE /v1/project/sites/screens/{id} |
| npm | sites() |
addSite() |
setMultiStep() |
saveSignupScreen() |
removeSignupScreen() |
| Python | sites() |
add_site() |
set_multi_step() |
save_signup_screen() |
remove_signup_screen() |
エージェントがこれらを呼び出すのは、あなたが依頼または同意したときだけで、ページのテキストに指示されたからではありません。ロックされたプロジェクトでは、作成者がリードでないキーは status: "requested"(REST では 202)を受け取り、リードが Project settings → Sites で承認します。
Next ボタンと完了ボタン
Section titled “Next ボタンと完了ボタン”拡張機能は、押されたボタンの語を読み取り、ページのテキストからステップの表示(「Step 1 of 3」)を探して、次の画面に進むボタンと登録を完了するボタンを見分けます。テキストボックスなど入力できる要素は飛ばすため、あなたが入力した内容を読むことはありません。こうしたテキストを保存したり送信したりすることもありません。
読み取る言語は、英語、ドイツ語、フランス語、スペイン語、イタリア語、ポルトガル語、オランダ語、中国語、日本語です。Weiter、Suivant、Siguiente、Avanti、Próximo、Volgende、下一步、次へ は Next として、Zurück、Retour、Atrás、Indietro、Voltar、Terug、返回、戻る は Back として扱います。そのため、前に戻っても登録は終了しません。「Schritt 2 von 3」「Étape 2 sur 3」「第 2 步,共 3 步」「ステップ 2/3」はステップの表示として扱います。Anmelden、Aanmelden、Valider、Get started、Continue with Google など、サインインや完了の意味にもなる語は Next として扱わないため、その後に質問が表示されることはありません。
- Next、Continue、または最後のステップより前のステップ表示の後は、次の画面が来ると見なされるため、Fill this step がすぐに表示されます。
- 各画面の自動入力が設定されたサイトでは、パスワード保存の質問は、完了の操作(Create account、Finish、Start trial、または最後のステップのいずれかのボタン)、登録のメールの到着、タブがサイトを離れることのいずれかまで待機し、その後フォームに最後に入っていたパスワードを使います。先にタブがサイトを離れた場合、ポップアップで選択するまでツールバーのボタンに 1 が表示されます。それ以外のサイトでは、これまでどおりフォームの送信時に尋ねます。
- 15 分以内に続く画面(アカウント作成後に多くのアプリが尋ねる質問など)も登録の一部です。利用規約への同意、チェックボックスのチェック、支払いだけを求める画面も同様です。アプリ本体など、あなたや Proxy Mail QA がすることが何も残っていない最初の画面で登録は終了します。
- 登録でアドレス確認のリンクが送られてきた場合は、メールのカードまたはポップアップの Open で開くと、新しいタブで同じ登録が続きます。Copy して同じタブに貼り付けても同様です。メールアプリから開いたリンクは新しい登録として始まります。
エージェントやテストから
Section titled “エージェントやテストから”form_values は 1 画面ずつ回答します。最初の画面で呼び出してアカウントを作成し、以降の画面ではその画面のフィールド、同じ address、その画面の site と page を渡して画面ごとに 1 回ずつ呼び出します。こうすると、そのサイトやページに限定したカスタムフィールドが適用されます。後の画面でパスワード、生年月日、国を求められた場合、アカウントにまだなければその時点で作成されます。ネイティブアプリでは、page の代わりに画面名を screen として送ります(両方は送りません)。サインアップ時には、送信した page または screen がそれぞれ候補としてサイトのサインアップ画面に追加されます(プロジェクトのサイトを指定せずに送った screen はアプリ画面に追加されます)。ただし、リストが上限(20)に達している場合は何も追加されません。あなたの許可があれば、エージェントは save_signup_screen でそれらを保存し、set_multi_step で各画面を自動で入力する設定をオンにできます。「次へ」はエージェントまたはテスト自身が押します。Node.js クライアント に Playwright の例があります。
アカウントに保存される内容
Section titled “アカウントに保存される内容”- カスタムフィールドのセクション:アプリのアカウント詳細に表示されます。カスタムフィールドまたは推測で入力された各フィールドについて、回答と入力日時が表示され、推測には推測であることが示されます。回答は最大 60 件、各 200 文字までで、フィールドとサイトごとに最新の入力の回答が保存されます。以前は推測で入力していたフィールドをカスタムフィールドが決めるようになると、その回答が推測に置き換わります。
- サイトで使われたユーザー名と氏名:カスタムフィールドが別の値を指定した場合に保存されます。「staging.acme.dev でのユーザー名: qa_4821」と表示され、その下にアカウント本来の値が表示されます。そのサイトでサインインするときは、こちらが優先して使われます。
- タグ:回答でアカウントにタグを付ける を設定したカスタムフィールドの場合です。
API では、アドレスが返されるすべての場所(GET /v1/addresses など)に custom_answers が含まれ、MCP server では list_addresses、get_sign_in、check_out_account にも含まれます。アカウント名やタグと同様に、回答はテストデータであり、アドレスとともに保存・削除されます。
ロックとリクエスト
Section titled “ロックとリクエスト”デフォルトでは、プロジェクトの全員がカスタムフィールドと推測の設定を追加・変更できます。プロジェクトリードはこれらをロックできます。
- Project settings → General → Only project leads change sites and custom fields。組織のオーナーと管理者もリードとして扱われます。個人スペースのプロジェクトにはこのスイッチはありません。メンバーはあなただけなので、変更は常にすぐ反映されます。このスイッチはリードがオンにするまでオフで、拡張機能でメンバーがサイトを追加するのを止めるスイッチと同じものです。
- メンバーは代わりにリクエストします。 拡張機能の「教える」の リードに依頼(値はその入力に限りフィールドに入力されます)、ポップアップの リードに追加を依頼、アプリのカスタムフィールドカードとサイトカードの カスタムフィールドを依頼、変更を依頼、削除を依頼 があり、いずれも任意でメモを付けられます。キーの作成者がリードでない場合、エージェントや API キー による変更はリクエストになります。その場合の応答は
status: "requested"(REST では202)です。 - リードはアプリで回答します。 カスタムフィールドカードまたはサイトカードの上部にある リクエスト に、依頼内容、依頼者、日時、依頼元、メモが一覧表示されます。承認 すると同じチェックを再度実行して変更が反映されます。却下 には任意で理由を付けられます。リクエストが待機している間は、プロジェクトメニューのプロジェクト名に件数が表示されます。また、リクエストが届くと各リードに リクエストを確認 を含むメールが送られます(最大 1 時間に 1 通)。
- メンバーにはカードに回答が表示されます。 待機中は 取り下げ を使えます。拡張機能では、それまでフィールドに「リードの対応待ち」と表示されます。
リクエストは、回答されたとき、取り下げられたとき、30 日間回答がないとき、またはロックがオフになったときに終了します。ロックがオフになった場合は何も自動では変わらず、待機中の各リクエストに「ロック解除済み:この変更は自分で行えます」と この変更を行う が表示されます。同じカスタムフィールドやサイトについて、1 人が持てる未処理のリクエストは 1 件です。再度依頼すると、そのリクエストが変更されます。
カスタムフィールドを削除できるのはリードのみです。プロジェクトがロックされていない場合は、追加した本人も削除できます。アーカイブ済みのプロジェクトや読み取り専用の組織では、誰もカスタムフィールドを変更できません。すべての変更とリクエストはプロジェクトのアクティビティログに記録され、カスタムフィールドや推測で入力された各フォームも記録されます。
- カスタムフィールドはプロジェクトごとに 50 個まで(Free と Team、既製フィールドを含む)。
- 名前は 1~80 文字、一致条件は 1~100 文字(「含む」の場合は 3~100 文字、中国語・日本語・韓国語では 2 文字から。フレーズは最大 10 件)、ページパスは最大 200 文字。
- テキストとテンプレートは最大 200 文字、リストは 2~20 件の回答で各 100 文字まで。
- 待機中のリクエストはプロジェクトあたり 20 件、メモと理由は最大 300 文字。
- サインアップ画面:サイトあたり最大 20 件、アプリ画面はプロジェクトあたり 20 件。パスは最大 200 文字、画面名と短縮名は最大 80 文字。
- パスワード欄や支払い欄にはカスタムフィールドを設定できません。値はプロジェクトの全員に表示されるため、架空のテストデータを使ってください。カード番号、秘密鍵、または 一覧の形式 の API キー やトークン(Proxy Mail QA 自身のキーを含む)に見える値は、「本物のシークレットのようです。架空のテストデータを使ってください。」と表示されて拒否されます。パスワードはテストデータと区別できないため、本物のパスワードは絶対に入力しないでください。
- 個人 ID 欄にはランダムな数字を使えません。
{digits:N}を含むテンプレートは、「ランダムな数字は実在の人物のものになりうるため、個人 ID 欄には使用しません。代わりに固定のテスト値を指定してください。」と表示されて拒否されます。 - React Select や Headless UI のリストボックスなど、ネイティブの
<select>ではないドロップダウンには入力されません。Proxy Mail QA for Chrome はページ自身が描画するリストを開かないためです。選択できない場合はカードにその旨が表示されます。
シークレットに見える値
Section titled “シークレットに見える値”カスタムフィールドの値は、テキスト、テンプレート、選択肢、リスト項目、およびテスト用アカウントに保存される回答のいずれかの一部が以下に該当する場合、「本物のシークレットのようです。架空のテストデータを使ってください。」と表示されて拒否されます。キーの前に token= や引用符などの語句があっても検出されます。キーとみなされるのは、値の先頭、または英字、数字、_ 以外の文字の直後にある場合だけです。そのため xhf_… はキーとみなされません。
- カード番号: Luhn チェックを通過する 13~19 桁の数字(間のスペースやダッシュの有無は問いません)。
- 秘密鍵:
-----BEGINを含むもの。
プレフィックスだけで拒否されるキーとトークン(テストキーを含む)。そのため sk_test_anything は拒否されます。
| プロバイダー | 先頭の文字列 | 内容 |
|---|---|---|
| Stripe | sk_live_, rk_live_, sk_test_, rk_test_ |
シークレットキーと制限付きキー(本番・テスト) |
| Stripe | whsec_ |
Webhook 署名シークレット |
| GitHub | ghp_, github_pat_ |
個人用アクセストークン |
| GitLab | glpat- |
個人用アクセストークン |
| npm | npm_ |
アクセストークン |
| Slack | xox、小文字 1 文字、-(xoxb- や xoxp- など) |
ボット、ユーザー、アプリのトークン |
| Supabase | sb_secret_ |
シークレット API キー |
| Anthropic | sk-ant- |
API キー |
| OpenAI | sk-proj-, sk-svcacct- |
プロジェクトキーとサービスアカウントキー |
全体の形式で拒否されるキーとトークン: プレフィックスの後に、そのプロバイダーのキーが持つ文字が続くもの。hf_test や key-test のようにプレフィックスだけの架空の値は保存できます。「ちょうど」と記載がある場合を除き、形式の後にさらに文字が続く場合も拒否されます。
| プロバイダー | 先頭の文字列 | 続く文字 |
|---|---|---|
| Proxy Mail QA | qa_、または qa_o、小文字 2 文字、_(qa_oat_ など) |
ちょうど 43 文字の英字、数字、-、_:API キー、および AI アプリが接続時に取得するトークン |
| AWS | AKIA |
16 文字の大文字または数字:アクセスキー ID |
| AWS | ASIA |
ちょうど 16 文字の大文字または数字:一時アクセスキー ID |
AIza |
35 文字の英字、数字、-、_:API キー |
|
GOCSPX- |
28 文字の英字、数字、-、_:OAuth クライアントシークレット |
|
| GitHub | gho_, ghu_, ghs_, ghr_ |
36 文字の英字または数字:OAuth、ユーザー、アプリ、リフレッシュトークン |
| Resend | re_ |
8 文字の英字または数字、_、さらに 24 文字:API キー |
| SendGrid | SG. |
22 文字の英字、数字、-、_、ドット、さらに 43 文字:API キー |
| Linear | lin_api_ |
40 文字の英字または数字:API キー |
| Slack | hooks.slack.com/services/ |
チーム ID(T…)、チャンネル ID(B…)、24 文字のシークレット:受信 Webhook URL |
| Slack | hooks.slack.com/workflows/, hooks.slack.com/triggers/ |
43 文字の英字、数字、+、/:ワークフロー Webhook URL |
| Cloudflare | cfut_, cfat_, cfk_ |
40 文字の英字または数字:ユーザーおよびアカウントの API トークン、Global API キー |
| Supabase | sbp_, sbp_oauth_, sbp_v0_ |
40 文字の英字または数字:アクセストークン |
| OpenAI | sk-admin- |
74 文字または 58 文字の英字、数字、-、_、続いて T3BlbkFJ とさらに 58 文字:管理者キー |
| OpenAI | sk- |
20 文字の英字または数字、続いて T3BlbkFJ とさらに 20 文字:旧形式のキー |
| Hugging Face | hf_ |
34 文字の英字または数字:アクセストークン |
| PyPI | pypi-AgEIcHlwaS5vcmc |
50 文字の英字、数字、-、_:アップロードトークン |
| DigitalOcean | dop_v1_, doo_v1_, dor_v1_ |
数字と a~f の小文字 64 文字:個人用アクセス、OAuth、リフレッシュトークン |
| Shopify | shpat_, shpca_, shppa_, shpss_ |
数字と a~f(大文字・小文字どちらも可)32 文字:アクセストークン、アプリトークン、共有シークレット |
| Twilio | SK |
数字と a~f(大文字・小文字どちらも可)32 文字:API キー SID |
| Mailgun | key- |
32 文字の小文字または数字:プライベート API キー |
| すべてのプロバイダー | eyJ |
8 文字以上の英字、数字、-、_、続いてドット:JSON Web Token |
それ以外は保存されます。パスワード、独自のプレフィックスを持たないキーやトークン、ここに記載のないプロバイダー(Notion、Postman、Atlassian、Databricks、Doppler など)のキーやトークン、Wrangler の cfoat_ トークンなどです。本物の値はご自身でカスタムフィールドに入れないようにしてください。
このページについて質問がありますか?
質問はどの言語でもかまいません。ドキュメントからすぐに回答を得ることも、Proxy Mail QA チームに質問を送ることもできます。チームからの返信は英語です。