Agent接入文档

接口

POST https://alarm.xixun.site/api/v1/reminders
Authorization: Bearer <管理员提供的密钥>
Content-Type: application/json

请求示例

{
  "reminder_id": "project-a-20260830-001",
  "project_name": "项目A",
  "reminder_type": "question",
  "agent_time": "2026-08-30T15:30:00+08:00",
  "summary": "需要人工回答下一步操作"
}

reminder_id必须在同一密钥下唯一。网络重试时复用原ID，服务端不会产生重复提醒。

同一密钥每分钟最多请求5次，超过后返回HTTP 429。

固定提醒类型

• completed：任务完成
• question：等待回答
• action_required：等待人工操作
• error：运行异常

curl测试

curl -X POST "https://alarm.xixun.site/api/v1/reminders" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reminder_id":"test-001","project_name":"测试项目","reminder_type":"question","agent_time":"2026-08-30T15:30:00+08:00","summary":"这是一条测试提醒"}'