Skip to content
StartupBuilder
by startups.studio
by Startups.Studio
Code
Changelog
File conventionsProductsProducts

Agent product files

A product file with $type Agent sells one agent to each customer; it names the Role the agent fills and the Verbs it may call.

A product file with $type: [Agent] sells one Agent to each Customer. It names the Role the agent fills, and that Role file holds its instructions, Limits, approvals and channels.

  • products/
  • renewals.mdxLeaseline's renewal agent, one per property manager
  • agents/
  • customer/
  • success-manager.mdxthe Role it names
  • success-manager.test.tsits eval cases

Reference

KeyTypeHoldsRequiredStatus
$typelistOne or more of App, API, Agent, Dataset, Servicerequiredlive
nounsNoun namesThe Nouns it exposes; a Dataset holds Things of exactly onelive
verbsVerb idsThe Verbs a Customer may calllive
interfaceslistThe Interfaces it ships on; every kind by defaultlive
roleRole pathThe Role in agents/ its agent fills: instructions, Limits, approvals, channels and eval casesrequiredlive

Examples

Minimal

products/renewals.mdx
---
$type: [Agent]
role: customer/success-manager
---

Leaseline

products/renewals.mdx
---
$type: [Agent]
role: customer/success-manager
nouns: [Lease]
verbs: [Lease.notify, Message.create]
---
No renewal slips past its date.

What it builds

The SoftwareBuilder compiles the file with its Role.

  • an agent per Customer on acceptance, minted in that Customer's Tenant
  • one Tool per Verb in verbs, and the agent card at /agents.json
  • the eval gate: every case in the Role's test file passes before an Offer publishes or a Version ships

Good to know