철학자 대화창

이번 주에 읽은 그 책, 저자에게 직접 물어보게 해 주세요. 뉴스레터나 독서모임 페이지에 붙이는 철학자 대화창이에요. 로그인 없이 지금 바로 말을 걸어 보세요.

누구에게 물어볼까요?

읽다가 걸린 대목, 오래 품어 온 고민을 그대로 물어보세요.
그 사람의 글을 바탕으로, 그 사람의 말투로 답해요.

체험이라 짧은 대화만 이어 갈 수 있어요.

내 페이지에 붙이기

이 체험 창은 흐름 홈페이지 전용이에요. 내 뉴스레터·독서모임 페이지에는 내 API 키로 같은 대화창을 붙여요. 키는 꼭 내 서버에만 두고, 페이지에는 내 서버 주소만 적어요.

  1. 흐름 콘솔에 가입하고 API 키를 받아요. 콘솔의 API 키 화면에서 새 키를 만들고, 크레딧을 충전하면 바로 쓸 수 있어요.
  2. 내 서버에 중계 주소를 하나 만들어요. 키를 환경 변수에 두고, 페이지가 보낸 질문을 흐름 대화 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);
  3. 내 페이지에 대화창을 붙여요. 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 시리즈에 정리돼 있어요.