﻿---
title: "07. GitHub Issue Triager: классификация обращений"
description: LangChain-агент определяет серьёзность, категорию и маршрут для GitHub issue; пример структурированного вывода с ручным разбором JSON.
---

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

## Задача

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

## Архитектура

```mermaid
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 не выполняется.

## Что в коде

```python
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 провайдера или валидацию схемой вместо
  регулярки — см. [Структурированный вывод](https://wpcraft.ru/aia/patterns/structured-output.md).
- Закрытые перечисления для `category` и `severity`.
- Сохранять решение человека и сравнивать с ним на наборе — это готовая метрика
  качества классификации.
- Писать результат в issue только после подтверждения.

## Связь с другими разделами

- [Разработка](https://wpcraft.ru/aia/use-cases/software-development.md) — домен и метрики.
- [Структурированный вывод](https://wpcraft.ru/aia/patterns/structured-output.md) — как убрать хрупкий
  разбор.
- [LangChain](https://wpcraft.ru/aia/frameworks/langchain.md) — фреймворк.

## Материалы и источники

- [GitHub REST API](https://docs.github.com/en/rest) — загрузка issue по URL.