> ## 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.

# Esegui attività

> Crea e avvia un'attività di scraping da un modello AgentTools.

<Info>
  Il corpo della richiesta, l'esempio cURL generato e lo schema della risposta sono mostrati nel pannello API. Usa questa pagina per le regole di esecuzione che è facile trascurare.
</Info>

Crea e avvia un'attività di scraping da un modello restituito da `searchTemplates`.

<Steps>
  <Step title="Scegli un modello">
    Passa il valore `templateName` ottenuto da `searchTemplates`.
  </Step>

  <Step title="Serializza i parametri">
    Invia `parameters` come oggetto JSON serializzato in una stringa.
  </Step>

  <Step title="Segui le indicazioni del server">
    Usa `retryGuidance`, `suggestedNextCall`, `workflow` e `toolHint` invece di intervalli di polling fissi.
  </Step>
</Steps>

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

<CardGroup cols={2}>
  <Card title="Header obbligatorio" icon="user">
    `x-external-user-id` è obbligatorio per l'esecuzione con ambito utente.
  </Card>

  <Card title="Limite di righe" icon="list-ordered">
    `targetMaxRows` è facoltativo e accetta valori da `0` a `1000000`.
  </Card>
</CardGroup>

<Warning>
  I campi associati a una sorgente devono usare le chiavi delle opzioni. I campi MultiInput e quelli simili a selezioni multiple devono usare array, anche per un solo elemento.
</Warning>

<AccordionGroup>
  <Accordion title="Campi del corpo della richiesta">
    `templateName` è obbligatorio.

    `taskName` è facoltativo.

    `parameters` è facoltativo, ma quando viene fornito deve essere un oggetto JSON serializzato.

    `targetMaxRows` è facoltativo.
  </Accordion>

  <Accordion title="Valori di stato">
    `accepted`: l'attività è stata accettata per l'esecuzione.

    `ready`: i dati potrebbero essere pronti per l'esportazione.

    `awaiting_source_selection`: un campo associato a una sorgente richiede una chiave di opzione valida.

    `invalid`, `start_failed` e `failed`: controlla `recoverySuggestion`, `blockingIssues`, `missingParamNames` e `invalidSourceSelections`.
  </Accordion>

  <Accordion title="Campi importanti della risposta">
    `taskId` identifica l'attività da esportare o esaminare.

    `lotNo` identifica il batch o l'esecuzione. Quando viene restituito, passalo a `exportData`.

    `recoverySuggestion`, `blockingIssues`, `missingParamNames` e `invalidSourceSelections` aiutano il client a correggere le chiamate non valide.
  </Accordion>
</AccordionGroup>