Support Ticket Triage
ivy.agent.ticket-priority-router · v1.1.0
ivyx
Has Jev choose a support ticket's team and rate its urgency, and mails a ticket that needs action today to on-call with its team as the subject.
Steps
In the order the agent's file lists them, each with where its inputs come from and the values the file fixes. A branch or a loop is a step too.
- 01Ivy NodeChoose the teamivy.node.jev-choice
Asks TypeSafe Jev which of the given options fits a text or JSON state and returns the chosen option with its confidence and the probability of every option.
- takes
statefrom the agent's input,ticket- set
instructionsChoose one of these teams: billing, technical, account, or other.options["billing","technical","account","other"]- secret
jev_api_keythe stored secret jev-api-key- returns
team
- 02Ivy NodeRate the urgencyivy.node.jev-score
Asks TypeSafe Jev where a text or JSON state sits on an ordered scale of 2 to 10 described levels and returns a score from 0 to the top level with the nearest level, its description and the confidence.
- takes
statefrom the agent's input,ticket- set
instructionsRate the urgency on these levels: can wait, needs attention this week, needs action today.levels["can wait","needs attention this week","needs action today"]- secret
jev_api_keythe stored secret jev-api-key- returns
urgency
- 03BranchOnly when it needs action today
Lets what follows run only when is.needs_action_today of step 2 is true.
- 04Ivy NodeMail the ticket to on-callivy.node.email-send
Sends a plain-text or HTML email through an SMTP server in one step and returns the recipients it went to.
Runs only on the then branch of step 3.
- takes
bodyfrom the agent's input,ticketsubjectfrom step 1,choicefrom_addrfrom the agent's input,usernameusernamefrom the agent's inputtofrom the agent's inputsmtp_hostfrom the agent's inputsmtp_portfrom the agent's inputuse_tlsfrom the agent's input,smtp_tls- set
smtp_hostsmtp.gmail.comsmtp_port587use_tlstrue- secret
passwordthe stored secret mail-password- returns
sent
Nodes it brings
Adding this agent in IVYX Studio adds these nodes with it. A node your workspace already has is kept as it is, even at another version.
What it touches
Collected from what each of its nodes declares and what the agent's own file declares, such as moving a robot, plus the model call when a step is a model turn. A declaration is the author's statement, and it is what policy rules select on.
What it needs
- A stored secret named
jev-api-key. The agent's file carries the name, never the value. - A stored secret named
mail-password. The agent's file carries the name, never the value.
Inputs
| Field | Type | Description |
|---|---|---|
| ticketrequired | string | The ticket text. |
| usernamerequired | string | The sending address, which is the login name; its password is the stored secret mail-password. |
| torequired | string | The on-call address. |
| smtp_host | string | The SMTP server; smtp.gmail.com when left out. |
| smtp_port | integer | The SMTP port; 587 when left out. |
| smtp_tls | boolean | Upgrade SMTP with STARTTLS; on when left out. |
Outputs
| Field | Type | Description |
|---|---|---|
| team | string | billing, technical, account or other. |
| urgency | string | can wait, needs attention this week or needs action today. |
| sent | boolean | True once the server accepted the mail to on-call; absent when nothing was sent. |
Tests
2 of 2 test cases passed on Oct 7, 2026, in the publisher's own environment, before this version was published. The registry keeps that record; it does not run the cases again.
Requires: python:3.9, the stored secret jev-api-key, an SMTP server (Gmail unless smtp_host says otherwise) with the sending account's password stored as the secret mail-password, for the cases, GreenMail on 127.0.0.1:3025 (mkdata-mail.py)
- urgent-ticket
A locked-out team before a demo is technical or account, needs action today, and is mailed to on-call.
- given
smtp_host127.0.0.1smtp_port3025smtp_tlsfalseticketOur whole team is locked out of the dashboard since 9:00 and we have a client demo in one hour. Please help now!usernameagent@ivyx.testtoagent@ivyx.test- expects
teammatches ^(technical|account)$urgencyequals needs action todaysentequals true
- routine-ticket
A font-size suggestion about the invoice PDF is not urgent, so nothing is mailed.
- given
smtp_host127.0.0.1smtp_port3025smtp_tlsfalseticketSmall suggestion: the invoice PDF could show our VAT number in a larger font.usernameagent@ivyx.testtoagent@ivyx.test- expects
teammatches ^(billing|other)$urgencymatches ^(can wait|needs attention this week)$