ڎjdZddlmZddlmZmZddlmZddlm Z dd l m Z m Z dd l mZdd lmZmZGd d eZGddeZdS)zThe creating task tool class.)Any) BaseModelField) _TaskToolBase) ToolChunk) AgentStateTask)DeveloperOrientedException) TextBlockToolResultStateceZdZUdZedZeed<edZeed<edd Z e ee fdzed <dS) _TaskCreateParamsz%The params of the creating task tool.zA brief title for the task) descriptionsubjectzWhat needs to be donerNz(Arbitrary metadata to attach to the task)defaultrmetadata) __name__ __module__ __qualname____doc__rrstr__annotations__rrdictrPC:\Projects\DSCons\.venv\Lib\site-packages\agentscope\tool\_task\_create_task.pyrrs//5%ABBBGSBBBu)@AAAKAAA&+e>'''Hd38nt#rrc eZdZUdZdZeed<dZeed<e Z e ed< d de deded e ee fdzd ef d ZdS) TaskCreatez'Create a task for the agent to perform.nameaUse this tool to create a structured task list for your current session. This helps you track progress, organize complex tasks, and demonstrate thoroughness to the user. It also helps the user understand the progress of the task and overall progress of their requests. ## When to Use This Tool Use this tool proactively in these scenarios: - Complex multi-step tasks - When a task requires 3 or more distinct steps or actions - Non-trivial and complex tasks - Tasks that require careful planning or multiple operations - Plan mode - When using plan mode, create a task list to track the work - User explicitly requests todo list - When the user directly asks you to use the todo list - User provides multiple tasks - When users provide a list of things to be done (numbered or comma-separated) - After receiving new instructions - Immediately capture user requirements as tasks - When you start working on a task - Mark it as in_progress BEFORE beginning work - After completing a task - Mark it as completed and add any new follow-up tasks discovered during implementation ## When NOT to Use This Tool Skip using this tool when: - There is only **one single, straightforward** task - The task is trivial and tracking it provides no organizational benefit - The task can be completed in less than 3 trivial steps - The task is purely conversational or informational NOTE that you should **NOT** use this tool if there is only one trivial task to do. In this case you are better off just doing the task directly. ## Task Fields - **subject**: A brief, actionable title in imperative form (e.g., "Fix authentication bug in login flow") - **description**: What needs to be done All tasks are created with status `pending`. ## Tips - Create tasks with clear, specific subjects that describe the outcome - After creating tasks, use TaskUpdate to set up dependencies (blocks/blockedBy) if needed - Check TaskList first to avoid creating duplicate tasksr input_schemaN _agent_staterrreturncVKt|tstd|d d}|jjD]<} t |t |j}&#ttf$rY9wxYwt|dz}t||||pi}|jj |ttd|d|jg S#t $r7} ttd | gt"j cYd } ~ Sd } ~ wwxYw) z3Create the subtask and add it into the agent state.z:Error: TaskCreate requires AgentState to be provided, got z instead.rr)idrrrz Task (id=z) created successfully: )text)contentzCreateTaskError: )r)stateN) isinstancer r tasks_contexttasksmaxintr' ValueError TypeErrorrr appendr rr ExceptionrERROR) selfr$rrr max_numerictnext_idtaskes rcallzTaskCreate.callSs, 33 ,++++  " K!/5  "%k3qt99"="=KK"I.D+/**G'!R D  & , 3 3D 9 9 9***<**    #:q#:#:;;;&+        sAC'"A C' A41C'3A44A2C'' D(1,D#D(#D()N)rrrrr"rrrrmodel_json_schemar#rr rr r;rrrr!r!s11D#1>L$>>>+/ 11 11 1 sCx.4' 1  111111rr!N)rtypingrpydanticrr_task_tool_baser _responser r*r r exceptionr messagerrrr!rrrrCs##%%%%%%%%******!!!!!!%%%%%%%%33333311111111 kkkkkkkkkkr