> ## 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`는 작업을 식별합니다.

    `taskName`은 표시 이름입니다.

    `taskDescription`은 가능한 경우 간단한 작업 요약을 제공합니다.
  </Accordion>

  <Accordion title="페이지 넘기기 필드">`page`, `size`, `total`, `totalPages`는 결과 집합을 설명합니다.</Accordion>
  <Accordion title="다음 호출">`suggestedNextCall`, `workflow`, `toolHint`에 따라 `startOrStopTask` 또는 `exportData` 호출 여부를 결정하세요.</Accordion>
</AccordionGroup>