Commands

Agents

An agent is one thing you charge for — a support bot, a voice assistant, a summarizer. Usage is reported against an agent, and pricing hangs off it.

paygent agent create

$paygent agent create --name "Support Bot" --external-id support-bot
FlagDescription
--name <name>Display name. Required.
--external-id <id>The handle your code reports usage against.
--description <text>What this agent does.
--type <type>normal or voice.
--status <status>Live, Paused, or Inactive.

Pick --external-id once and keep it stable. Changing it orphans every event already sent under the old value.

paygent agent list

$paygent agent list
FlagDescription
--status <status>Only agents with this status.
--type <type>Only normal or voice agents.
--search <text>Match name, external ID, or description.
--limit <n>Show at most this many.

paygent agent get

$paygent agent get support-bot

An agent can be named by external ID, name, or ID.

paygent agent update

$paygent agent update support-bot --description "Tier-1 support"

paygent agent enable

Make an agent accept usage. Also disable, pause, and resume.

$paygent agent enable support-bot
StatusMeaning
LiveBillable, accepting usage.
PausedTemporarily not billing.
InactiveNot accepting usage.

paygent agent ensure

Create an agent only if it does not already exist. Idempotent, so it is safe in a deploy script.

$paygent agent ensure --external-id support-bot --name "Support Bot"

Agents created this way start inactive and must be enabled.

paygent agent indicator

Indicators are the units you meter. Add, list, and remove them.

$paygent agent indicator add support-bot --name "Ticket resolved" --type OUTCOME
$paygent agent indicator list support-bot
FlagDescription
--name <name>What the indicator is called. Required.
--type <type>ACTIVITY for effort, OUTCOME for result.
--per-minuteBill by duration rather than by count.
--pulse-seconds <n>Voice agents: bill in pulses of N seconds.
--human-value <n>What one unit would cost if a person did it.
$paygent agent indicator add voice-ivr --name "Talk time" --type ACTIVITY \
>  --per-minute --pulse-seconds 6

paygent agent pricing

Read and write an agent’s pricing.

$paygent agent pricing show support-bot
$paygent agent pricing set support-bot --platform-fee 99 --price "Ticket resolved=2.50"
FlagDescription
--price "<name>=<amount>"Price one indicator. Repeatable.
--platform-fee <n>Recurring platform fee.
--setup-fee <n>One-off setup fee.
--billing-type <type>FLAT, VOLUME, GRADUATED, or CREDITS.
--included-usage <n>Units included before charging begins.
--from-file <path>Replace the whole pricing document.

--price routes to the activity or outcome block automatically, based on the indicator’s own type.