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

# Buscar tareas

> Busca tareas existentes de Octoparse antes de iniciarlas, detenerlas o exportarlas mediante AgentTools.

<Info>Los ejemplos generados de solicitud y respuesta se muestran en el panel de la API. Usa esta página para comprender el flujo de trabajo de tareas existentes.</Info>

Busca tareas existentes de Octoparse antes de controlarlas o exportarlas mediante AgentTools.

<Steps>
  <Step title="Encontrar una tarea">Usa `keyword`, `status` o `taskIds` para localizar tareas existentes.</Step>
  <Step title="Leer el estado normalizado">Usa `taskStatusLabel` para el estado visible para el usuario y `rawTaskStatusCode` para diagnósticos de bajo nivel.</Step>
  <Step title="Continuar el flujo de trabajo">Usa el `taskId` devuelto con `startOrStopTask` o `exportData`.</Step>
</Steps>

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

<CardGroup cols={2}>
  <Card title="Encabezado obligatorio" icon="user">`x-external-user-id` es obligatorio para buscar tareas.</Card>
  <Card title="Filtros de estado" icon="sliders-horizontal">Los valores admitidos son `Running`, `Stopped`, `Completed` y `Failed`.</Card>
</CardGroup>

<AccordionGroup>
  <Accordion title="Campos de tarea">
    `taskId` identifica la tarea.

    `taskName` es el nombre para mostrar.

    `taskDescription` proporciona un resumen breve de la tarea cuando está disponible.
  </Accordion>

  <Accordion title="Campos de paginación">`page`, `size`, `total` y `totalPages` describen el conjunto de resultados.</Accordion>
  <Accordion title="Siguiente llamada">Sigue `suggestedNextCall`, `workflow` y `toolHint` para decidir si debes llamar a `startOrStopTask` o `exportData`.</Accordion>
</AccordionGroup>