Ejecutar una tarea
AgentTools API
Ejecutar una tarea
Crea e inicia una tarea de web scraping a partir de una plantilla de AgentTools.
POST
Ejecutar una tarea
El cuerpo de la solicitud, el ejemplo de cURL generado y el esquema de respuesta aparecen en el panel de la API. Consulta esta página para conocer reglas de ejecución que pueden pasar desapercibidas.
searchTemplates.
1
Elegir una plantilla
Pasa el valor
templateName de searchTemplates.2
Serializar los parámetros
Envía
parameters como un objeto JSON serializado en forma de cadena.3
Seguir las indicaciones del servidor
Usa
retryGuidance, suggestedNextCall, workflow y toolHint en lugar de intervalos de consulta fijos.Encabezado obligatorio
x-external-user-id es obligatorio para una ejecución limitada al usuario.Límite de filas
targetMaxRows es opcional y acepta valores de 0 a 1000000.Campos del cuerpo de la solicitud
Campos del cuerpo de la solicitud
templateName es obligatorio.taskName es opcional.parameters es opcional, pero, si se proporciona, debe ser un objeto JSON serializado.targetMaxRows es opcional.Valores de estado
Valores de estado
accepted: la tarea se aceptó para su ejecución.ready: los datos pueden estar listos para exportarse.awaiting_source_selection: un campo basado en una fuente necesita una clave de opción válida.invalid, start_failed y failed: comprueba recoverySuggestion, blockingIssues, missingParamNames e invalidSourceSelections.Campos importantes de la respuesta
Campos importantes de la respuesta
taskId identifica la tarea que se va a exportar o consultar.lotNo identifica el lote o la ejecución. Pásalo a exportData cuando se devuelva.recoverySuggestion, blockingIssues, missingParamNames e invalidSourceSelections ayudan al cliente a corregir llamadas no válidas.