time

name	time
description	时间工具 — 获取当前 UTC/本地时间、可控延时。当 Agent 需要知道当前时间或等待时使用。
version	1.1
category	core
enabled	true
tags	["time","core","utility"]

时间工具 (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 返回的是服务器时间，不是用户本地时间（尽管通常含本地时区偏移）