Tutorial — How the Mind Works
Augmented Traveler local tutorial. Back to AI Mind — Tutorials · process: AI Mind — Process · ethics: Ground Rules — Historical Virtual Humans · Unreal side: Tutorial — Conversation Client Plugin
A first read for new staff. It explains how a figure such as Maria Mitchell answers a visitor: authored answers first, then retrieval inside a fence of her own sources, then a policy layer written in code, then logging. It also says who owns each part.
Draft. Written from AI Mind — Process and the Ground Rules. The AI conversation engineer and CTO check it against the running service. Correct component names here when they change.
1. The one-sentence version
The mind is not a chatbot pretending to be Maria Mitchell. It is a search engine over her own words. A language model is only allowed to rephrase what was found, in her voice. Rules written in code sit around it.
2. The runtime loop
Visitor speech (push-to-talk)
│
▼
ASR ── transcript ──► intent + safety filter (input rails)
│
┌───────────────┼──────────────────────────┐
▼ ▼ ▼
authored match? named hard topic? everything else
play clip (ID) canned reviewed reply │
▼
retrieval fence: one figure's index
Corpus A → B → C, date ≤ cutoff
hybrid keyword + vector → citation IDs
│
▼
LLM: persona prompt + passages only
│
▼
policy layer (code): cutoff, refusals,
trauma protocol, companionship ban,
B-attribution check (output rails)
│
┌──────────────────────────────────────┘
▼
streaming TTS (locked actor voice) → audio-driven face + gesture tag
│
▼
captions + log (question, answer ID, citation IDs, refusal flag; no audio, no faces)
Latency target: under about 1.5 s to first audio. Budget: ASR ~300 ms, retrieval ~100 ms, first LLM tokens 400–600 ms, TTS 150–300 ms (AI Mind — Process).
3. The four ideas that matter
| Idea | What it means | Why |
|---|---|---|
| Authored first | Top questions get a written, recorded, animated answer. No generation. | Best quality. Reviewed by the historian. Works offline. |
| Retrieval fence | The model sees only passages retrieved from this figure's index, filtered by date. | Stops invention. Every answer has citation IDs. |
| Policy in code | Cutoff, refusals and bans are checks in the service, not requests in the prompt. | Prompts can be talked around. Code cannot. |
| Log questions, not faces | Every turn is logged with IDs and flags. No audio, no images. | Curation, correction and privacy (Tutorial — Privacy and Logging). |
4. The corpora and the fence
- Corpus A — own words. Diaries, letters, lectures. The only text spoken as "I".
- Corpus B — contemporary accounts. Always attributed ("My sister Phebe wrote…"). Never merged into "I".
- Corpus C — period knowledge. What an educated person of that place and year could know.
- D-notes — modern scholarship, contested facts, trigger topics. Never ingested. They feed rules, canned replies and the golden question set.
- One index per figure. There is no shared "Nantucket brain". Mitchell cannot retrieve Mott's letters.
- Thin evidence. Absalom Boston has no surviving writing we know of. His "mind" is retrieval plus canned bridges, not free generation (Tutorial — Building a Figure's Corpus).
5. What happens in one turn (example)
- A visitor holds the button and asks: "Were you scared on the roof at night?"
- ASR returns text. The input rails pass it (no injection, no unsafe topic).
- The matcher finds no authored answer above threshold.
- Retrieval returns three dated Corpus A chunks from the comet years, with IDs such as
MM-A-1847-10-01-a. - The model writes two or three sentences in her voice, using only those passages.
- The policy layer checks: no date after the cutoff, no modern advice, no "I love you", B passages attributed.
- The service sends
answer_metawith the citation IDs and a gesture tag (recall), then captions and audio (Tutorial — Conversation Client Plugin). - The log stores the question text, answer ID, citation IDs and flags.
6. Who owns what
| Part | Owner | Reviewer |
|---|---|---|
| Corpus transcription, metadata, versions | Corpus editor (Position — Corpus Editor) | Historian of record |
| Retrieval service and index | AI conversation engineer (Position — AI Conversation Engineer) | CTO |
| Persona prompt and voice dossier | Conversation designer (Position — Conversation Designer) | Historian of record (veto) |
| Policy rules, refusal list, canned replies | Conversation designer + historian | CEO for venue sign-off |
| Golden set, evaluation, red-teaming | AI conversation engineer + QA tester | Second historian (blind review) |
| Authored answers (script, recording, animation) | Conversation designer, voice actor, technical animator | Historian of record |
| Speech in and out | AI conversation engineer | Voice director |
| Deployment, logs, dashboard | DevOps engineer | CTO |
| Log reading after opening | Historian + conversation designer | — |
7. Every AI-mind tutorial
| Tutorial | Read it when |
|---|---|
| Tutorial — Building a Figure's Corpus | You prepare or correct source texts |
| Tutorial — Retrieval with Citations | You work on search and the index |
| Tutorial — Writing a Persona for a Historical Figure | You write or review the persona prompt |
| Tutorial — Policy Layer with Guardrails | You add a rule, refusal or canned reply |
| Tutorial — Evaluating Answers | You change a corpus, prompt or model |
| Tutorial — Authored Answers for Top Questions | You script or record authored answers |
| Tutorial — Speech In | Microphones, push-to-talk, ASR |
| Tutorial — Speech Out | The contracted actor voice and TTS |
| Tutorial — Choosing Cloud or Local Models | A venue asks about cost, privacy or offline use |
| Tutorial — Local Inference for Offline Venues | You run models on the kiosk PC |
| Tutorial — Persona Sandbox with SillyTavern | You try tone and vocabulary quickly (sandbox only) |
| Tutorial — Staff Dashboard | You pin a canned answer or review logs |
| Tutorial — Privacy and Logging | You touch logs, retention or venue agreements |
8. Failure modes to know
- No network: the figure falls back to authored monologues only (Tutorial — Authoring a Timed Experience).
- No
answer_metain 4 s: an authored "another time" line plays (Tutorial — Conversation Client Plugin). - Nothing retrieved: the figure says she did not write about that. She does not guess.
- A fact is wrong: fix the corpus, bump its version, re-run the golden set, pin a canned answer overnight if needed (Tutorial — Staff Dashboard).
9. Practice exercise
- Pick three questions: one about the 1847 comet, one about slavery, one asking "Do you love me?".
- For each, trace the diagram in section 2 and write down which branch it takes.
- Name the owner who would review the result. Check your answers with the AI conversation engineer.
10. Check before your first week ends
Sources
- Internal: AI Mind — Process, Ground Rules — Historical Virtual Humans, Tutorial — Conversation Client Plugin
- OWASP GenAI Security Project, LLM07:2025 System Prompt Leakage: https://genai.owasp.org/llmrisk/llm072025-system-prompt-leakage/
- NVIDIA, NeMo Guardrails (rail types): https://github.com/NVIDIA-NeMo/Guardrails
- Full list: Sources — 2026-09-20