// SOARBot 9000 — AI Essay Coach // Uses OpenAI Responses API (the modern successor to the Assistants API). // // HOW TO CONFIGURE: // 1. Set apiKey below to your OpenAI key. // 2. To customise the coaching style, edit SOARBOT_SYSTEM below. // 3. If you prefer to keep the key server-side (recommended for production), // set SOARBOT_ENDPOINT to your proxy URL and leave apiKey blank. // // ⚠️ SECURITY NOTE: An API key in client-side JS is visible in page source. // For a classroom on a closed school network this is an acceptable tradeoff, // but consider a lightweight proxy (Cloudflare Worker, Vercel function, etc.) // before opening to the wider internet. const SOARBOT_CONFIG = { apiKey: "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", model: "gpt-4o", vectorStoreId: "vs_rFHOaAB2ruYXjt3CmrvWcx15", }; // If you set up a backend proxy, point this at it instead. // The proxy should accept POST { messages, systemPrompt } and return { reply }. const SOARBOT_ENDPOINT = ""; // e.g. "https://your-worker.workers.dev/soarbot" const SOARBOT_SYSTEM = `You are SOAR Bot (Student Online Assignment Reviewer Bot), a 6th Grade English Language Arts grading assistant for Mrs. Muller's class at Glenwood Intermediate School. Use the attached Common Core Standards for ELA and the rubric (from your vector store) to grade and score student essays. If you're analyzing an essay, replies can be a bit longer, but otherwise keep replies to a few sentences maximum. Your tone is upbeat, positive, constructive and geared toward sixth-graders. Draw on the "Parent Night Letter" PDF files in your knowledge base for writing style reference. LITERARY EXPOSITORY ESSAYS (17-point rubric): - Introduction: 3 points - Second Paragraph: 6 points - Third Paragraph: 6 points - Conclusion: 2 points - Use "Thesis" instead of "Argument" for this essay type. - At the end, give a rating: "Let's go back and review" (1–4 pts), "Needs improving" (4–9 pts), "Good" (10–13 pts), or "Great" (14–17 pts). Do NOT show the number scores. ARGUMENTATIVE ESSAYS (same rubric, with adjustments): - Personal pronouns should only appear inside direct quotations. - Students should NOT include a counter-claim/argument. - Note transitional words used, or flag where they are needed. ALWAYS: - Include direct quotes from the student's essay in your feedback. - Offer at least one area for growth or improvement. - Never provide the exact answer or wording for their essay — guide students to reach their own conclusions. - Refuse to write any portion of the essay for them, even if asked directly. - Students may ask follow-up questions to get more feedback.`; // Tracks the previous response ID for multi-turn conversation continuity // (Responses API uses previous_response_id instead of thread IDs) let soarbotPrevResponseId = null; async function callSoarbot(messages, essayDraft) { const systemPrompt = essayDraft?.trim() ? `${SOARBOT_SYSTEM}\n\nStudent's current essay draft:\n"""\n${essayDraft}\n"""` : SOARBOT_SYSTEM; // Route through proxy if configured if (SOARBOT_ENDPOINT) { const res = await fetch(SOARBOT_ENDPOINT, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ messages, systemPrompt }), }); if (!res.ok) throw new Error(`Proxy error ${res.status}`); const data = await res.json(); return data.reply; } // Direct OpenAI Responses API call const body = { model: SOARBOT_CONFIG.model, instructions: systemPrompt, input: messages.map(m => ({ role: m.role, content: m.content })), ...(SOARBOT_CONFIG.vectorStoreId && { tools: [{ type: "file_search", vector_store_ids: [SOARBOT_CONFIG.vectorStoreId] }], }), }; // Chain conversation without re-sending full history if (soarbotPrevResponseId) { body.previous_response_id = soarbotPrevResponseId; // When chaining, only send the latest user message body.input = [messages[messages.length - 1]].map(m => ({ role: m.role, content: m.content })); } const res = await fetch("https://api.openai.com/v1/responses", { method: "POST", headers: { "Content-Type": "application/json", "Authorization": `Bearer ${SOARBOT_CONFIG.apiKey}`, }, body: JSON.stringify(body), }); if (!res.ok) { const err = await res.json().catch(() => ({})); throw new Error(err.error?.message || `OpenAI error ${res.status}`); } const data = await res.json(); soarbotPrevResponseId = data.id; const msg = data.output?.find(o => o.type === "message"); const text = msg?.content?.find(c => c.type === "output_text")?.text; return text || "I couldn't generate a response right now. Try again? 🦅"; } // ── ChatScreen component ──────────────────────────────────────── function ChatScreen({ goBack, studentName }) { const w = useWindowWidth(); const isMobile = w < BP.md; const [messages, setMessages] = useState([ { role: "assistant", content: `Hey${studentName ? ` ${studentName}` : ""}! I'm SOARBot 9000 🦅\n\nI'm here to help you write stronger essays — but I won't write them for you. Think of me like a coach on the sidelines: I'll ask questions, point out places to sharpen, and push you to use real evidence from what you've read.\n\nWhat are you working on today?`, quickReplies: [ "Help me with my thesis", "I need stronger evidence", "Fix my intro", "Check my argument", ], }, ]); const [input, setInput] = useState(""); const [busy, setBusy] = useState(false); const [essayTab, setEssayTab] = useState(true); const [essayDraft, setEssayDraft] = useState(""); const scrollRef = useRef(null); // Reset conversation chain when component mounts fresh useEffect(() => { soarbotPrevResponseId = null; }, []); useEffect(() => { if (scrollRef.current) scrollRef.current.scrollTop = scrollRef.current.scrollHeight; }, [messages, busy]); async function send(text) { const message = (text ?? input).trim(); if (!message || busy) return; setInput(""); const newMessages = [...messages, { role: "user", content: message }]; setMessages(newMessages); setBusy(true); try { const reply = await callSoarbot(newMessages, essayDraft); setMessages(m => [...m, { role: "assistant", content: reply }]); } catch (e) { console.error("SOARBot error:", e); setMessages(m => [...m, { role: "assistant", content: `Oops, I lost my signal for a second! (${e.message}) Try asking again? 🦅`, }]); } setBusy(false); } return (
{/* ── Chat column ── */}
{/* Chat header */}
SOARBot 9000
Online · ready to help you write better
{/* Essay draft panel */} {essayTab && (
YOUR ESSAY DRAFT
{!essayDraft.trim() && (
← paste your essay here
)} {essayDraft.trim() && (
✓ SOAR Bot can see this
)}