Skip to content

フォームの送信内容をエージェントに読ませる ​

エージェントは、訪問者がフォームに送った内容を処理できます。新しい応募をまとめる、履歴書から詳細を抜き出す、スキャンした書類を確認する、といった作業です。エージェントは Edge を通して送信内容とファイルを読むので、どの読み取りにも同じ確認がかかります。ファイルはマルウェアスキャンを通過している必要があり、マスキングの設定が適用され、読み取りはすべて記録され、1 つのエージェントやトークンが読める量には 1 日の上限があります。

送信内容は訪問者の個人データです。作業に必要なものだけを読ませ、すべてを読ませないでください。

このページでは、フォームでファイルのアップロードを受け付ける の acme-careers(b6e2c9d1-4f3a-4b7e-9c21-5d8a7f0e3b14)の apply フォームを使います。

送信内容を読める人。 ワークスペースのマネージャーと管理者、そしてその人が接続したエージェントです。パーソナルアクセストークン で読めるのは、作成者が送信内容の権限を明示的に選んだ場合だけです。この権限はどのプリセットにも含まれず、トークンが訪問者の個人データを読めるようになることを Edge が警告します。正確な権限名は 権限スコープ を参照してください。

Web コンソールには まだ送信内容の受信箱がありません。送信内容は、エージェント、CLI、API で読んでください。

1. 最近の送信内容を一覧する ​

text
acme-careers の apply フォームに今週届いた送信内容を一覧して。
bash
edge api GET "/v1/distributions/b6e2c9d1-4f3a-4b7e-9c21-5d8a7f0e3b14/submissions?form_id=apply&since=2026-10-12T00:00:00Z"
bash
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 件の送信内容が、フォームごとに古い順で、フィールドの短いプレビュー付きで入ります。

json
{
  "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 件の送信内容を読む ​

text
acme-careers の送信内容 19a3f0c4e2b5c8d1e3f7 を見せて。
bash
edge api GET /v1/distributions/b6e2c9d1-4f3a-4b7e-9c21-5d8a7f0e3b14/submissions/19a3f0c4e2b5c8d1e3f7
bash
curl -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 通りです。

出力返すもの使う場面
textEdge が抽出したテキスト。1 ページ 100,000 文字です。次のページは next_offset を offset として渡します。has_text が true の PDF、Word(.docx)、プレーンテキスト、CSV
contentファイルそのもの(インライン)。モデルが中身を見られます10 MiB までの画像と PDF。テキスト層のないスキャンした履歴書など
link15 分間有効なダウンロード URLそれ以外のファイル、または自分で開きたいファイル
text
acme-careers の送信内容 19a3f0c4e2b5c8d1e3f7 に添付された履歴書を読んで、
応募者の経歴を箇条書き 5 つにまとめて。
bash
edge api GET "/v1/distributions/b6e2c9d1-4f3a-4b7e-9c21-5d8a7f0e3b14/submissions/19a3f0c4e2b5c8d1e3f7/files/upl_01M4ZK6Q2T9V8X3N5P7R1W4Y6B?output=text"
bash
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 を実行します。

json
{
  "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 秒間有効なダウンロードにリダイレクトするので、すぐにリダイレクト先をたどってください。

bash
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 に隠させることができます。

text
acme-careers で、エージェントとトークンがフォームの送信内容を読むときはメールアドレスをマスクして。
bash
edge api PUT /v1/distributions/b6e2c9d1-4f3a-4b7e-9c21-5d8a7f0e3b14/pii-policy --input - <<'EOF'
{
  "scope_type": "submission",
  "detector_key": "email",
  "mode": "redact"
}
EOF
bash
curl -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. 誰が何を読んだかを確認する ​

text
この 30 日間に acme-careers の送信内容を読んだのは誰?
bash
edge api GET /v1/distributions/b6e2c9d1-4f3a-4b7e-9c21-5d8a7f0e3b14/submissions/access-log
bash
curl -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 日分です。

json
{
  "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 の範囲、名前を挙げた送信内容に絞って頼んでください。

次に読む ​