Schedules

以週期性 UTC cron 排程執行 agent 任務——每日摘要、每週報告、定期檢查。每次觸發都是一次普通的 agent run。

建立排程

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

body：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 run 一樣會消耗 workspace 餘額，並受排程的 budget_usd 約束。可搭配 webhooks 在排程 run 完成時收到通知。