> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.ai-kt.kz/llms.txt
> Use this file to discover all available pages before exploring further.

# Продвинутые функции

> База знаний, инструменты, API, MCP и другие возможности для расширения агента

<iframe width="100%" height="400" src="https://www.youtube.com/embed/R99MAaDJt4U" title="Видео-урок: Продвинутые функции" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen style={{ borderRadius: "12px", marginBottom: "24px" }} />

## Обзор

Базовый агент работает на основе системного промпта и отвечает на вопросы из своих общих знаний. Чтобы агент работал с вашими данными и обращался к внешним системам, нужно подключить дополнительные компоненты:

* **База знаний** — ваши документы, по которым агент ищет информацию
* **Инструменты** — подключения к внешним системам и сервисам
* **API** — прямое обращение к программным интерфейсам
* **MCP** — стандарт подключения к внешним инструментам

***

## База знаний

База знаний — это набор документов, к которым агент обращается при ответе на вопросы. Вместо того чтобы отвечать из общих знаний, агент ищет релевантную информацию в ваших файлах.

### Как это работает

Когда пользователь задаёт вопрос, агент разбивает документы на фрагменты, находит наиболее подходящие и использует их для формирования ответа. Это называется RAG (Retrieval-Augmented Generation).

### Как подключить базу знаний

<Steps>
  <Step title="Создайте базу знаний">
    Перейдите в раздел «Фабрика знаний» и нажмите «Создать базу знаний». Укажите название и описание.
  </Step>

  <Step title="Загрузите документы">
    Добавьте файлы, которые агент должен использовать. Поддерживаются форматы: PDF, DOCX, TXT, XLSX, CSV и другие.

    **Что загружать:**

    * Регламенты и инструкции
    * Шаблоны документов
    * Справочные материалы
    * Часто задаваемые вопросы с ответами
    * Нормативные документы
  </Step>

  <Step title="Дождитесь обработки">
    Платформа проиндексирует документы. Время зависит от объёма: несколько документов обрабатываются за минуту, большие базы — дольше.
  </Step>

  <Step title="Подключите к агенту">
    Откройте карточку агента, найдите раздел «База знаний» и выберите созданную базу. Один агент может использовать несколько баз.
  </Step>
</Steps>

### Как проверить качество базы знаний

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

* Задайте вопрос, ответ на который точно есть в загруженных документах
* Проверьте, что агент ссылается на правильный документ
* Задайте вопрос, ответа на который в документах нет — агент должен сообщить, что не нашёл информацию

<Warning>
  Качество ответов напрямую зависит от качества загруженных документов. Если документы содержат устаревшую или противоречивую информацию, агент может давать некорректные ответы.
</Warning>

***

## Инструменты

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

### Когда нужны инструменты

| Задача                               | Нужны ли инструменты                  |
| ------------------------------------ | ------------------------------------- |
| Ответить на вопрос по регламенту     | Нет, достаточно базы знаний           |
| Сформировать документ в формате Word | Да, нужен инструмент генерации файлов |
| Получить данные из CRM               | Да, нужно API-подключение             |
| Проверить статус заявки              | Да, нужна интеграция с системой       |
| Выполнить расчёт по формуле          | Да, нужен вычислительный инструмент   |

### Навыки (Skills)

Навыки — это готовые наборы инструкций, которые можно подключить к агенту. Они описывают, как агент должен выполнять определённое действие.

**Пример:** навык «Генерация Word-документа» описывает агенту, как собрать данные из диалога и оформить их в файл по шаблону.

Навыки подключаются в карточке агента в разделе «Инструменты».

***

## API

API (Application Programming Interface) — это способ, которым одна программа обращается к другой. Когда агенту нужно получить данные из внешней системы или отправить туда информацию, он делает это через API.

### Как это выглядит на практике

Допустим, агент должен проверить статус заявки в системе документооборота. Для этого:

1. Администратор настраивает подключение к API системы документооборота
2. В карточке агента добавляется инструмент «Проверка статуса заявки»
3. Когда пользователь спрашивает «Какой статус у заявки 12345?», агент обращается к API, получает ответ и показывает его пользователю

### Настройка API

<Steps>
  <Step title="Перейдите в раздел «Инструменты»">
    На главной панели платформы выберите раздел «Инструменты».
  </Step>

  <Step title="Создайте новое подключение">
    Нажмите «Добавить» и выберите тип «API». Укажите URL, метод (GET, POST), заголовки и параметры.
  </Step>

  <Step title="Протестируйте подключение">
    Отправьте тестовый запрос и убедитесь, что система возвращает корректный ответ.
  </Step>

  <Step title="Подключите к агенту">
    В карточке агента добавьте созданный инструмент. Опишите в системном промпте, когда и как агент должен его использовать.
  </Step>
</Steps>

<Note>
  Для настройки API-подключений может потребоваться помощь технического специалиста, так как нужно знать формат запросов и иметь ключи доступа к внешней системе.
</Note>

***

## MCP (Model Context Protocol)

MCP — это стандарт подключения ИИ-агентов к внешним инструментам. Если API — это конкретное подключение к одной системе, то MCP — это универсальный способ подключить агента к множеству инструментов через единый интерфейс.

### Чем MCP отличается от API

| Характеристика          | API                                        | MCP                                                        |
| ----------------------- | ------------------------------------------ | ---------------------------------------------------------- |
| Настройка               | Требует знания формата конкретного сервиса | Единый стандартный формат                                  |
| Количество инструментов | Одно подключение = один сервис             | Один MCP-сервер может предоставлять несколько инструментов |
| Обнаружение             | Нужно знать заранее, какие методы доступны | Агент сам узнаёт, какие инструменты доступны               |
| Применение              | Интеграция с конкретной системой           | Универсальный доступ к набору сервисов                     |

### Когда использовать MCP

MCP полезен, когда нужно подключить агента к нескольким инструментам одновременно или когда для вашей задачи уже существует готовый MCP-сервер. Платформа Alem AI поддерживает подключение MCP-серверов через раздел «Инструменты».

***

## Рекомендации по расширению агента

<AccordionGroup>
  <Accordion title="Начните с базы знаний">
    Большинство задач решаются комбинацией промпта и базы знаний. Подключайте инструменты только если базы знаний недостаточно.
  </Accordion>

  <Accordion title="Добавляйте инструменты по одному">
    Не подключайте всё сразу. Добавьте один инструмент, протестируйте, убедитесь, что работает — затем добавьте следующий.
  </Accordion>

  <Accordion title="Описывайте инструменты в промпте">
    Если агент имеет доступ к инструменту, но не знает, когда его использовать, он может обращаться к нему без необходимости или игнорировать. Опишите в промпте, в каких случаях агент должен использовать каждый инструмент.
  </Accordion>

  <Accordion title="Тестируйте после каждого изменения">
    Каждое новое подключение может повлиять на поведение агента. Тестируйте основные сценарии после каждого добавления.
  </Accordion>
</AccordionGroup>

***

<Card title="Как найти задачу для автоматизации →" icon="magnifying-glass" href="/assessment">
  Критерии оценки задач, расчёт экономического эффекта и пошаговый алгоритм.
</Card>