Перейти к содержимому

07. GitHub Issue Triager: классификация обращений

Классификатор issue: серьёзность, категория, метки и рекомендация по маршруту. Хороший пример того, как структурированный вывод делается вручную — и почему лучше доверить это схеме.

По заголовку, телу и существующим меткам определить приоритет, тип проблемы и кому её передать. Граница: агент не проверяет, действительно ли баг воспроизводится, и не назначает исполнителя.

flowchart LR
  I["Issue (URL или title+body)"] --> P["Промпт с JSON-схемой"]
  P --> L["Модель"]
  L --> J["parse_json_response"]
  J --> T["severity, category, labels, route"]
  1. Issue загружается по URL через GitHub API или берётся из аргументов.
  2. Промпт требует ответ строго в JSON.
  3. parse_json_response снимает обёртку ```json и парсит.
  4. Результат печатается. Действий с issue не выполняется.
def parse_json_response(text: str) -> dict:
cleaned = text.strip()
cleaned = re.sub(r"^```(?:json)?\s*", "", cleaned)
cleaned = re.sub(r"\s*```$", "", cleaned)
return json.loads(cleaned)
  • Ручной разбор JSON — хрупкий приём. Он есть почти во всех примерах каталога: модель оборачивает ответ в Markdown, и код вырезает обёртку регуляркой.
  • Явная схема в промпте работает, но не гарантирует результат.
  • Классификация — не агентная задача. Один вызов модели достаточен.
  • json.loads падает на обрезанном или «почти правильном» JSON — без повтора и без понятной ошибки.
  • Свободные значения. Категория может оказаться новой, которой нет в маршрутизации.
  • Нет валидации бизнес-правил. severity: critical у вопроса «как установить?» никто не отловит.
  • Нет обратной связи. Агент не учится на исправлениях дежурного.
  • Использовать structured outputs провайдера или валидацию схемой вместо регулярки — см. Структурированный вывод.
  • Закрытые перечисления для category и severity.
  • Сохранять решение человека и сравнивать с ним на наборе — это готовая метрика качества классификации.
  • Писать результат в issue только после подтверждения.