Выгрузка в векторную БД

Обработка APA_ВыгрузкаВВекторнуюБД предназначена для выгрузки данных в векторную базу данных для использования в RAG.

Назначение

RAG (Retrieval-Augmented Generation) позволяет агентам использовать внутренние базы знаний:

• Документация компании

• Регламенты и инструкции

• Базы знаний

• Справочные данные

Принцип работы RAG

┌─────────────────┐         ┌─────────────────┐
│  Вопрос         │         │  Векторная БД   │
│  пользователя   │────────►│  (знания)       │
└─────────────────┘         └────────┬────────┘
                                     │
                            релевантные документы
                                     │
                                     ▼
                            ┌─────────────────┐
                            │      LLM        │
                            │  (генерация     │
                            │   ответа)       │
                            └─────────────────┘

Интерфейс обработки

┌─────────────────────────────────────────────────────────────────────────┐
│  Выгрузка в векторную БД                               [—][□][×]        │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│  Параметры подключения:                                                  │
│  ┌────────────────────────────────────────────────────────────────────┐ │
│  │ Адрес БД:    [http://localhost:8000                            ]   │ │
│  │ Коллекция:   [company_docs                                     ]   │ │
│  └────────────────────────────────────────────────────────────────────┘ │
│                                                                          │
│  Источник данных:                                                        │
│  ┌────────────────────────────────────────────────────────────────────┐ │
│  │ ○ Справочник                                                       │ │
│  │ ○ Документ                                                         │ │
│  │ ● Произвольный запрос                                              │ │
│  │                                                                     │ │
│  │ Код запроса:                                                        │ │
│  │ ┌────────────────────────────────────────────────────────────────┐ │ │
│  │ │ ВЫБРАТЬ Наименование, Содержимое                               │ │ │
│  │ │ ИЗ Справочник.БазаЗнаний                                       │ │ │
│  │ └────────────────────────────────────────────────────────────────┘ │ │
│  └────────────────────────────────────────────────────────────────────┘ │
│                                                                          │
│  Опции:                                                                  │
│  ┌────────────────────────────────────────────────────────────────────┐ │
│  │ ☐ Очистить коллекцию перед загрузкой                               │ │
│  │ ☑ Показывать прогресс                                              │ │
│  └────────────────────────────────────────────────────────────────────┘ │
│                                                                          │
│                                              [Выгрузить]  [Закрыть]     │
└─────────────────────────────────────────────────────────────────────────┘

Реквизиты обработки

Реквизит	Тип	Описание
АдресБД	Строка	URL векторной базы данных
Коллекция	Строка	Имя коллекции в БД
СвойКод	Строка	Код запроса для выбора данных
ОчиститьКоллекцию	Булево	Удалить существующие данные

Выгрузка данных

Шаг 1: Настройка подключения

Укажите адрес векторной БД:

БД	Пример адреса
Chroma	http://localhost:8000
Milvus	http://localhost:19530
Pinecone	https://xxx.pinecone.io
Qdrant	http://localhost:6333

Шаг 2: Выбор коллекции

Укажите имя коллекции:

• company_docs — документация компании

• regulations — регламенты

• faq — часто задаваемые вопросы

Шаг 3: Определение источника данных

Напишите запрос для выбора данных:

ВЫБРАТЬ
    Наименование КАК Заголовок,
    Содержимое КАК Текст,
    Код КАК ID
ИЗ
    Справочник.БазаЗнаний
ГДЕ
    НЕ ПометкаУдаления

Шаг 4: Выгрузка

Нажмите "Выгрузить" и дождитесь завершения.

Примеры запросов

Выгрузка справочника

ВЫБРАТЬ
    Наименование,
    Описание
ИЗ
    Справочник.Номенклатура
ГДЕ
    НЕ ПометкаУдаления

Выгрузка документов

ВЫБРАТЬ
    Номер,
    Дата,
    Комментарий
ИЗ
    Документ.ЗаказКлиента
ГДЕ
    Дата >= &НачалоПериода

Выгрузка регистра

ВЫБРАТЬ
    Вопрос,
    Ответ,
    Категория.Наименование КАК Категория
ИЗ
    РегистрСведений.ЧастыеВопросы

Использование в агентах

Создание инструмента RAG

1. Создайте инструмент "Поиск в базе знаний"

2. В коде инструмента вызовите модуль APA_RAG:

// Инструмент: Поиск в базе знаний
// Параметр: Запрос (string)

ЗапросПользователя = Параметры.Запрос;

// Поиск в векторной БД
Результаты = APA_RAG.НайтиДокументы(
    "http://localhost:8000",
    "company_docs",
    ЗапросПользователя,
    5  // количество результатов
);

Возврат Результаты;

Пример диалога с RAG

Пользователь: Какова процедура оформления командировки?

Агент:
📊 Поиск в базе знаний...

Согласно внутреннему регламенту компании (документ "Положение о 
командировках" от 01.01.2025), процедура оформления включает:

1. Заполнение заявки на командировку в системе
2. Согласование с непосредственным руководителем
3. Утверждение в отделе кадров
4. Оформление приказа и командировочного удостоверения
5. Получение аванса в бухгалтерии

Срок оформления: не позднее 3 рабочих дней до даты выезда.

Поддерживаемые векторные БД

База данных	Описание	URL
Chroma	Простая, open-source	chromadb.com
Milvus	Масштабируемая	milvus.io
Pinecone	Облачная	pinecone.io
Qdrant	Высокопроизводительная	qdrant.tech
Weaviate	С AI-интеграциями	weaviate.io

Рекомендации

Подготовка данных

• Очищайте текст от HTML-тегов и спецсимволов

• Разбивайте длинные документы на фрагменты

• Добавляйте метаданные (категория, дата, автор)

Размер фрагментов

Тип документа	Рекомендуемый размер
FAQ	200-500 символов
Инструкции	500-1000 символов
Регламенты	1000-2000 символов

Обновление данных

• Настройте регулярную выгрузку

• Используйте инкрементальное обновление

• Очищайте устаревшие данные

Устранение проблем

Ошибка подключения к БД

1. Проверьте URL базы данных

2. Убедитесь, что БД запущена

3. Проверьте firewall

Медленная выгрузка

1. Уменьшите объём данных

2. Оптимизируйте запрос

3. Увеличьте ресурсы сервера БД

Плохое качество поиска

1. Улучшите качество текстов

2. Настройте параметры эмбеддингов

3. Увеличьте количество возвращаемых результатов

Далее

Экспорт/импорт агентов