pages / example / heygenie_helpdesk
canister coord://offchain/genie/program/heygenie_helpdesk@v1/95e122888aba67e7 · v1 · artifact root 0x95e122888aba67e73392d396ecacfe2913694b18e2862b4f276b0831af495581 · previous none (first version) · superroot at publish not sealed yet
sealed cases that reached it: 2 — sealed cases that reached this word (the store counts, never reads)
heygenie helpdesk (a .genie program) in the studio: 17 symptoms, 17 fixes
// _GENIE_v1_ — Show Me Around ++ the helpdesk as a program: a case is asked, routed through the graph, answered, graded by
// System One, settled on a meter line and recorded; the door is the chat itself, with the next step always proposed.
genie heygenie_helpdesk v1
about "The helpdesk case machine: asked, routed through the graph, answered, graded by System One, settled on a meter line, recorded"
use product sma.case
use component sma-graph sma-helpdesk jev
use venue mcp
use guard halt-on-failure
agent case is "one question of a visitor, from asked to recorded"
states asked routed answered graded settled recorded escalated rejected expired
start asked
final recorded escalated rejected expired
failed rejected expired
on case
move asked -> routed when question.strength >= 0.35 tier free component sma-graph venue mcp
move routed -> answered component sma-helpdesk
move routed -> escalated when graph.next == null
move answered -> graded assure 0.7 asks spec_met unsupported_claim ending cheat_shaped meter sma.case tier case component jev
move answered -> rejected when grade.verdict == "reject"
move graded -> settled guard halt-on-failure meter sma.case
move settled -> recorded
move * -> expired when case.age > 86400
refuse no_next "the graph has no next transition for the question; a person picks up"
say asked "Your question is matched against the graph"
say answered "The answer cites the nodes it stands on"
next asked routed "A case opens when the question matches the graph at strength 0.35 or more"
next answered graded "System One asks its four questions; the score is the grade"
knowledge
symptom "the genie answers but cites nothing" caused_by "the question matched no node of the graph" fixed_by "add the answer to the studio graph as a graded node and ask again"
symptom "the case never settles" caused_by "the grade stayed under 0.7" fixed_by "an expert answers in the studio; the next case cites it"
fix "add the answer to the studio graph as a graded node and ask again" opens listed
fix "an expert answers in the studio; the next case cites it" opens hired
// the guided cases (week 2): what a visitor of the helpdesk asks about the helpdesk itself, each a door to a hop of the sale
symptom "what is heygenie, what is this, what does this site do, what is the genie" fixed_by "the helpdesk a product installs in one line: answers from the product's own knowledge graph, every case graded before anyone pays"
symptom "how do I install it, add the helpdesk to my product, one line install, get started, set up" fixed_by "install: one line on your page with the product's graph as the knowledge; POST /api/case runs one question as one case"
symptom "what does a case cost, pricing, how much, is it free, free tier, price" fixed_by "the price is the program's case tier, charged only when the grade stands; graph answers and the free tier cost nothing"
symptom "how is an answer graded, who grades, what is the grade, the judge, the four questions" fixed_by "System One asks its four questions of the answer against the knowledge; the score is the grade and the case settles at 0.7"
symptom "what is a door, what is a hop, routed to a door, the twelve hops, the sale" fixed_by "a door is the step a case opens on the twelve-hop sale; every fix opens the hop the case continues on"
symptom "how do I teach it, add knowledge, the answer is wrong, correct an answer, fix the answer" fixed_by "teach: POST /api/teach records the correction on the trace as a teach event; the editor's pull request carries it into the program"
symptom "how does it learn, auto-learn, does it improve, learn from cases, promotion" fixed_by "auto-learn runs on the graded cases with every tenth held out; a line is promoted only when the hold-out mean holds"
symptom "how do I verify a case, what is the head, the proof, the twig, sealed, verify the record" fixed_by "every case is sealed: its envelopes are pipe bodies and the head is a hashed tree the sdk's proof verifies"
symptom "no door, unresolved, strength 0, it did not answer, no match, the genie could not answer" fixed_by "no door at strength 0.35: the question goes on the weakest list; add the entry or send your knowledge"
symptom "can I talk to a person, escalate, book a specialist, human, a person to talk to, support" fixed_by "a person picks up when the graph has no next step: the handoff books a specialist"
symptom "what is the api, endpoints, how do agents call it, mcp, the doors of the api" fixed_by "the doors are POST /api/case, /api/teach, /api/learn and /api/grade; the language and the registers are on /genie"
fix "the helpdesk a product installs in one line: answers from the product's own knowledge graph, every case graded before anyone pays" is "heygenie is the helpdesk any product or agent installs in one line. The answers come from the product's own knowledge graph; every question and answer is one case, graded before anyone pays, sealed as proof." opens offer_in
fix "install: one line on your page with the product's graph as the knowledge; POST /api/case runs one question as one case" is "One line on your page, the product's knowledge graph as the knowledge. POST /api/case {product, question, knowledge} runs one question as one case: routed, answered from the graph, graded, metered, sealed." opens listed
fix "the price is the program's case tier, charged only when the grade stands; graph answers and the free tier cost nothing" is "The price is the program's own case tier and is charged only when the grade stands. An answer the graph already knows is free, every key has its free cases a day, and an unresolved or rejected case is never charged." opens settled
fix "System One asks its four questions of the answer against the knowledge; the score is the grade and the case settles at 0.7" is "Code checks the facts first: the cited nodes exist, nothing secret, something was said. Then System One asks its four questions of the answer against the knowledge; the score is the grade, and the case settles at 0.7 or more." opens graded
fix "a door is the step a case opens on the twelve-hop sale; every fix opens the hop the case continues on" is "A door is the step a case opens on the twelve-hop sale, from offer in to recorded. Every fix of the graph is a door: it opens the hop the case continues on, so a helpdesk answer is also the next step of a sale." opens classify
fix "teach: POST /api/teach records the correction on the trace as a teach event; the editor's pull request carries it into the program" is "POST /api/teach {trace, teaching} records the correction on the case's trace as a teach event, sealed with the case. Nothing writes the program by itself: the editor's pull request carries the line into the program, and the next case cites it." opens delivered
fix "auto-learn runs on the graded cases with every tenth held out; a line is promoted only when the hold-out mean holds" is "POST /api/learn runs auto-learn on the graded cases whose grade stood. Every tenth case is held out and never trained on; a line is proposed only when two cases share one path, and promoted only when the hold-out mean holds the threshold. The promoted lines go into the program by a pull request." opens recorded
fix "every case is sealed: its envelopes are pipe bodies and the head is a hashed tree the sdk's proof verifies" is "Every case is sealed. Each event of the trace is one envelope, a pipe body with its digest; the head is a hashed tree over the envelopes, and the sdk's proof rebuilds every id from the sealed bodies and verifies the head. A verifier needs the record, not the server." opens recorded
fix "no door at strength 0.35: the question goes on the weakest list; add the entry or send your knowledge" is "A question that matches no node of the graph at strength 0.35 opens no door: the case is recorded as unresolved, never charged, and the question goes on the weakest list. Add the entry to the graph, or send your own knowledge with the question." opens classify
fix "a person picks up when the graph has no next step: the handoff books a specialist" is "When the graph has no next step the case is escalated and a person picks it up: the handoff books a specialist, and the booked hour is a hire of the sale." opens hired
fix "the doors are POST /api/case, /api/teach, /api/learn and /api/grade; the language and the registers are on /genie" is "The doors are POST /api/case (one question as one case), POST /api/teach (a correction on the trace), POST /api/learn (auto-learn on the graded cases) and POST /api/grade (one answer graded). The language, the registers, the packs and the example programs are on /genie." opens offer_in
rule "an answer cites only node ids of the knowledge it was given"
rule "every fix is a door to a hop of the sale: a fix opens the hop the case continues on"
term "neuron" is "the unit of model work the page shows as the power of a reply"
door "Ask the genie" as case
product heygenie
locale en
step asked "Type what you need; the genie matches it to the graph" next routed opens routed
step routed "The graph found the surface your question is about" next answered
step answered "The answer cites the nodes it stands on" next graded
step graded "System One graded the answer with its four questions" next settled
step settled "The case is one meter line of the product" next recorded
step recorded "The case is recorded under the tenant's topic"
step escalated "The graph has no next step; a person picks up"
ask "Which product is this about?"
handoff "no next step in the graph; a person picks up the case" booking https://cal.com/taifoon meet https://meet.jit.si room genie-helpdesk