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

# Cercare attività

> Cerca le attività Octoparse esistenti prima di avviarle, interromperle o esportarle tramite AgentTools.

<Info>Gli esempi generati di richiesta e risposta sono disponibili nel pannello API. Usa questa pagina per comprendere il flusso di lavoro delle attività esistenti.</Info>

Cerca le attività Octoparse esistenti prima di controllarle o esportarle tramite AgentTools.

<Steps>
  <Step title="Trovare un’attività">Usa `keyword`, `status` o `taskIds` per individuare le attività esistenti.</Step>
  <Step title="Leggere lo stato normalizzato">Usa `taskStatusLabel` per lo stato mostrato all’utente e `rawTaskStatusCode` per la diagnostica di basso livello.</Step>
  <Step title="Proseguire il flusso di lavoro">Usa il `taskId` restituito con `startOrStopTask` o `exportData`.</Step>
</Steps>

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

<CardGroup cols={2}>
  <Card title="Header obbligatorio" icon="user">`x-external-user-id` è obbligatorio per cercare le attività.</Card>
  <Card title="Filtri di stato" icon="sliders-horizontal">I valori supportati sono `Running`, `Stopped`, `Completed` e `Failed`.</Card>
</CardGroup>

<AccordionGroup>
  <Accordion title="Campi dell’attività">
    `taskId` identifica l’attività.

    `taskName` è il nome visualizzato.

    `taskDescription` fornisce un breve riepilogo dell’attività, quando disponibile.
  </Accordion>

  <Accordion title="Campi di impaginazione">`page`, `size`, `total` e `totalPages` descrivono il set di risultati.</Accordion>
  <Accordion title="Chiamata successiva">Segui `suggestedNextCall`, `workflow` e `toolHint` per scegliere se chiamare `startOrStopTask` o `exportData`.</Accordion>
</AccordionGroup>