时间工具 (Time)
基础时间查询和延时功能。
插件路径
plugins/time/
注册工具
| 工具 | 用途 |
|---|---|
get_time |
获取当前 UTC 和本地时间(含时区偏移) |
sleep |
休眠指定秒数(上限 30 分钟 / 1800 秒) |
参数
sleep
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
seconds |
number | 是 | 休眠秒数,范围 1-1800 |
结果说明
get_time:返回当前 UTC 时间和本地时间(含时区偏移信息)sleep:休眠结束后返回(无特殊输出)- 参数越界:返回
ERROR:前缀的错误信息
常见规范
sleep不受全局tool.tool_timeout截断,但自身保留 1800 秒硬上限- 用于用户明确要求"等一会儿"、"稍后继续"、"延迟执行"的场景
get_time用于需要知道当前时间、计算时间差、判断时区的场景
常见处理办法
- seconds 超出范围:范围 1-1800,超出会报错
- sleep 阻塞时间过长:最大 30 分钟,如需更长等待建议用定时任务
常见教训
sleep会阻塞当前工具调用线程,不要用于不需要实际等待的场景get_time返回的是服务器时间,不是用户本地时间(尽管通常含本地时区偏移)