MuleRun时间区间计算需规范输入、启用TimeParser Skill或绑定Knowledge源，支持自然语言指令、自定义Agent、Python脚本及API调用四种方法。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用MuleRun进行任务管理或项目协作时，需要精确统计某项工作的起止时间、持续时长或跨日周期，但系统未自动显示时间区间结果，则可能是由于输入格式不规范、未启用时间解析技能或未绑定对应Knowledge源。以下是实现时间区间计算的多种方法：
一、通过自然语言指令触发内置时间解析Agent
该方法利用MuleRun已预置的时间语义理解能力，无需编写代码，适用于日常工时记录、会议时长统计等轻量场景。系统会自动识别“从…到…”、“持续…天”、“X月X日-X月X日”等结构化表达，并输出毫秒级精度的差值。
1、在任意可输入指令的Agent交互框中，键入类似表述：计算2026年3月10日14:30到2026年3月15日09:15之间的总小时数。
2、确认当前所用Agent已加载“TimeParser Skill”，可在Agent详情页的Skills列表中查看是否包含此项。
3、发送后等待响应，结果将以总时长：115.25小时（即115小时15分钟）格式返回，并附带毫秒级原始数值。
二、调用Mule Agent Builder构建自定义时间区间计算器
当标准解析无法满足复杂逻辑（如排除周末、按工作日8小时制折算、叠加节假日规则）时，可通过Mule Agent Builder创建专属Agent，将时间运算封装为可复用、可共享的Skill模块。
1、进入MuleRun控制台，点击左上角“Build Agent”按钮，选择“Base Agent + Skills + Knowledge”范式。
2、在Skills配置区点击“+ Add Skill”，搜索并添加“DateTime Arithmetic”与“Holiday Calendar CN 2026”两个官方Skill。
3、在Knowledge区域上传本地CSV文件，列明自定义节假日及调休日期，确保首行为字段名：date,type（holiday/adjustment）。
4、在Prompt模板中输入：请根据提供的起止时间、工作日规则和节假日表，按每日8小时标准计算有效工时，忽略非工作日与法定假日。
5、保存并发布该Agent，即可在Agent Store中调用或嵌入其他工作流。
三、在MuleRun云端虚拟机中执行Python脚本调用datetime库
该方式适用于需批量处理大量时间区间、或与其他数据源（如Excel工时表、Jira导出CSV）联动的进阶用户。MuleRun为每位用户分配的7×24小时独立云端虚拟机支持完整Python运行环境，可自由安装依赖。
1、打开MuleRun终端（Terminal）模块，确认Python版本为3.9+：python --version。
2、使用pip安装pandas（如未预装）：pip install pandas。
3、创建脚本文件：nano /home/user/time_diff.py，写入含pandas.to_datetime()与diff()调用的代码段。
4、执行脚本：python /home/user/time_diff.py，输出结果将直接显示在终端窗口。
四、通过API方式向MuleRun时间服务发送HTTP请求
适用于已集成MuleRun至企业内部系统的开发者，可将时间区间计算作为微服务接口调用，实现与OA、ERP或考勤系统的无缝对接。该接口基于RESTful设计，认证采用Bearer Token机制。
1、在MuleRun开发者设置中获取当前账户的API Key，有效期为30天，可在“Account → API Access”中刷新。
2、构造POST请求，Header中加入：Authorization: Bearer your_api_key_here。
3、Body使用JSON格式，必填字段为start_time、end_time，时间格式须为ISO 8601：{"start_time": "2026-03-12T08:30:00", "end_time": "2026-03-16T17:45:00"}。
4、向端点https://api.mulerun.com/v1/time/duration发起请求，响应体将返回含total_seconds、work_hours、days_count等字段的JSON对象。
