> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ukrgsm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# База знань

> Завантажуйте документи, на які голосовий агент може посилатись під час живих розмов, щоб давати точні відповіді з урахуванням контексту.

База знань дозволяє завантажувати документи, на які ваші голосові агенти можуть посилатись під час розмов. Замість того, щоб закладати всю інформацію в промпти, ви надаєте вихідні документи, а агент отримує потрібний вміст на льоту.

<Warning>
  Для режиму **Пошук по фрагментах** потрібен API-ключ моделі embeddings (налаштовується в конфігурації моделей → Embedding). Режим **Повний документ** embeddings не потребує.
</Warning>

<img src="https://mintcdn.com/ukr-gsm/pisYMZLRPGIEw4_r/images/embedding-configurations.png?fit=max&auto=format&n=pisYMZLRPGIEw4_r&q=85&s=517bb0f4855926413da4eac917e34b26" alt="Налаштування embeddings" width="873" height="620" data-path="images/embedding-configurations.png" />

## Як це працює

1. Ви **завантажуєте** документ (PDF, DOCX, TXT або JSON) у базу знань.
2. Ви **обираєте режим отримання** — Повний документ або Пошук по фрагментах.
3. Платформа **обробляє** документ відповідно до обраного режиму.
4. Ви **прикріплюєте** документ до одного або кількох вузлів сценарію.
5. Під час дзвінка агент **отримує** інформацію з документа й використовує її для точної відповіді.

## Підтримувані формати файлів

| Формат | Розширення      |
| ------ | --------------- |
| PDF    | `.pdf`          |
| Word   | `.docx`, `.doc` |
| Текст  | `.txt`          |
| JSON   | `.json`         |

Максимальний розмір файлу: **5 МБ**

## Завантаження документів

1. Перейдіть у розділ файлів бази знань у кабінеті.
2. Натисніть **Upload New** або перетягніть файл.
3. Оберіть **режим отримання** (див. нижче).
4. Натисніть **Upload & Process** — документ буде оброблено відповідно до обраного режиму.

### Режими отримання

При завантаженні документа ви обираєте, як агент отримуватиме з нього інформацію:

<CardGroup cols={2}>
  <Card title="Повний документ" icon="file-lines">
    Увесь текст документа передається агенту щоразу, коли він звертається до бази знань. Розбиття на фрагменти й embeddings не використовуються.

    **Найкраще підходить для:** прайс-листів, меню, FAQ, коротких довідкових аркушів — усього, де агенту потрібен доступ до всієї інформації одразу.

    <Tip>Режим «Повний документ» не потребує API-ключа embeddings.</Tip>
  </Card>

  <Card title="Пошук по фрагментах" icon="magnifying-glass">
    Документ розбивається на менші фрагменти й індексується за допомогою векторних embeddings. Коли агент звертається до бази знань, повертаються лише найрелевантніші фрагменти.

    **Найкраще підходить для:** великих документів на кшталт політик, інструкцій чи договорів, де для конкретного питання релевантна лише частина тексту.
  </Card>
</CardGroup>

## Прикріплення документів до вузлів

Після обробки документ можна прикріпити до будь-якого вузла **Початок дзвінка** чи **Вузол агента**:

1. Відкрийте діалог редагування вузла.
2. Прокрутіть до розділу **Документи бази знань**.
3. Оберіть один або кілька документів, на які агент може посилатись.

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

## Найкращі практики

* **Використовуйте «Повний документ» для невеликих довідкових файлів** — меню, прайс-листи й FAQ найкраще працюють, коли агент бачить весь документ.
* **Використовуйте «Пошук по фрагментах» для великих документів** — політики, інструкції та договори зазвичай завеликі для одного контексту, тож пошук по фрагментах знаходить релевантні розділи.
* **Тримайте документи сфокусованими** — один документ на одну тему дає кращі результати пошуку, ніж великий багатотемний файл.
* **Використовуйте чіткий, структурований вміст** — заголовки, списки й короткі абзаци допомагають процесу розбиття на фрагменти.
* **Прикріплюйте вибірково** — прикріплюйте лише документи, релевантні конкретному вузлу, а не все й усюди.
* **Оновлюйте документи вчасно** — перезавантажуйте, коли змінюється вихідна інформація, щоб уникнути застарілих відповідей.