0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

ChatGPT API(Responses API)でCSVの口コミを一括分類するPythonスクリプト

0
Posted at

口コミや問い合わせ文が入ったCSVを読み込んで、1件ずつカテゴリを付けて書き出すスクリプトです。「読んで、決まった選択肢から1つ付ける」作業の自動化に使えます。

使うAPIは Responses API(新規開発で推奨されている形式)です。

準備

Python 3.10以上で、ライブラリを入れます。

pip install openai python-dotenv

.env にAPIキーとモデル名を書きます。

OPENAI_API_KEY=sk-xxxx...
OPENAI_MODEL=gpt-5.4-mini

モデル名は .env の1か所にまとめています。モデルの廃止や乗り換えのときにコードを直さずに済むためです。

スクリプト全文

import csv
import os
import sys
from pathlib import Path

from dotenv import load_dotenv
from openai import OpenAI

load_dotenv()

DEFAULT_MODEL = "gpt-5.4-mini"
MODEL = os.getenv("OPENAI_MODEL", DEFAULT_MODEL)

# 分類したい文章が入っている列の名前
TEXT_COLUMN = "review"
# 分類結果を書き込む列の名前
CATEGORY_COLUMN = "category"
# 分類の選択肢(自分の業務に合わせて自由に変えてください)
CATEGORIES = ["味・品質", "接客", "価格", "雰囲気・清潔さ", "その他"]


def classify_text(client, text):
    """文章を CATEGORIES のどれか1つに分類し、カテゴリ名を返します。"""
    response = client.responses.create(
        model=MODEL,
        instructions=(
            "あなたは口コミ分類の担当者です。渡された文章を、次のカテゴリから最も合うもの "
            "1つに分類し、カテゴリ名だけを返してください。説明や句読点は付けないでください。\n"
            f"カテゴリ: {', '.join(CATEGORIES)}"
        ),
        input=text,
    )
    category = response.output_text.strip()
    # 想定外の返答が来たら「その他」に寄せて、処理が止まらないようにする
    return category if category in CATEGORIES else "その他"


def process_csv(client, input_path, output_path):
    """CSVを読み、全行にカテゴリを付けて書き出します。処理件数を返します。"""
    # utf-8-sig にすると、Excelで作ったCSV(BOM付き)も文字化けせず読めます
    with open(input_path, encoding="utf-8-sig", newline="") as f:
        reader = csv.DictReader(f)
        fieldnames = list(reader.fieldnames or [])
        rows = list(reader)

    if TEXT_COLUMN not in fieldnames:
        raise ValueError(f"入力CSVに列「{TEXT_COLUMN}」がありません。TEXT_COLUMN の設定を確認してください。")
    if CATEGORY_COLUMN not in fieldnames:
        fieldnames.append(CATEGORY_COLUMN)

    for i, row in enumerate(rows, start=1):
        row[CATEGORY_COLUMN] = classify_text(client, row[TEXT_COLUMN])
        print(f"{i}/{len(rows)} 件: {row[CATEGORY_COLUMN]}")

    with open(output_path, "w", encoding="utf-8", newline="") as f:
        writer = csv.DictWriter(f, fieldnames=fieldnames)
        writer.writeheader()
        writer.writerows(rows)
    return len(rows)


def main():
    input_path = Path(sys.argv[1]) if len(sys.argv) > 1 else Path("reviews.csv")
    output_path = Path(sys.argv[2]) if len(sys.argv) > 2 else Path("reviews_classified.csv")
    if not input_path.exists():
        print(f"ファイルが見つかりません: {input_path}")
        raise SystemExit(1)

    client = OpenAI()
    count = process_csv(client, input_path, output_path)
    print(f"\n完了: {count} 件を分類して {output_path} に保存しました。")


if __name__ == "__main__":
    main()

入力CSVの例

review 列に文章が入ったCSVを用意します。

review
コーヒーがとても美味しくて、豆の香りがしっかりしていました。
店員さんが丁寧に豆の説明をしてくれて、気持ちよく過ごせました。
値段が少し高めですが、この味なら納得です。
店内が明るく清潔で、席の間隔も広くて快適でした。
ケーキの甘さがちょうどよく、美味しかったです。

実行と出力

python classify.py reviews.csv reviews_classified.csv

出力CSVには category 列が付きます。

review,category
コーヒーがとても美味しくて、豆の香りがしっかりしていました。,味・品質
店員さんが丁寧に豆の説明をしてくれて、気持ちよく過ごせました。,接客
値段が少し高めですが、この味なら納得です。,価格
店内が明るく清潔で、席の間隔も広くて快適でした。,雰囲気・清潔さ
ケーキの甘さがちょうどよく、美味しかったです。,味・品質

自分の用途に合わせるには

書き換えるのは冒頭の定数だけです。

  • TEXT_COLUMN:分類したい文章の列名
  • CATEGORIES:分類の選択肢。問い合わせの振り分けなら「料金/操作/不具合/その他」のように業務の言葉に変えます

工夫した点

  • 返答の形を縛る:指示で「カテゴリ名だけを返してください」と決め打ちしています。説明文が混ざるとCSVに書き込めないためです
  • 想定外の返答で止まらない:カテゴリに無い返答が来たら「その他」に寄せます。大量処理の途中で止まるのを防ぐ保険です
  • BOM対策:読み込みを utf-8-sig にして、Excel製CSVの文字化けを防いでいます

注意点

  • APIは従量課金で、ChatGPTの有料プランとは別料金です。短文の分類は1件あたりの文章量が小さいですが、件数が多い場合は先に数件で試してから回してください
  • モデル名・料金は変わりやすいので、最新情報は公式ページで確認してください
  • APIキーはパスワードと同じです。.env を公開したり共有したりしないでください
0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?