"""运行定时服务工具""" from typing import Optional, Type from pydantic import BaseModel, Field from app.agent.tools.base import MoviePilotTool from app.log import logger class RunSchedulerInput(BaseModel): """运行定时服务工具的输入参数模型""" explanation: str = Field( ..., description="Clear explanation of why this tool is being used in the current context", ) job_id: str = Field( ..., description="The ID of the scheduled job to run (can be obtained from query_schedulers tool)", ) class RunSchedulerTool(MoviePilotTool): name: str = "run_scheduler" description: str = "Manually trigger a scheduled task to run immediately. This will execute the specified scheduler job by its ID." args_schema: Type[BaseModel] = RunSchedulerInput require_admin: bool = True def get_tool_message(self, **kwargs) -> Optional[str]: """根据运行参数生成友好的提示消息""" job_id = kwargs.get("job_id", "") return f"运行定时服务 (ID: {job_id})" @staticmethod def _run_scheduler_sync(job_id: str) -> tuple[bool, str]: """同步触发定时服务,避免调度器扫描阻塞事件循环。""" from app.scheduler import Scheduler scheduler = Scheduler() for scheduler_item in scheduler.list(): if scheduler_item.id == job_id: scheduler.start(job_id) return True, scheduler_item.name return False, "" async def run(self, job_id: str, **kwargs) -> str: logger.info(f"执行工具: {self.name}, 参数: job_id={job_id}") try: job_exists, job_name = await self.run_blocking( "workflow", self._run_scheduler_sync, job_id ) if not job_exists: return f"定时服务 ID {job_id} 不存在,请使用 query_schedulers 工具查询可用的定时服务" return f"成功触发定时服务:{job_name} (ID: {job_id})" except Exception as e: logger.error(f"运行定时服务失败: {e}", exc_info=True) return f"运行定时服务时发生错误: {str(e)}"