Tools

Service desk & avatar

Hand work to people: raise a support ticket, or pass a question to the person an avatar speaks for.

Tool	What it does
`create_ticket`	Creates a support ticket from details already collected from the person — category, summary, description, urgency and any category-specific fields and attachments — and returns its number.
`escalate_to_owner`	Passes a question the avatar cannot answer — or any request for a commitment only its owner can make — to the owner's inbox, instead of guessing.

`create_ticket`

Creates a support ticket from details already collected from the person — category, summary, description, urgency and any category-specific fields and attachments — and returns its number.

How an agent gets it. Declare it in the agent's tools: list.

Simulated, and it says so: nothing reaches a real service desk. The number is stable for a given run and summary, so a retry does not look like a second ticket.
The ServiceNow connector is the real equivalent. Used by ITHelp.

Arguments

Argument	Type	Required	Meaning
`category`	string	yes	hardware \| software \| access \| network \| other
`short_description`	string	yes	One-line summary.
`description`	string		Full description of the issue.
`urgency`	string		low \| medium \| high
`fields`	object		Everything else captured for this category — e.g. location, asset_tag, software name, system being accessed.
`attachment_ids`	array of string		Ids of photos/files the user attached, if any.

`escalate_to_owner`

Passes a question the avatar cannot answer — or any request for a commitment only its owner can make — to the owner's inbox, instead of guessing.

How an agent gets it. Declare it in the agent's tools: list. Only does anything on an avatar agent's run.

See My Avatar.

Arguments

Argument	Type	Required	Meaning
`question`	string	yes	What was asked, in one or two lines.
`context`	string		Anything the owner needs to answer it (optional).