> ## 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で開始、停止、エクスポートする前に既存のOctoparseタスクを検索します。

<Info>
  生成されたリクエスト例とレスポンス例はAPIパネルに表示されます。このページでは既存タスクフローの使い方を説明します。
</Info>

AgentToolsで制御またはエクスポートする前に、既存のOctoparseタスクを検索します。

<Steps>
  <Step title="タスクを探す">
    `keyword`、`status`、`taskIds`を使って既存タスクを検索します。
  </Step>

  <Step title="正規化されたステータスを読む">
    ユーザー向け表示には`taskStatusLabel`、詳細な診断には`rawTaskStatusCode`を使用します。
  </Step>

  <Step title="ワークフローを続ける">
    返された`taskId`を`startOrStopTask`または`exportData`で使用します。
  </Step>
</Steps>

```text theme={null}
searchTasks -> startOrStopTask -> exportData
```

<CardGroup cols={2}>
  <Card title="必須ヘッダー" icon="user">
    タスク検索には`x-external-user-id`が必須です。
  </Card>

  <Card title="ステータスフィルター" icon="sliders-horizontal">
    `Running`、`Stopped`、`Completed`、`Failed`をサポートします。
  </Card>
</CardGroup>

<AccordionGroup>
  <Accordion title="タスクフィールド">
    `taskId`はタスクIDです。

    `taskName`は表示名です。

    `taskDescription`は、利用可能な場合に短いタスク概要を返します。
  </Accordion>

  <Accordion title="ページングフィールド">
    `page`、`size`、`total`、`totalPages`は検索結果のページング情報です。
  </Accordion>

  <Accordion title="次に呼び出すAPI">
    `startOrStopTask`または`exportData`を呼び出すかどうかは、`suggestedNextCall`、`workflow`、`toolHint`に従って判断してください。
  </Accordion>
</AccordionGroup>