タスク実行
AgentTools API
タスク実行
AgentToolsテンプレートからスクレイピングタスクを作成して開始します。
POST
タスク実行
リクエストボディ、生成されたcURL例、レスポンススキーマはAPIパネルに表示されます。このページでは、実行時に見落としやすいルールを説明します。
searchTemplatesで返されたテンプレートからスクレイピングタスクを作成して開始します。
1
テンプレートを選ぶ
searchTemplatesで返されたtemplateNameを渡します。2
parametersを文字列化する
parametersはJSONオブジェクトを文字列化して送信します。3
サーバーのガイダンスに従う
固定のポーリング間隔ではなく、
retryGuidance、suggestedNextCall、workflow、toolHintを使用します。必須ヘッダー
ユーザー単位の実行には
x-external-user-idが必須です。行数上限
targetMaxRowsは任意で、0から1000000まで指定できます。リクエストボディ
リクエストボディ
templateNameは必須です。taskNameは任意です。parametersは任意ですが、指定する場合は文字列化されたJSONオブジェクトである必要があります。targetMaxRowsは任意です。ステータス値
ステータス値
accepted: タスクが実行対象として受け付けられました。ready: データをエクスポートできる可能性があります。awaiting_source_selection: ソース連動フィールドに有効なオプションキーが必要です。invalid、start_failed、failed: recoverySuggestion、blockingIssues、missingParamNames、invalidSourceSelectionsを確認してください。重要なレスポンスフィールド
重要なレスポンスフィールド
taskIdはエクスポートや確認に使用するタスクIDです。lotNoはバッチまたは実行回を表します。返された場合はexportDataに渡します。recoverySuggestion、blockingIssues、missingParamNames、invalidSourceSelectionsは、不正な呼び出しを修正するための情報です。