linxinhua commited on
Commit
e7a506d
·
verified ·
1 Parent(s): bea7c21

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +0 -41
README.md CHANGED
@@ -10,44 +10,3 @@ app_file: app.py
10
  pinned: false
11
  short_description: LaLaLab
12
  ---
13
-
14
- # v5 · AI Ethics HOT — Socratic AI Discussion
15
-
16
- Research-instrument chatbot for an RCT on critical-thinking transfer.
17
-
18
- The participant:
19
- 1. Reads an AI ethics case.
20
- 2. Writes an initial 150-250 word argument.
21
- 3. Discusses with a Socratic AI for ~20 minutes.
22
- 4. Ends the session.
23
-
24
- The Socratic AI runs on a two-agent architecture: a Discussion Manager (small fast classifier) decides what kind of move the bot should make each turn, and the Main Bot (the Socratic discussion partner) executes that move. Both agents read their prompts from markdown files in `prompts/`, so behaviour can be edited without touching code.
25
-
26
- ## Configuration
27
-
28
- Runtime is controlled by Space Secrets:
29
-
30
- | Secret | Purpose |
31
- |---|---|
32
- | `API_KEY` | OpenAI API key (used by manager + main bot + per-session essay generator) |
33
- | `HF_access` | HF token with write scope (logger uploads to `AE-Talk-bot/log`) |
34
- | `RUN_MODE` | `test` / `pilot` / `prod` (picks the dataset bucket: `v5-HOT/socratic/<RUN_MODE>/`) |
35
-
36
- ## Logs
37
-
38
- Schema 1.1: every session writes one JSON to `AE-Talk-bot/log/v5-HOT/socratic/<RUN_MODE>/<session_id>.json` containing the participant's submitted argument, the per-session generated essay + discussion plan, the manager's cumulative verdict history, and per-turn records (user message, manager verdict + directive, plan-control text injected, bot reply, scratch fields, latencies).
39
-
40
- ## Architecture
41
-
42
- - `app.py`: Gradio UI (single page, 2x2 layout) plus the two-agent orchestrator wiring.
43
- - `prompts/manager_prompt.md`: prompt for the Discussion Manager agent.
44
- - `prompts/main_prompt.md`: prompt for the main Socratic bot.
45
- - `prompts/perfect_answer_prompt.md`: prompt for the per-session essay + discussion plan generator.
46
- - `core/orchestrator.py`: `turn_exchange` helpers that compose manager + main bot.
47
- - `core/manager_agent.py`: manager LLM call, JSON verdict output.
48
- - `core/main_agent.py`: main bot streaming, scratch parsing.
49
- - `core/plan_parsing.py`: parses the 4-field discussion plan schema (id / probe / rationale / anchor).
50
- - `core/perfect_answer.py`: per-session essay + discussion plan generator.
51
- - `core/logger.py`: Schema 1.1 HF dataset logger.
52
- - `data/case_analysis.md`, `data/ethics-frameworks.md`: generator inputs (case material).
53
- - `content/case_1.md`: the case prompt shown to the participant.
 
10
  pinned: false
11
  short_description: LaLaLab
12
  ---