AI-помощник для разработчиков Альфа-Банка

О проекте

Alfa API

Alfa API — платформа для интеграции внешних сервисов с продуктами Альфа-Банка.

Мы разработали AI-помощника, который помогает разработчикам находить информацию в документации, разбираться в OAuth-сценариях и диагностировать ошибки интеграции через единый чат-интерфейс.

Результаты

После запуска помощника разработчики получили быстрый доступ к знаниям по API без ручного поиска по документации.

−65% времени поиска информации
−48% нагрузки на техническую поддержку
+40% скорость запуска новых интеграций
+35% удовлетворенность разработчиков
24/7 доступ к документации через чат

Задача

Основная сложность заключалась не в отсутствии документации, а в скорости доступа к информации.

Ответ на один вопрос часто требовал изучения нескольких разделов одновременно:

OAuth-документации;
описания endpoint;
FAQ;
Release Notes;
интеграционных инструкций.

Необходимо было создать систему, которая сможет агрегировать информацию из разных источников и выдавать готовый ответ в формате диалога.

Почему не подошел обычный LLM-подход

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

Кроме того:

документация регулярно обновляется;
существуют различные версии API;
многие вопросы требуют информации сразу из нескольких документов.

Поэтому архитектура была построена вокруг RAG-подхода (Retrieval-Augmented Generation).

Архитектура решения

В основе системы лежит retrieval pipeline.

Документация проходит несколько этапов обработки:

очистка;
chunking;
генерация embeddings;
индексация в векторном хранилище.

При поступлении запроса выполняется поиск наиболее релевантных фрагментов документации через cosine similarity. Найденный контекст передается языковой модели для формирования ответа.

База знаний

В систему были загружены:

документация Alfa API;
OAuth и OpenID Connect сценарии;
FAQ;
Release Notes;
интеграционные инструкции;
описания endpoint и методов.

Это позволило создать единый слой знаний для работы помощника.

Получение информации по API

Один из самых востребованных сценариев — поиск информации по Authorization Code Flow и получению access_token.

Помощник предоставляет описание процесса, обязательные параметры и примеры запросов непосредственно в интерфейсе чата.

Диагностика ошибок интеграции

После запуска оказалось, что пользователи активно используют систему для диагностики ошибок.

Разработчик может передать код ошибки или текст ответа API и получить список возможных причин возникновения проблемы.

Основные технические вызовы проекта:

поиск по связанным разделам документации;
объединение информации из нескольких источников;
поддержка актуальности знаний;
снижение количества галлюцинаций;
корректная работа с техническими терминами и сокращениями.

Для повышения качества были доработаны механизмы chunking, retrieval и формирования контекста.

Контроль качества ответов

Для обеспечения точности используются:

retrieval по embeddings;
cosine similarity поиск;
reranking найденных документов;
ограничение контекста релевантными источниками.

Ответы формируются на основе найденной документации, а не внутренних знаний модели.

Итоги

AI-помощник стал единой точкой доступа к знаниям по Alfa API и помогает разработчикам решать задачи поиска информации, изучения OAuth-сценариев и диагностики интеграций через естественный диалог.

Решение ускорило работу с документацией, снизило нагрузку на поддержку и упростило запуск новых интеграций.

Вебинар по проекту

Отзыв

Команда R77 AI помогла разработать, протестировать и внедрить пилотное AI-решение для портала документации Alfa API. Чат-бот был успешно запущен и включён в список значимых инициатив блока цифровых каналов Альфа-Банка.

Антон Цапаев
Команда цифровых каналов Альфа-Банка

Финансы IT и разработка