Worker
A Worker is a Human or an Agent that fills a Role and acts on Tasks.
Properties
| Property | Type | Required | Description |
|---|---|---|---|
name | string | required | The name the Worker goes by in a Startup. |
instructions | text | How the Worker does its work. |
Object
{
"$id": "https: //api.sb/ quietcopy.com/ workers/ worker_1",
"$type": "Worker",
"name": "QuietCopy",
"instructions": "Example instructions"
}Relationships
- A Worker carries many Cards: a Worker carries the Cards issued for its Mandates; the cardholder on the rail is always the Company.
carries, inversecarriedBy. - A Worker has many Conversations: one Worker owes each Conversation its next answer.
conversations, inverseawaits. - A Worker fills many Roles: a Worker, human or agent, fills a Role and acts under its Permissions; one Agent can fill Roles in many Startups.
fills, inversefilledBy. - A Worker has access many Access Levels: a Worker holds one Access Level in each namespace it works in, apart from the Role it fills.
hasAccess, inverseworkers. - A Worker holds many Credentials: a Worker performs a Reserved Act only while it holds the Credential that authorizes it, in good standing.
holds, inverseheldBy. - A Worker has one Mailbox: every Worker, Agent or Human, has its own Mailbox.
mailbox, inversebelongsTo. - A Worker practices many Skills: the Skills a Worker has, each at a level, matched against what Roles require.
practices, inversepracticedBy. - A Worker remembers one Memory: a Worker’s own Memory of what it has learned, read by its Functions and kept within its Startup.
remembers, inverseheldBy. - A Worker staffs many Services: a Service’s outcome is delivered by the Agents and Humans who fill its Roles.
staffs, inverserequires. - A Worker has many Tasks: the Worker a Task waits on; the Task sits in that Worker’s inbox until it is done.
tasks, inverseassignedTo. - A Worker uses many Tools: the Tools a Worker may call, narrowed to its Role’s Permissions.
uses, inverseusedBy. - A Worker writes many Comments: every Comment names the Worker, human or agent, who wrote it.
writes, inverseauthor.
Verbs
createCreates a Worker.POST /{namespace}/workersgetReturns one Worker by id.GET /{namespace}/workers/{id}listReturns Workers, newest first, one page at a time.GET /{namespace}/workersupdateChanges the given properties of a Worker.PATCH /{namespace}/workers/{id}deleteDeletes a Worker; its history is kept.DELETE /{namespace}/workers/{id}
Permissions
Which Access level may call each Verb. One-way Verbs wait their delay window.
| Operation | owner | admin | member | viewer |
|---|---|---|---|---|
Worker.create | Yes | Yes | Yes | No |
Worker.get | Yes | Yes | Yes | Yes |
Worker.list | Yes | Yes | Yes | Yes |
Worker.update | Yes | Yes | Yes | No |
Worker.delete | Yes | Yes | Yes | No |
Call it
Add a worker to TutorLoop.Example
At a tax-preparation service, Nora the Payroll Specialist and a credentialed preparer are both Workers. Each fills a Role, works Tasks, and keeps its own Memory.