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

Agent programs: teach, upgrade

The Agent Verbs teach, upgrade as MCP do programs, with inputs, result, refusals and an example.

Agent.mintMode do
curl -X POST https://api.sb/leaseline.app/agents/mint \
  -H "Authorization: Bearer $SB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tenant":"ten_Bu63f0he26","product":"prod_MJmgS5dysq"}'
API referenceAgent.mint
npx startup-builder do Agent.mint --data '{"tenant":"ten_Bu63f0he26","product":"prod_MJmgS5dysq"}'
CLI referenceAgent.mint
{
  "name": "do",
  "arguments": {
    "code": "return await $.Agent.mint({ tenant: 'ten_Bu63f0he26', product: 'prod_MJmgS5dysq' })"
  }
}
MCP referenceAgent.mint
import { $ } from 'startup-builder'

const agent = await $.Agent.mint({ tenant: 'ten_Bu63f0he26', product: 'prod_MJmgS5dysq' })
SDK referenceAgent.mint

Reference for Agent, one group of Agent programs.

Agent.teach

Teach adds a rule to a Customer’s own minted Agent that binds only that Customer’s Tenant. Verb page.

Text
do: return await $.Agent.teach(input)

Emits Agent.taught.

Inputs

InputTypeRequiredDescription
agentAgentrequiredThe minted Agent.
ruletextrequiredThe rule, in plain words.
casetextrequiredA case the rule must pass, kept with the Tenant’s cases.

Returns

OutputTypeRequiredDescription
agentAgentrequiredThe Agent with the rule.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operationforbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.
A rule that would widen what the product’s Role contract allowsrefusedClear what the check names, then call it again.None.
agent is missing, or is not a agentinvalid-inputSend agent as a agent, then call it again.None.
rule is missing, or is not a textinvalid-inputSend rule as a text, then call it again.None.
case is missing, or is not a textinvalid-inputSend case as a text, then call it again.None.
The Idempotency-Key was sent before with another operation or other inputidempotency-mismatchSend a new key for new input; reuse a key only to retry the same request.None.

Example

JSON
{
  "name": "do",
  "arguments": {
    "code": "return await $.Agent.teach({ agent: 'agent_tCzKDMorKn', rule: 'Example rule', case: 'Example case' })",
    "idempotencyKey": "leaseline-agent-teach-1"
  }
}

Agent.upgrade

Upgrade moves a Customer’s minted Agent to a new Version once every case in its Tenant passes on that Version. Verb page.

Text
do: return await $.Agent.upgrade(input)

Emits Agent.upgraded.

Inputs

InputTypeRequiredDescription
agentAgentrequiredThe minted Agent.
versionVersionrequiredThe target Version.

Returns

OutputTypeRequiredDescription
agentAgentrequiredThe Agent, on the target Version.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operationforbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.
agent is missing, or is not a agentinvalid-inputSend agent as a agent, then call it again.None.
version is missing, or is not a versioninvalid-inputSend version as a version, then call it again.None.
The Idempotency-Key was sent before with another operation or other inputidempotency-mismatchSend a new key for new input; reuse a key only to retry the same request.None.

Example

JSON
{
  "name": "do",
  "arguments": {
    "code": "return await $.Agent.upgrade({ agent: 'agent_tCzKDMorKn', version: 'version_4HTEMs14G4' })",
    "idempotencyKey": "leaseline-agent-upgrade-1"
  }
}

mint, pause, resume, retire

Previous

Candidate

Next