← All ivy-agents
IVYXSTUDIO · IVY AGENT
B

Billing Ticket Router

ivy.agent.billing-ticket-router · v1.1.0

ivyx

Has a model decide whether a support ticket is about billing, mails a billing ticket to the billing team, and drafts a short reply for every ticket.

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
    Decide if the ticket is about billing

    Analyze the ticket text and determine if it relates to billing. Return true if it is about billing, false otherwise.

    takes
    context from the agent's input, message
    returns
    is_billing
    Model turn
  2. 02
    Only a billing ticket

    Lets what follows run only when output.is_billing of step 1 is true.

    Branch
  3. 03
    Mail the ticket to billing
    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 2.

    takes
    body from the agent's input, message
    subject from the agent's input
    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
    subject Support ticket: billing
    secret
    password the stored secret mail-password
    returns
    sent
    Ivy Node
  4. 04
    Draft a short reply

    Draft a short, polite reply to the customer acknowledging their ticket.

    takes
    context from the agent's input, message
    returns
    reply
    Model turn

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.

Calls a modelmessage-sendNetwork

What it needs

  • A stored secret named mail-password. The agent's file carries the name, never the value.

Inputs

FieldTypeDescription
messagerequiredstringThe ticket text.
usernamerequiredstringThe sending address, which is the login name; its password is the stored secret mail-password.
torequiredstringThe billing team's address.
subjectstringThe subject of the mail to billing.
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
is_billingbooleanTrue when the ticket is about billing.
sentbooleanTrue once the server accepted the mail to billing; absent when nothing was sent.
replystringThe drafted reply to the customer.

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, a model core, 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)

  • billing-ticket

    A double charge is billing: it is mailed to billing and a reply is drafted.

    given
    smtp_host 127.0.0.1
    smtp_port 3025
    smtp_tls false
    message Hello, I was charged twice for invoice 1042 this month. Please refund the duplicate charge.
    username agent@ivyx.test
    to agent@ivyx.test
    expects
    is_billing equals true
    sent equals true
    reply matches \w
  • product-ticket

    A broken button is not billing: nothing is mailed and a reply is drafted.

    given
    smtp_host 127.0.0.1
    smtp_port 3025
    smtp_tls false
    message Hi, the export button in the dashboard does nothing when I click it. Can you help?
    username agent@ivyx.test
    to agent@ivyx.test
    expects
    is_billing equals false
    reply matches \w