> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# タスク実行

> AgentToolsテンプレートからスクレイピングタスクを作成して開始します。

<Info>
  リクエストボディ、生成されたcURL例、レスポンススキーマはAPIパネルに表示されます。このページでは、実行時に見落としやすいルールを説明します。
</Info>

`searchTemplates`で返されたテンプレートからスクレイピングタスクを作成して開始します。

<Steps>
  <Step title="テンプレートを選ぶ">
    `searchTemplates`で返された`templateName`を渡します。
  </Step>

  <Step title="parametersを文字列化する">
    `parameters`はJSONオブジェクトを文字列化して送信します。
  </Step>

  <Step title="サーバーのガイダンスに従う">
    固定のポーリング間隔ではなく、`retryGuidance`、`suggestedNextCall`、`workflow`、`toolHint`を使用します。
  </Step>
</Steps>

```text theme={null}
searchTemplates -> executeTask -> exportData
```

<CardGroup cols={2}>
  <Card title="必須ヘッダー" icon="user">
    ユーザー単位の実行には`x-external-user-id`が必須です。
  </Card>

  <Card title="行数上限" icon="list-ordered">
    `targetMaxRows`は任意で、`0`から`1000000`まで指定できます。
  </Card>
</CardGroup>

<Warning>
  ソース連動フィールドではオプションキーを使用してください。`MultiInput`や複数選択型のフィールドでは、値が1つでも配列を使用します。
</Warning>

<AccordionGroup>
  <Accordion title="リクエストボディ">
    `templateName`は必須です。

    `taskName`は任意です。

    `parameters`は任意ですが、指定する場合は文字列化されたJSONオブジェクトである必要があります。

    `targetMaxRows`は任意です。
  </Accordion>

  <Accordion title="ステータス値">
    `accepted`: タスクが実行対象として受け付けられました。

    `ready`: データをエクスポートできる可能性があります。

    `awaiting_source_selection`: ソース連動フィールドに有効なオプションキーが必要です。

    `invalid`、`start_failed`、`failed`: `recoverySuggestion`、`blockingIssues`、`missingParamNames`、`invalidSourceSelections`を確認してください。
  </Accordion>

  <Accordion title="重要なレスポンスフィールド">
    `taskId`はエクスポートや確認に使用するタスクIDです。

    `lotNo`はバッチまたは実行回を表します。返された場合は`exportData`に渡します。

    `recoverySuggestion`、`blockingIssues`、`missingParamNames`、`invalidSourceSelections`は、不正な呼び出しを修正するための情報です。
  </Accordion>
</AccordionGroup>