CreatePolarClawCronJob - PolarDB - Centro de documentación de Alibaba Cloud

Crea una tarea programada de PolarClaw.

Descripción de la operación

Solicitud

Utilice esta API para crear un trabajo cron. Puede configurar la carga útil del trabajo, la frecuencia de ejecución, la zona horaria, el canal de destino, los destinatarios y un mecanismo de alerta por fallos.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

No se requiere autorización para esta operación. Si experimenta problemas al ejecutarla, póngase en contacto con el soporte técnico.

Sintaxis de la solicitud

POST  HTTP/1.1

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
ApplicationId	string	Sí	El ID de la aplicación.	pa-**************
Name	string	Sí	El nombre único de la tarea.	daily-report
Schedule	object	Sí	La configuración de programación.	{"Kind":"cron","Expr":"0 9 * * *","Tz":"Asia/Shanghai"}
Kind	string	No	El tipo de programación.	cron
Expr	string	No	La expresión cron que especifica cuándo se ejecuta la tarea.	0 9 * * *
Tz	string	No	La zona horaria para la programación.	Asia/Shanghai
StaggerMs	integer	No	La ventana de variación determinista, en milisegundos.	0
EveryMs	integer	No	El intervalo de ejecución de la tarea, en milisegundos.	100000
AnchorMs	integer	No	La marca de tiempo de anclaje para alinear programaciones basadas en intervalos, en milisegundos.	1777370572518
At	string	No	La hora específica para una ejecución única, especificada como una marca de tiempo ISO 8601.	2026-04-10T09:00:00+08:00
SessionTarget	string	Sí	El destino de la sesión. Los valores válidos son `main`, `isolated` y `current`.	main
WakeMode	string	Sí	El modo de activación para el agente. Los valores válidos son `now` y `next-heartbeat`.	now
Payload	object	Sí	La configuración de la carga útil de ejecución.	{"Kind":"agentTurn","Message":"Genere el informe diario."}
Kind	string	No	El tipo de carga útil. Los valores válidos son `agentTurn` y `systemEvent`.	systemEvent
Message	string	No	El prompt para una conversación con el agente, utilizado cuando `Kind` es `agentTurn`.	Genere el informe diario
Text	string	No	El texto para el evento del sistema, utilizado cuando `Kind` es `systemEvent`.	Genere el informe diario
Model	string	No	Especifica un modelo que anula el modelo predeterminado del agente.	bailian/qwen3.5-plus
Fallbacks	array	No	Una lista de modelos alternativos para usar si el modelo principal falla.
	string	No	Un modelo alternativo.	bailian/qwen-max
Thinking	string	No	El nivel de razonamiento para la generación de respuestas del agente. Los valores válidos son `off`, `minimal`, `low`, `medium`, `high` y `xhigh`.	xhigh
TimeoutSeconds	integer	No	El tiempo de espera de ejecución, en segundos.	10
LightContext	boolean	No	Especifica si se debe utilizar un contexto ligero para la conversación con el agente.	false
Deliver	boolean	No	Especifica si se debe entregar la salida del agente a un canal.	true
Channel	string	No	El ID del canal de entrega.	feishu
To	string	No	El destino o destinatario específico dentro del canal.	ou_***
BestEffortDeliver	boolean	No	Especifica si se debe utilizar la entrega con mejor esfuerzo. Si es `true`, se ignoran los fallos de entrega.	false
AgentId	string	No	El ID del agente que ejecuta la tarea.	main
SessionKey	string	No	La clave de enrutamiento de sesión, que determina la sesión de conversación para la tarea.	agent:main:feishu:direct:***
Description	string	No	Una descripción de la tarea.	Generación de informe diario
Enabled	boolean	No	Especifica si el trabajo cron está habilitado. Valor predeterminado: `true`.	true
DeleteAfterRun	boolean	No	Especifica si se debe eliminar automáticamente el trabajo después de su primera ejecución. Esto es útil para tareas únicas. Valor predeterminado: `false`.	false
Delivery	object	No	La configuración para la entrega de los resultados de ejecución de la tarea.	{"Mode":"announce","Channel":"telegram"}
Mode	string	No	El modo de entrega. Los valores válidos son `none`, `announce` y `webhook`.	announce
Channel	string	No	El canal de entrega.	feishu
AccountId	string	No	El ID de cuenta para el canal de entrega.	default
To	string	No	El destinatario de la entrega.	ou_***
BestEffort	boolean	No	Especifica si se debe utilizar la entrega con mejor esfuerzo. Si es `true`, se ignoran los fallos de entrega.	false
FailureAlert	object	No	La configuración de alerta por fallos.	{"After":3,"Channel":"telegram"}
After	integer	No	El número de fallos consecutivos necesarios para activar una alerta.	3
Channel	string	No	El canal para enviar alertas por fallos.	feishu
AccountId	string	No	El ID de cuenta para el canal de alertas.	default
To	string	No	El destinatario de la alerta por fallos.	ou_***
CooldownMs	integer	No	El periodo de enfriamiento, en milisegundos, entre alertas para el mismo trabajo.	5000
Mode	string	No	El modo para enviar alertas. Los valores válidos son `announce` y `webhook`.	announce
RunImmediately	boolean	No	Especifica si se debe ejecutar el trabajo una vez inmediatamente después de su creación. Valor predeterminado: `false`.	false
Restart	boolean	No	Especifica si se debe reiniciar la puerta de enlace tras la creación del trabajo. Valor predeterminado: `true`.	true

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Esquema de la respuesta.
RequestId	string	El ID de la solicitud.	6BD9CDE4-5E7B-4BF3-9BB8-83C73E******
Message	string	El mensaje de la respuesta.	successful
Code	integer	El código de estado de la respuesta.	200
ApplicationId	string	El ID de la aplicación.	pa-**************
Ok	boolean	Indica si la operación se realizó correctamente.	true
Job	object	Detalles del trabajo cron creado.
Id	string	El ID del trabajo (UUID).	e2c57423-12f0-45cc-a387-6155168b3201
Name	string	El nombre del trabajo.	test
Enabled	boolean	Indica si el trabajo cron está habilitado.	true
DeleteAfterRun	boolean	Indica si el trabajo cron se elimina después de su primera ejecución.	false
CreatedAtMs	integer	La marca de tiempo de creación en milisegundos.	1777368967284
UpdatedAtMs	integer	La marca de tiempo de actualización en milisegundos.	1777370572517
Schedule	object	La configuración de programación.
Kind	string	El tipo de programación. Valores válidos: `cron`, `every` y `at`.	cron
Expr	string	La expresión cron.	0 9 * * *
Tz	string	La zona horaria IANA.	Asia/Shanghai
EveryMs	integer	El intervalo en milisegundos.	1000
AnchorMs	integer	La marca de tiempo de anclaje para la alineación del intervalo.	1777370572518
At	string	La marca de tiempo ISO 8601.	2026-04-10T09:00:00+08:00
SessionTarget	string	El destino de la sesión. Valores válidos: `main`, `isolated` y `current`.	main
WakeMode	string	El modo de activación. Valores válidos: `now` y `next-heartbeat`.	now
Payload	object	La carga útil de ejecución.
Kind	string	El tipo de carga útil. Valores válidos: `agentTurn` y `systemEvent`.	agentTurn
Message	string	El prompt del agente.	Genere el informe diario
Text	string	El texto del evento del sistema.	Genere el informe diario
Model	string	El modelo de reemplazo.	bailian/qwen3.5-plus
TimeoutSeconds	integer	El tiempo de espera de ejecución en segundos.	10
LightContext	boolean	Indica si se debe usar un contexto ligero.	false
Deliver	boolean	Indica si se debe entregar la salida al canal de entrega.	false
Channel	string	El ID del canal de entrega.	feishu
To	string	El destinatario.	ou_***
BestEffortDeliver	boolean	Especifica si se deben ignorar los fallos de entrega.	false
AgentId	string	El ID del agente que ejecuta.	main
SessionKey	string	La clave de la sesión.	agent:main:feishu:direct:***
Description	string	La descripción del trabajo.	test
Delivery	object	La configuración de entrega.
Mode	string	El modo de entrega. Valores válidos: `none`, `announce` y `webhook`.	announce
Channel	string	El canal de entrega.	feishu
AccountId	string	El ID de la cuenta del canal.	default
To	string	El destinatario.	ou_***
BestEffort	boolean	Especifica si se deben ignorar los fallos de entrega.	false
State	object	El estado actual del trabajo.
NextRunAtMs	integer	La marca de tiempo de la próxima ejecución en milisegundos.	1777424400000
LastRunAtMs	integer	La marca de tiempo de la última ejecución en milisegundos.	1777370544931
LastRunStatus	string	El estado de la última ejecución.	ok
ConsecutiveErrors	integer	El número de fallos de ejecución consecutivos.	0
Runs	array<object>	El historial de ejecuciones.
	array<object>
Ts	integer	La marca de tiempo de la ejecución en milisegundos.	1777370572518
JobId	string	El ID del trabajo asociado.	f83f5278-1abe-40a6-b10e-ad3ecdc05de2
Action	string	La acción realizada. Valores válidos: `finished`, `error` y `skipped`.	finished
Status	string	El estado de la ejecución. Valores válidos: `ok`, `error` y `skipped`.	ok
Summary	string	El resumen de la ejecución.	Genere el informe diario
Delivered	boolean	Especifica si los resultados se entregaron.	false
DeliveryStatus	string	El estado de la entrega.	not-requested
SessionId	string	El ID de la sesión asociada.	***
RunAtMs	integer	La marca de tiempo real de ejecución en milisegundos.	1777370544931
DurationMs	integer	La duración de la ejecución en milisegundos.	27586
NextRunAtMs	integer	La marca de tiempo de la próxima ejecución en milisegundos.	1777424400000
Model	string	El modelo utilizado para la ejecución.	bailian/qwen3.5-plus
Provider	string	El proveedor del modelo.	bailian
Usage	object	Los detalles de uso de tokens.
InputTokens	integer	El número de tokens de entrada.	30250
OutputTokens	integer	El número de tokens de salida.	30250
TotalTokens	integer	El número total de tokens.	60500
JobName	string	El nombre del trabajo.	test
RanImmediately	boolean	Indica si el trabajo se ejecutó inmediatamente después de su creación.	false

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "6BD9CDE4-5E7B-4BF3-9BB8-83C73E******",
  "Message": "successful",
  "Code": 200,
  "ApplicationId": "pa-**************",
  "Ok": true,
  "Job": {
    "Id": "e2c57423-12f0-45cc-a387-6155168b3201",
    "Name": "test",
    "Enabled": true,
    "DeleteAfterRun": false,
    "CreatedAtMs": 1777368967284,
    "UpdatedAtMs": 1777370572517,
    "Schedule": {
      "Kind": "cron",
      "Expr": "0 9 * * *",
      "Tz": "Asia/Shanghai",
      "EveryMs": 1000,
      "AnchorMs": 1777370572518,
      "At": "2026-04-10T09:00:00+08:00"
    },
    "SessionTarget": "main",
    "WakeMode": "now",
    "Payload": {
      "Kind": "agentTurn",
      "Message": "Generate the daily report.",
      "Text": "Generate the daily report.",
      "Model": "bailian/qwen3.5-plus",
      "TimeoutSeconds": 10,
      "LightContext": false,
      "Deliver": false,
      "Channel": "feishu",
      "To": "ou_***",
      "BestEffortDeliver": false
    },
    "AgentId": "main",
    "SessionKey": "agent:main:feishu:direct:***",
    "Description": "test",
    "Delivery": {
      "Mode": "announce",
      "Channel": "feishu",
      "AccountId": "default",
      "To": "ou_***",
      "BestEffort": false
    },
    "State": {
      "NextRunAtMs": 1777424400000,
      "LastRunAtMs": 1777370544931,
      "LastRunStatus": "ok",
      "ConsecutiveErrors": 0
    },
    "Runs": [
      {
        "Ts": 1777370572518,
        "JobId": "f83f5278-1abe-40a6-b10e-ad3ecdc05de2",
        "Action": "finished",
        "Status": "ok",
        "Summary": "Generate the daily report.",
        "Delivered": false,
        "DeliveryStatus": "not-requested",
        "SessionId": "***",
        "RunAtMs": 1777370544931,
        "DurationMs": 27586,
        "NextRunAtMs": 1777424400000,
        "Model": "bailian/qwen3.5-plus",
        "Provider": "bailian",
        "Usage": {
          "InputTokens": 30250,
          "OutputTokens": 30250,
          "TotalTokens": 60500
        },
        "JobName": "test"
      }
    ]
  },
  "RanImmediately": false
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.