> ## 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`를 문자열로 직렬화한 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 및 다중 선택과 유사한 필드는 항목이 하나여도 배열을 사용해야 합니다.</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`는 내보내거나 확인할 작업을 식별합니다.

    `lotNo`는 배치 또는 실행을 식별합니다. 반환되면 `exportData`에 전달하세요.

    `recoverySuggestion`, `blockingIssues`, `missingParamNames`, `invalidSourceSelections`는 클라이언트가 잘못된 호출을 수정하는 데 도움이 됩니다.
  </Accordion>
</AccordionGroup>