Schedules

按周期性的 UTC cron 计划运行 agent 任务——每日摘要、每周报告、定期检查。每次触发都是一次普通的 agent 运行。

创建一个 Schedule

POST/v1/workspaces/{workspace_id}/schedules —

请求体：name、cron_expr（5 段式 UTC cron）和 task_text 为必填；可选 project_id、model_id、max_steps、budget_usd、enabled。

bash

curl https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/schedules \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Daily FX digest",
    "cron_expr": "0 7 * * *",
    "task_text": "Summarize overnight moves in USD/SGD and EUR/USD.",
    "budget_usd": 0.3
  }'

管理与查看

GET/v1/workspaces/{workspace_id}/schedules —

PATCH/v1/workspaces/{workspace_id}/schedules/{schedule_id} —

DELETE/v1/workspaces/{workspace_id}/schedules/{schedule_id} —

列出、更新（包括通过 enabled 暂停）、删除。

POST/v1/workspaces/{workspace_id}/schedules/{schedule_id}/run-now —

立即触发一次。

GET/v1/workspaces/{workspace_id}/schedules/{schedule_id}/runs —

近期的触发记录及其结果。

每次触发与普通 agent 运行一样从工作区余额扣费，并受该定时任务的 budget_usd 约束。可配合 webhooks 在计划的运行完成时获得通知。