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"]
- Issue загружается по URL через GitHub API или берётся из аргументов.
- Промпт требует ответ строго в JSON.
parse_json_responseснимает обёртку```jsonи парсит.- Результат печатается. Действий с 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 только после подтверждения.
Связь с другими разделами
Заголовок раздела «Связь с другими разделами»- Разработка — домен и метрики.
- Структурированный вывод — как убрать хрупкий разбор.
- LangChain — фреймворк.
Материалы и источники
Заголовок раздела «Материалы и источники»- GitHub REST API — загрузка issue по URL.