【初心者向け】GraphAIをWindowsで動かすまでの全手順（Node.js + OpenAI API）

# 【初心者向け】GraphAIをWindowsで動かすまでの全手順（Node.js + OpenAI API）

こんにちは、大企業・中小企業・SE・営業・経営を経験し、現在は製造業を中心にデジタル化、DX支援などをしておりますせいやです。 
最近話題の **GraphAI** を、実際に **Windows環境で動かしてみた**ので、その手順をまとめました。  
この投稿を読めば、あなたのWindowsでもChatGPTと対話できるAIボットが動くようになります！

---

## ✅ この記事でわかること

- GraphAIとは何か（ざっくり）
- GraphAIをWindows + Node.jsで動かす手順
- 「こんにちは」と入力→ChatGPTの返答が返ってくる構成まで
- よくあるエラーとその対処法（初心者でもつまずかない）

---

## 1. GraphAIとは？

**GraphAI**は、Receptron社が開発している**エージェントベースのAIフレームワーク**です。

- ノード同士をグラフ構造でつなぎ処理を定義  
- エージェント（ChatGPTや関数）をつなげて柔軟なワークフローを実現  
- 条件分岐やループも構築できるため、RAG構造や業務フローに応用しやすい  

簡単に言えば、**ChatGPTや関数処理を組み合わせて、自分だけのAIオートメーションが作れる**すごいやつです。

---

## 2. 動作環境

- Windows 10 / 11
- Node.js（18以上推奨）
- OpenAI APIキー（`gpt-4o`など）

---

## 3. セットアップ手順

### Node.js のインストール

以下からインストーラーをダウンロードして、LTS版をインストールします。  
👉 [https://nodejs.org/ja](https://nodejs.org/ja)

インストール後、バージョン確認：

```bash
node -v
npm -v
```
---

### ② プロジェクトフォルダ作成

```bash
mkdir graphai-test
cd graphai-test
npm init -y
```

---

### ③ `.env` ファイルの作成（APIキー）

プロジェクト直下に `.env` ファイルを作成し、以下を記述：

```
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

---

### ④ 必要パッケージのインストール

```bash
npm install node-fetch dotenv
```

---

## 4. 最小構成の GraphAI 対話ボットを作成

### `chat.mjs` の作成

```js
import readline from 'readline';
import 'dotenv/config';
const fetch = (...args) => import('node-fetch').then(({ default: fetch }) => fetch(...args));

const rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout
});

function promptUser() {
  rl.question('👤 あなた: ', async (input) => {
    if (input.toLowerCase() === 'exit') {
      console.log('👋 終了します！');
      rl.close();
      return;
    }

    const res = await fetch('https://api.openai.com/v1/chat/completions', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        Authorization: `Bearer ${process.env.OPENAI_API_KEY}`
      },
      body: JSON.stringify({
        model: 'gpt-4o',
        messages: [
          { role: 'system', content: 'あなたは親切なアシスタントです。' },
          { role: 'user', content: input }
        ]
      })
    });

    const json = await res.json();
    const reply = json.choices?.[0]?.message?.content ?? 'GPTの応答に失敗しました。';
    console.log(`🤖 GPT: ${reply}\n`);

    promptUser();
  });
}

promptUser();
```

---

### 実行方法

```bash
node chat.mjs
```

試しに `こんにちは` と入力してみてください。  
GPTが返答してくれるはずです。

---

## 5. ハマりポイントとその対処法

| ハマりポイント | 解決策 |
|----------------|--------|
| `fetch is not a function` | Node.jsでは標準搭載されていないため `node-fetch` を `import()`で読み込む |
| `.env` が読み込まれない | `dotenv/config` を `import` して読み込み |
| `chat.js` で動かない | `.mjs` 拡張子で作成する（ESM構文） |
| `input is not defined` | `rl.question()` の中で `input` を使うように構成する |

---

## 6. GraphAI そのものを使いたい人へ

GraphAI はまだnpm登録されていないため、GitHubからクローンする形になります：

```bash
git clone https://github.com/receptron/graphai.git
cd graphai
npm install
```

サンプルが豊富なので、まずは `examples` を眺めてみるのがオススメです。

---

## まとめ

- GraphAIは「エージェント思考」でAIワークフローを組める画期的な仕組み
- Windows + Node.jsでもサクッと動かせる
- ChatGPTと組み合わせて、CSVやAPI連携まで応用可能

---

## 今後やってみたいこと

- CSVで商品の在庫データを読み込んで、GPTに在庫回答をさせる
- GraphAIで社内問い合わせBotを構築
- GraphAI + Notion / Slack連携 などの業務自動化

---

## 参考リンク

- [GraphAI GitHub（receptron公式）](https://github.com/receptron/graphai)
- [OpenAI API公式ドキュメント](https://platform.openai.com/docs)

---

以上です！

「自分だけのAIアシスタントを作ってみたい」  
「AIを業務に組み込みたい」  
という方は、ぜひチャレンジしてみてください！

---

※ご質問・コメントもお気軽にどうぞ。もしこの記事が参考になったら LGTM・フォローいただけると励みになります！