フォームの送信内容をエージェントに読ませる
エージェントは、訪問者がフォームに送った内容を処理できます。新しい応募をまとめる、履歴書から詳細を抜き出す、スキャンした書類を確認する、といった作業です。エージェントは Edge を通して送信内容とファイルを読むので、どの読み取りにも同じ確認がかかります。ファイルはマルウェアスキャンを通過している必要があり、マスキングの設定が適用され、読み取りはすべて記録され、1 つのエージェントやトークンが読める量には 1 日の上限があります。
送信内容は訪問者の個人データです。作業に必要なものだけを読ませ、すべてを読ませないでください。
このページでは、フォームでファイルのアップロードを受け付ける の acme-careers(b6e2c9d1-4f3a-4b7e-9c21-5d8a7f0e3b14)の apply フォームを使います。
送信内容を読める人。 ワークスペースのマネージャーと管理者、そしてその人が接続したエージェントです。パーソナルアクセストークン で読めるのは、作成者が送信内容の権限を明示的に選んだ場合だけです。この権限はどのプリセットにも含まれず、トークンが訪問者の個人データを読めるようになることを Edge が警告します。正確な権限名は 権限スコープ を参照してください。
Web コンソールには まだ送信内容の受信箱がありません。送信内容は、エージェント、CLI、API で読んでください。
1. 最近の送信内容を一覧する
acme-careers の apply フォームに今週届いた送信内容を一覧して。edge api GET "/v1/distributions/b6e2c9d1-4f3a-4b7e-9c21-5d8a7f0e3b14/submissions?form_id=apply&since=2026-10-12T00:00:00Z"curl -s -G \
https://api.edge.deca-dev.com/v1/distributions/b6e2c9d1-4f3a-4b7e-9c21-5d8a7f0e3b14/submissions \
--data-urlencode form_id=apply \
--data-urlencode since=2026-10-12T00:00:00Z \
-H "Authorization: Bearer $EDGE_TOKEN"エージェントは edge_submission_list を実行します。1 ページには最大 50 件の送信内容が、フォームごとに古い順で、フィールドの短いプレビュー付きで入ります。
{
"submissions": [
{
"submission_id": "19a3f0c4e2b5c8d1e3f7",
"form_id": "apply",
"received_at": "2026-10-18T02:41:07.512Z",
"file_count": 1,
"preview": "name: Mika Tanaka · email: mika@example.com · resume: upl_01M4ZK6Q2T9V8X3N5P7R1W4Y6B"
}
],
"cursor": null
}since を省くと、一覧は 30 日前から始まります。form_id を省くと、distribution のすべてのフォームが対象です。cursor が null でなければ、それを渡して次のページを取得します。
2. 1 件の送信内容を読む
acme-careers の送信内容 19a3f0c4e2b5c8d1e3f7 を見せて。edge api GET /v1/distributions/b6e2c9d1-4f3a-4b7e-9c21-5d8a7f0e3b14/submissions/19a3f0c4e2b5c8d1e3f7curl -s \
https://api.edge.deca-dev.com/v1/distributions/b6e2c9d1-4f3a-4b7e-9c21-5d8a7f0e3b14/submissions/19a3f0c4e2b5c8d1e3f7 \
-H "Authorization: Bearer $EDGE_TOKEN"エージェントは edge_submission_get を実行します。応答には、すべてのフィールドと、各ファイルの upload_id、status、has_text を含む files の一覧があります。ファイルを読めるのは status が clean になってからです。ほかの状態については スキャンを確認する を参照してください。
3. 添付ファイルを読む
ファイルの読み方は 3 通りです。
| 出力 | 返すもの | 使う場面 |
|---|---|---|
text | Edge が抽出したテキスト。1 ページ 100,000 文字です。次のページは next_offset を offset として渡します。 | has_text が true の PDF、Word(.docx)、プレーンテキスト、CSV |
content | ファイルそのもの(インライン)。モデルが中身を見られます | 10 MiB までの画像と PDF。テキスト層のないスキャンした履歴書など |
link | 15 分間有効なダウンロード URL | それ以外のファイル、または自分で開きたいファイル |
acme-careers の送信内容 19a3f0c4e2b5c8d1e3f7 に添付された履歴書を読んで、
応募者の経歴を箇条書き 5 つにまとめて。edge api GET "/v1/distributions/b6e2c9d1-4f3a-4b7e-9c21-5d8a7f0e3b14/submissions/19a3f0c4e2b5c8d1e3f7/files/upl_01M4ZK6Q2T9V8X3N5P7R1W4Y6B?output=text"curl -s \
"https://api.edge.deca-dev.com/v1/distributions/b6e2c9d1-4f3a-4b7e-9c21-5d8a7f0e3b14/submissions/19a3f0c4e2b5c8d1e3f7/files/upl_01M4ZK6Q2T9V8X3N5P7R1W4Y6B?output=text" \
-H "Authorization: Bearer $EDGE_TOKEN"エージェントは edge_submission_file_get を実行します。
{
"file": {
"field": "resume",
"upload_id": "upl_01M4ZK6Q2T9V8X3N5P7R1W4Y6B",
"name": "mika-tanaka-cv.pdf",
"type": "application/pdf",
"size": 482113,
"status": "clean",
"reason": null,
"has_text": true
},
"text": "Mika Tanaka\nSenior Backend Engineer\n…",
"offset": 0,
"next_offset": null,
"total_chars": 6214
}履歴書がテキストのないスキャン画像なら、代わりに中身を見るよう頼みます。たとえば「送信内容 19a3f0c4e2b5c8d1e3f7 に添付された履歴書を見て、読み取って」です。エージェントは edge_submission_file_get に content を要求します。API では、output=content がファイルを content_base64 で返します。
自分でファイルをダウンロードするには、GET …/files/{upload_id}/download を使います。60 秒間有効なダウンロードにリダイレクトするので、すぐにリダイレクト先をたどってください。
curl -sL -o mika-tanaka-cv.pdf \
https://api.edge.deca-dev.com/v1/distributions/b6e2c9d1-4f3a-4b7e-9c21-5d8a7f0e3b14/submissions/19a3f0c4e2b5c8d1e3f7/files/upl_01M4ZK6Q2T9V8X3N5P7R1W4Y6B/download \
-H "Authorization: Bearer $EDGE_TOKEN"4. エージェントの読み取りから個人データを隠す(任意)
既定では、エージェントはフィールドと抽出したテキストを訪問者が書いたとおりに見ます。ワークスペースの管理者は、distribution の送信内容をエージェントやトークンが読むとき、メールアドレスなどの PII 検出器に一致した部分を Edge に隠させることができます。
acme-careers で、エージェントとトークンがフォームの送信内容を読むときはメールアドレスをマスクして。edge api PUT /v1/distributions/b6e2c9d1-4f3a-4b7e-9c21-5d8a7f0e3b14/pii-policy --input - <<'EOF'
{
"scope_type": "submission",
"detector_key": "email",
"mode": "redact"
}
EOFcurl -s -X PUT \
https://api.edge.deca-dev.com/v1/distributions/b6e2c9d1-4f3a-4b7e-9c21-5d8a7f0e3b14/pii-policy \
-H "Authorization: Bearer $EDGE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"scope_type": "submission", "detector_key": "email", "mode": "redact"}'エージェントは scope_type を submission にして edge_pii_policy_set を実行します。以降、エージェントとトークンの読み取りでは、フィールド、プレビュー、抽出したテキストの一致した部分が [redacted:email] に置き換わります。その検出器の一致をまた表示するには、mode を allow にします。検出器の一覧は edge_pii_detector_list で確認できます。
この設定が変えるのは表示であり、保存される内容ではありません。
- 自分のサインインで読む人(コンソールと同じ)は、引き続き元の値を見ます。
linkとcontentの読み取りは、ファイルの元のバイトを返します。ファイルはマスクされません。
5. 誰が何を読んだかを確認する
この 30 日間に acme-careers の送信内容を読んだのは誰?edge api GET /v1/distributions/b6e2c9d1-4f3a-4b7e-9c21-5d8a7f0e3b14/submissions/access-logcurl -s \
https://api.edge.deca-dev.com/v1/distributions/b6e2c9d1-4f3a-4b7e-9c21-5d8a7f0e3b14/submissions/access-log \
-H "Authorization: Bearer $EDGE_TOKEN"エージェントは edge_submission_access_log を実行します。一覧、送信内容の読み取り、ファイルのテキスト・リンク・中身の読み取り、ダウンロード、Webhook のダウンロードリンクの使用のたびに、エントリーが 1 件書かれます。エントリーは新しい順に最大 100 件で、since を渡さなければ直近 30 日分です。
{
"entries": [
{
"at": "2026-10-18T03:02:44.118Z",
"action": "file_text",
"actor_type": "agent",
"form_id": "apply",
"submission_id": "19a3f0c4e2b5c8d1e3f7",
"upload_id": "upl_01M4ZK6Q2T9V8X3N5P7R1W4Y6B"
}
]
}各エントリーには id と、読んだ人を示す actor_id もあります。トークンなら token_id、エージェントなら client_id も入ります。
actor_type は agent、pat(パーソナルアクセストークン)、user(サインインした人)、webhook_link のいずれかです。action は list、get、file_text、file_link、file_content、download のいずれかです。エントリーは 1 年間保存されます。
1 日の上限
エージェントとパーソナルアクセストークンは、それぞれ 1 日に送信内容の読み取り 1,000 回、ファイルの読み取り 200 回までです。エージェントは人ごと、トークンはトークンごとに数えます。カウントは 00:00 UTC にリセットされます。上限を超えると、リセットまで読み取りは 429 rate_limited で失敗します。自分のサインインで読む人には上限がありません。
エージェントが上限に達するのは、たいてい作業に必要以上のものを読んでいるときです。1 つのフォーム、短い since の範囲、名前を挙げた送信内容に絞って頼んでください。
次に読む
- フォームでファイルのアップロードを受け付ける
- アナリティクスプロパティを保護する: PII 検出器とモード
- MCP、HTTP API、制限