AGENT.md
AGENT.md is gewone Markdown. Begin met frontmatter die de medewerker een naam en een beschrijving van één regel geeft; de marktplaats en het personeel van de eigenaar gebruiken allebei. Schrijf daarna de persona in de tweede persoon: de verantwoordelijkheden van de medewerker, hoe hij werkt en wat zijn regels zijn.
--- name: Collections Specialist description: Follows up on every overdue invoice until it is paid, disputed, or handed to the owner. --- # Collections Specialist You keep receivables moving. Every overdue invoice gets a follow-up on schedule, in a tone that protects the customer relationship. ## How you work - Check the aging report before any follow-up so you never chase a paid invoice. - Escalate to the owner when a customer disputes an amount. ## Rules - Never threaten, and never mention collections agencies. - Never agree to a payment plan; propose it to the owner.
Nebo geeft de medewerker aan het begin van elke sessie zijn persona, samen met zijn naam, beschrijving en eventuele triggers uit de frontmatter, en de instellingen die de eigenaar hem in Nebo geeft: zijn persoonlijkheid, regels en ziel. De persona is privé voor de medewerker; hij wordt nooit toegevoegd aan een prompt die andere medewerkers delen.
Schrijf op waarvoor de functie verantwoordelijk is en hoe hij beslissingen neemt. Laat toolnamen en productnamen weg: de tools van de medewerker komen uit zijn capabilities en verbindingen, en dezelfde persona moet werken in elk bedrijf dat hem aanneemt.
Geheugen
Elke medewerker leest de eigen feiten van de eigenaar en schrijft alleen naar zijn eigen geheugen. Hij werkt met het geheugen via de tools remember, recall en forget. Kies met memory.mode in agent.json hoe zijn gesprekken en geheugen worden bewaard.
| Modus | Gedrag | Gebruik het voor |
|---|---|---|
single | Eén doorlopend gesprek en één geheugen. De standaard. | De meeste functies. |
separate | Veel gesprekken delen het privégeheugen van de medewerker. Een gesprek met iemand anders dan de eigenaar, zoals een beller of bezoeker, heeft zijn eigen verzegelde geheugen. | Functies waarin met veel mensen wordt gepraat. |
confidential | Elk gesprek is een verzegelde zaak. Niets wat in het ene wordt geleerd, is zichtbaar in een ander, ook niet in dat van de eigenaar. | Cliëntzaken die gescheiden moeten blijven. |
"memory": {
"mode": "separate",
"topics": [
{ "slug": "account", "description": "A customer account: balance, promises to pay, contacts, disputes" }
],
"write_bar": ["web", "external-email"],
"share_with": []
} | Veld | Betekenis |
|---|---|
mode | single, separate of confidential. Een oudere context_isolated: true wordt gelezen als separate. |
topics | Maximaal 8 paren {slug, description} die de medewerker vertellen welke soorten dingen hij moet onthouden. Slugs zijn in kleine letters met koppeltekens; beschrijvingen zijn 1 tot 120 tekens lang. Gereserveerde slugs: tacit, entity, daily, project, memory, style, artifact. |
write_bar | Een run die inhoud uit een van deze bronnen heeft opgenomen, kan niet naar het geheugen schrijven: web, external-email, channel, document, phone, coworker. Als dit veld ontbreekt, zijn channel en phone geblokkeerd in de modi separate en confidential. Een lege lijst zet de blokkade uit. |
share_with | Medewerker-ID's, of *, die het geheugen van deze medewerker mogen ontvangen in antwoorden aan hen. Standaard leeg, wat betekent dat er niets wordt gedeeld. |
De bedrijfslaag
De bedrijfslaag is kennis die elke medewerker deelt: de woordenschat van het bedrijf, de partijen waarmee het zaken doet, zijn regels, wetten en normen, en naslagmateriaal. Hij staat in pakketten op de bot. Een pakket is een map met precies één markeringsbestand, INDUSTRY.md, FRANCHISE.md of COMPANY.md, met getypeerde mappen ernaast. Als lagen elkaar tegenspreken, wint bedrijf van franchise en franchise van branche.
<data>/packs/example-co/ ├── COMPANY.md ├── vocabulary/ ├── parties/ ├── rules/ ├── laws/ │ └── refunds.md ├── standards/ ├── workflows/ └── reference/
Elk bestand in een map is Markdown met optionele frontmatter. De frontmatter bevat de structuur, zoals de always van een regel, de id en value van een norm of de ceiling van een wet; de body bevat de tekst. Een pakket bevat kennis, nooit procedures, dus een pakket met een skill erin wordt geweigerd.
Wetten
De ceiling van een wet somt bewerkingen op die geen enkele medewerker mag uitvoeren. In de bedrijfslaag verandert reserved_to: owner dat: de bewerkingen blijven mogelijk, maar alleen met de eigen goedkeuring van de eigenaar, en die goedkeuring kan nooit aan een ander worden overgedragen.
--- ceiling: [ledger.refund.create] reserved_to: owner --- Refunds are issued only by the owner. Employees may prepare a refund and send it to the owner for approval.
Hoe medewerkers de laag leren
Medewerkers zoeken de laag niet op terwijl ze werken. Als een laag verandert, leest elke medewerker de wijziging één keer en herschrijft hij zijn eigen regels. De eigenaar kan altijd COMPANY.md en elke bedrijfsmap bewerken; door een wijziging op te slaan legt de eigenaar vast wat waar is.