Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.neoagent.io/llms.txt

Use this file to discover all available pages before exploring further.

The Get Technician Context tool feeds a dispatch agent a structured, pre-computed snapshot of your technicians — who’s working today, when, how loaded they are, and who has the right expertise — so it can make a good assignment decision quickly without re-deriving any of it from raw PSA endpoints. It works for ticket-triggered runs and for scheduled (ticketless) sweeps; specifying the technician pool via the ticket’s company or board team requires a ticket, while passing an explicit list of technicians works in either mode.
Auto-injected for any workflow whose PSA integration has its scheduling-equivalent permission group enabled at Read+ (ConnectWise Schedule Entries, Autotask Service Calls, Halo Appointments, ServiceNow Users and Groups). You’ll see it in the toolbox automatically — no need to toggle it on manually. It pairs with the agent’s Dispatch Decision Framework skill, which the agent loads to interpret the context.

What It Does

It returns, per technician:
  • Calendar — weekday working hours (days flagged “Not working” when off), timezone, holidays, today’s existing appointments
  • Workload — open ticket count, recent assignment volume
  • Expertise — skills, prior work on similar tickets, the relevant configuration items or technologies
  • Recent Neo assignments — fairness signal so the agent can round-robin across the team
The agent uses this to choose an assignee (or to decide the ticket should be escalated or left unassigned), then acts via the PSA API — for example setting the ticket’s owner or adding a schedule entry.

Why It Matters

Each PSA exposes “is this engineer working today” through a different chain of endpoints with non-obvious field names (e.g. ConnectWise’s mondayStartTime / sundayEndTime on schedule/calendars/{id}, Autotask’s InternalLocationWithBusinessHours + per-resource overrides, Halo’s api/Workday). Asking the agent to reconstruct that on the fly is brittle: a misspelled field name or a missing day attribute leads to silent guesses (“probably Mon–Fri 09:00–17:00”) and engineers scheduled outside working hours. Get Technician Context is the canonical answer to working-hours / availability questions. Custom instructions that reference “engineer’s working hours” or “calendar working days” should let the agent reach for this tool, not derive it from primitives.

How to Use

  1. Build a dispatch workflow (or start from a dispatch recipe)
  2. The tool is auto-enabled when your PSA scheduling perm is on — no extra toggle needed
  3. In custom instructions, describe your routing rules — preferred boards, escalation thresholds, who handles what. Reference “engineer’s working hours” / “calendar working days” naturally; the agent will fetch them via this tool
  4. Review assignments in Event History before turning off technician approval
The richer your PSA data — skills on technician records, accurate schedules, configuration items on tickets — the better the agent’s dispatch decisions. This tool only surfaces what your PSA (and connected calendars) already know.