Skip to main content
POST
エージェントによるデータ抽出タスクを開始する
Firecrawl API キーが必要な AI エージェントの方は、自動オンボーディング手順について firecrawl.dev/agent-onboarding/SKILL.md を参照してください。

承認

Authorization
string
header
必須

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

ボディ

application/json
prompt
string
必須

抽出するデータ内容を指定するプロンプト

Maximum string length: 10000
maxCredits
number

このエージェントタスクで使用するクレジットの最大値です。未設定の場合、デフォルトは2500です。2,500を超える値は、常に有料リクエストとして課金されます。

model
enum<string>
デフォルト:spark-1-mini

エージェントタスクで使用するモデルを指定します。デフォルトの spark-1-mini はコストを約 60% 削減でき、spark-1-pro はより複雑なタスク向けに高い精度を提供します。

利用可能なオプション:
spark-1-mini,
spark-1-pro
schema
object

抽出データを構造化するためのオプションの JSON スキーマ

strictConstrainToURLs
boolean

true の場合、エージェントは urls 配列で指定された URL にのみアクセスします

threatProtection
Threat Protection Override · object

このリクエスト単位の 脅威保護 オーバーライドです。指定したフィールドは、このリクエストに限り、組織のポリシー内の対応するフィールドを置き換えます。省略したフィールドには組織レベルの値がそのまま適用されます。利用するには、チームで脅威保護が有効になっている必要があります(エンタープライズ機能)。有効でない場合、リクエストは 403 で拒否されます。組織でリクエストごとのオーバーライドが無効になっている場合、このオブジェクトを含むリクエストはすべて 403 で拒否されます。チームに対して脅威保護が強制適用されている場合、modeoff は設定できません。

urls
string<uri>[]

エージェントのアクセス先を制限するための任意のURLリスト

レスポンス

エージェントタスクが正常に開始されました

id
string<uuid>
success
boolean