Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

[backend]構成・内容の評価プロンプトとAPI仕様書の例からフィラートークンを外す

Đang mở Phù hợp với người mới
#219 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
86/100
Loại issue
Lỗi
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
python
Lĩnh vực
backend, documentation

Hướng nghiên cứu

Đọc backend/app/services/llm.py và xác định system prompt của evaluate_interview(), sau đó kiểm tra ví dụ turns[].content liên quan trong documents/backend/API仕様.md. Xóa phần diễn đạt lỗi thời về filler tokens và cập nhật ví dụ để không có filler tokens. Chạy lệnh docker compose unittest discovery được cung cấp; công việc được xem là hoàn tất khi prompt và tài liệu API khớp với hành vi đầu vào không có filler tokens, đồng thời các bài kiểm thử hiện có đều vượt qua.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

種別: 実装 — コードを書き、検証してから PR を出す。

目的

評価APIの turns[].content がフィラー除去済みテキストになる仕様変更（#218）に合わせ、構成・内容を評価するLLMへのプロンプトと、正本であるAPI仕様書の記載を実態に合わせる。

現行の backend/app/services/llm.py の evaluate_interview() は、システムプロンプトで「%で囲まれた語（例: %えー%）は文字起こしが検出したフィラー（言い淀み）です」とLLMに明示し、フィラートークンを言い淀みとして解釈させた上で構成・内容のコメント・アドバイスを生成させている。documents/backend/API仕様.md の turns[].content 例もフィラートークン付きの文字列になっている。#218 でフロントエンドが常にフィラー除去済みテキストを送るようになると、このプロンプトの一文とAPI仕様書の例は実態と食い違う。

完了条件

  • backend/app/services/llm.py の evaluate_interview() システムプロンプトから「%で囲まれた語（例: %えー%）は文字起こしが検出したフィラー（言い淀み）です。」の一文を削除する
  • documents/backend/API仕様.md の turns[].content 例（該当箇所）をフィラートークンを含まないテキストに更新する
  • 既存のバックエンドのテストが変更後も成功する

やらないこと

  • フィラー数・話速の算出ロジック（filler_count 等）の変更
  • フロントエンドの変更（#218 で対応）
  • /interviews/chat 側のプロンプト・仕様変更

触る範囲

  • backend/app/services/llm.py
  • documents/backend/API仕様.md
  • 関連テスト

検証方法

docker compose build api
docker compose run --rm --no-deps -e SEED_DEV_USER=false -e JWT_SECRET_KEY=test-secret api uv run --frozen python -m unittest discover -s tests

前提・依存

  • 関連Issue: #218 — 評価APIへ送るcontentを常にフィラー除去済みにする。着手順序はどちらが先でも支障ないが、対で完了させることが望ましい

未決事項

なし。

参考

Ngôn ngữ chính
HTML
Star
1
Fork
0
Merge trung bình
1 giờ 19 phút
Pull request đã merge (30 ngày)
76

Hướng dẫn đóng góp

Chưa lập chỉ mục được hướng dẫn đóng góp cho kho mã nguồn này

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của study-basic-hackathon/hanasu

Tất cả issue của study-basic-hackathon/hanasu

Issue tương tự

Thêm issue về Backend & API Design

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.