← All ivy-agents
IVYXSTUDIO · IVY AGENT
S

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.

  1. 01
    Choose the team
    ivy.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
    state from the agent's input, ticket
    set
    instructions Choose one of these teams: billing, technical, account, or other.
    options ["billing","technical","account","other"]
    secret
    jev_api_key the stored secret jev-api-key
    returns
    team
    Ivy Node
  2. 02
    Rate the urgency
    ivy.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
    state from the agent's input, ticket
    set
    instructions Rate 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_key the stored secret jev-api-key
    returns
    urgency
    Ivy Node
  3. 03
    Only when it needs action today

    Lets what follows run only when is.needs_action_today of step 2 is true.

    Branch
  4. 04
    Mail the ticket to on-call
    ivy.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
    body from the agent's input, ticket
    subject from step 1, choice
    from_addr from the agent's input, username
    username from the agent's input
    to from the agent's input
    smtp_host from the agent's input
    smtp_port from the agent's input
    use_tls from the agent's input, smtp_tls
    set
    smtp_host smtp.gmail.com
    smtp_port 587
    use_tls true
    secret
    password the stored secret mail-password
    returns
    sent
    Ivy Node

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.

message-sendNetwork

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

FieldTypeDescription
ticketrequiredstringThe ticket text.
usernamerequiredstringThe sending address, which is the login name; its password is the stored secret mail-password.
torequiredstringThe on-call address.
smtp_hoststringThe SMTP server; smtp.gmail.com when left out.
smtp_portintegerThe SMTP port; 587 when left out.
smtp_tlsbooleanUpgrade SMTP with STARTTLS; on when left out.

Outputs

FieldTypeDescription
teamstringbilling, technical, account or other.
urgencystringcan wait, needs attention this week or needs action today.
sentbooleanTrue 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_host 127.0.0.1
    smtp_port 3025
    smtp_tls false
    ticket Our whole team is locked out of the dashboard since 9:00 and we have a client demo in one hour. Please help now!
    username agent@ivyx.test
    to agent@ivyx.test
    expects
    team matches ^(technical|account)$
    urgency equals needs action today
    sent equals true
  • routine-ticket

    A font-size suggestion about the invoice PDF is not urgent, so nothing is mailed.

    given
    smtp_host 127.0.0.1
    smtp_port 3025
    smtp_tls false
    ticket Small suggestion: the invoice PDF could show our VAT number in a larger font.
    username agent@ivyx.test
    to agent@ivyx.test
    expects
    team matches ^(billing|other)$
    urgency matches ^(can wait|needs attention this week)$