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

Abierto Apto para principiantes
#219 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
86/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
python
Área
backend, documentation

Línea de trabajo

Lee backend/app/services/llm.py y localiza el system prompt de evaluate_interview(); después, inspecciona el ejemplo relevante de turns[].content en documents/backend/API仕様.md. Elimina la redacción obsoleta sobre filler tokens y actualiza el ejemplo para que no contenga filler tokens. Ejecuta el comando proporcionado de docker compose unittest discovery; se considera terminado cuando el prompt y la documentación de la API coincidan con el comportamiento de entrada sin filler tokens y las pruebas existentes pasen correctamente.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

種別: 実装 — コードを書き、検証してから 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を常にフィラー除去済みにする。着手順序はどちらが先でも支障ないが、対で完了させることが望ましい

未決事項

なし。

参考

Lenguaje dominante
HTML
Estrellas
1
Forks
0
Merge medio
1 h 19 min
PR fusionados (30 d)
76

Guía de contribución

No hay ninguna guía de contribución indexada para este repositorio

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de study-basic-hackathon/hanasu

Todos los issues de study-basic-hackathon/hanasu

Issues similares

Más issues de Backend & API Design

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.