RAG Support Assistant

Агент поддержки находит документы по продукту, проводит каждый ответ через LangGraph и опирается только на известные источники.

Смотреть пример Воспроизвести E20 GitHub

Доказательства

Опубликованная документация

Документация опубликована под /RAG_Support_Assistant. Английская и русская стартовые страницы поддерживаются явно.

Засеянная демо-база

Демо-база начинается с трёх документов: гарантия, возвраты и ошибки E10-E30. E20 описан в errors_e10_e30.md.

Оценка по фикстуре

Набор содержит 12 кейсов по шести темам: коды ошибок, сброс пароля, гарантия, установка, биллинг и общие вопросы. Демо-база из трёх документов покрывает не все темы фикстуры.

Прослеживаемая API-поверхность

Каталог API строится из декораторов маршрутов FastAPI, а /api/ask возвращает ответ вместе с источниками и пронумерованными ссылками-цитатами.

Путь одного вопроса через LangGraph

Полный flowchart со всеми 12 узлами и условными переходами автоматически генерируется из agent/graph.py на странице LangGraph state machine.

Что возвращает `/api/ask` на вопрос «Как исправить E20?»

{
  "answer": "Ошибка E20 связана с проблемой слива воды. Возможные причины: засорённый сливной фильтр, перегиб сливного шланга или неисправность сливного насоса [1].",
  "sources": [
    { "source": "errors_e10_e30.md", "page_content": "E20 — проблема со сливом воды …" }
  ],
  "citations": [
    { "index": 1, "doc_id": "errors_e10_e30.md", "title": "errors_e10_e30.md", "excerpt": "клапан слива / фильтр …" }
  ]
}

Форма закреплена Pydantic-моделями AskResponse, SourceInfo, Citation в api/routers/conversation.py. Полный разбор узлов графа — на странице Что делает ассистент.

Начать здесь

Что делает ассистент — один вопрос E20 проходит через весь граф.
Воспроизвести E20 — детерминированный путь доверия: засеять, загрузить, спросить, проверить.
Запустить локально — как поднять стек локально.
Оценка — что измеряется, как, и где границы.
GitHub — исходный код.