Tasks & Jobs
Find work that still needs to be planned with these tools. They are read-only: scheduling something is the job of the appointment tools.
The full set of unplanned tasksOpen taskA task that has not been scheduled yet. It waits in the open task list to be placed on the planning board. is exposed as the dimescheduler://today/open-tasks data source, not as a tool. Reading the resource is cheaper than a tool call and gives the agent standing context for the dispatcher's queue.
Search tasks
Tool: search_tasks
Looks up tasksTaskA unit of work that belongs to a job. It appears in the open task list until it is scheduled to a resource. by task number, subject, jobJobA high-level container, comparable to a project, that bundles related tasks together with common information such as customer, billing, and address., or categoryCategoryA visual indicator (a color) applied to appointments to classify or label them.. Reach for this when the assistant needs a specific task by name or wants to filter by job.
| Parameter | Type | Required | Description |
|---|---|---|---|
taskNo | string | No | Task number to search for (exact match) |
jobNo | string | No | Job number to filter by |
searchTerm | string | No | Search term to match against task subject or description |
categoryName | string | No | Category name to filter by |
limit | number | No | Maximum number of results to return (default: 100) |
Example prompts
"Search for tasks related to plumbing."
"Which open tasks belong to job ABC123?"
Search jobs
Tool: search_jobs
Looks up jobs by job number, name, or category. Useful when the user mentions a project or work order rather than an individual task.
| Parameter | Type | Required | Description |
|---|---|---|---|
jobNo | string | No | Job number to search for (exact match) |
searchTerm | string | No | Search term to match against job name or description |
categoryName | string | No | Category name to filter by |
limit | number | No | Maximum number of results to return (default: 100) |
Example prompt
"Find all jobs for project ABC123."