철학자 대화창
이번 주에 읽은 그 책, 저자에게 직접 물어보게 해 주세요. 뉴스레터나 독서모임 페이지에 붙이는 철학자 대화창이에요. 로그인 없이 지금 바로 말을 걸어 보세요.
누구에게 물어볼까요?
읽다가 걸린 대목, 오래 품어 온 고민을 그대로 물어보세요.
그 사람의 글을 바탕으로, 그 사람의 말투로 답해요.
체험이라 짧은 대화만 이어 갈 수 있어요.
내 페이지에 붙이기
이 체험 창은 흐름 홈페이지 전용이에요. 내 뉴스레터·독서모임 페이지에는 내 API 키로 같은 대화창을 붙여요. 키는 꼭 내 서버에만 두고, 페이지에는 내 서버 주소만 적어요.
- 흐름 콘솔에 가입하고 API 키를 받아요. 콘솔의 API 키 화면에서 새 키를 만들고, 크레딧을 충전하면 바로 쓸 수 있어요.
-
내 서버에 중계 주소를 하나 만들어요.
키를 환경 변수에 두고, 페이지가 보낸 질문을 흐름 대화 API로 넘겨 줘요. 아래는 Node.js 예시예요.
// server.mjs — Node.js 18+. HRUM_API_KEY는 서버 환경 변수에만 둬요. import http from 'node:http'; const ALLOWED = ['float/marx', 'float/sunzi', 'float/buddha']; http.createServer(async (req, res) => { if (req.method !== 'POST' || req.url !== '/api/philosopher') { res.writeHead(404).end(); return; } let raw = ''; for await (const chunk of req) raw += chunk; const { model, messages } = JSON.parse(raw || '{}'); if (!ALLOWED.includes(model) || !Array.isArray(messages)) { res.writeHead(400).end(); return; } const upstream = await fetch('https://api.hrum.ai/api/v1/partners/v1/chat/completions', { method: 'POST', headers: { 'Content-Type': 'application/json', 'X-Partner-Api-Key': process.env.HRUM_API_KEY, }, body: JSON.stringify({ model, appLang: 'ko', max_chars: 400, messages: messages.slice(-6) }), }); const data = await upstream.json(); res.writeHead(upstream.ok ? 200 : 502, { 'Content-Type': 'application/json' }); res.end(JSON.stringify({ answer: data.choices?.[0]?.message?.content ?? '' })); }).listen(3000); -
내 페이지에 대화창을 붙여요.
HTML을 넣을 수 있는 곳이면 어디든 돼요.
/api/philosopher는 2단계에서 만든 내 서버 주소예요.<div id="philo"> <div id="philo-log"></div> <form id="philo-form"> <input id="philo-q" placeholder="이번 주에 읽은 책, 저자에게 물어보세요" required> <button>묻기</button> </form> </div> <script> const MODEL = 'float/marx'; // float/sunzi, float/buddha … const history = []; const log = document.getElementById('philo-log'); function add(who, text) { const p = document.createElement('p'); p.textContent = who + ': ' + text; log.appendChild(p); } document.getElementById('philo-form').addEventListener('submit', async (e) => { e.preventDefault(); const q = document.getElementById('philo-q'); history.push({ role: 'user', content: q.value }); add('나', q.value); q.value = ''; const r = await fetch('/api/philosopher', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ model: MODEL, messages: history }), }); const { answer } = await r.json(); history.push({ role: 'assistant', content: answer }); add('저자', answer); }); </script>
서버가 없다면 RIDM Apps에 중계 코드를 올려요. 키는 암호화된 환경 변수로 두고, 포트 3000에서 응답하면 내 주소로 열려요. 고를 수 있는 인물과 파라미터는 개발 문서의 FLOAT AI 시리즈에 정리돼 있어요.