口コミや問い合わせ文が入った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を公開したり共有したりしないでください