Time

时间工具 — 获取当前 UTC/本地时间、可控延时。当 Agent 需要知道当前时间或等待时使用。

kesepain-ke Updated

File contents

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

kesepain-ke/votx-agent/tree/main/plugins/time commit 476eeb0b71

Frequently asked questions

npx skillmds@latest add kesepain-ke/time