О проекте
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 и получить список возможных причин возникновения проблемы.
Разработчик может передать код ошибки или текст ответа API и получить список возможных причин возникновения проблемы.
Основные технические вызовы проекта:
- поиск по связанным разделам документации;
- объединение информации из нескольких источников;
- поддержка актуальности знаний;
- снижение количества галлюцинаций;
- корректная работа с техническими терминами и сокращениями.
Для повышения качества были доработаны механизмы chunking, retrieval и формирования контекста.
Контроль качества ответов
Для обеспечения точности используются:
- retrieval по embeddings;
- cosine similarity поиск;
- reranking найденных документов;
- ограничение контекста релевантными источниками.
Ответы формируются на основе найденной документации, а не внутренних знаний модели.
Итоги
AI-помощник стал единой точкой доступа к знаниям по Alfa API и помогает разработчикам решать задачи поиска информации, изучения OAuth-сценариев и диагностики интеграций через естественный диалог.
Решение ускорило работу с документацией, снизило нагрузку на поддержку и упростило запуск новых интеграций.
Вебинар по проекту
Отзыв
Команда R77 AI помогла разработать, протестировать и внедрить пилотное AI-решение для портала документации Alfa API. Чат-бот был успешно запущен и включён в список значимых инициатив блока цифровых каналов Альфа-Банка.
Антон Цапаев
Команда цифровых каналов Альфа-Банка
