Skip to main content

​
Обзор

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

​
База знаний

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

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

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

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

1

Создайте базу знаний

Перейдите в раздел «Фабрика знаний» и нажмите «Создать базу знаний». Укажите название и описание.
2

Загрузите документы

Добавьте файлы, которые агент должен использовать. Поддерживаются форматы: PDF, DOCX, TXT, XLSX, CSV и другие.Что загружать:
  • Регламенты и инструкции
  • Шаблоны документов
  • Справочные материалы
  • Часто задаваемые вопросы с ответами
  • Нормативные документы
3

Дождитесь обработки

Платформа проиндексирует документы. Время зависит от объёма: несколько документов обрабатываются за минуту, большие базы — дольше.
4

Подключите к агенту

Откройте карточку агента, найдите раздел «База знаний» и выберите созданную базу. Один агент может использовать несколько баз.

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

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

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

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

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

​
Навыки (Skills)

Навыки — это готовые наборы инструкций, которые можно подключить к агенту. Они описывают, как агент должен выполнять определённое действие. Пример: навык «Генерация Word-документа» описывает агенту, как собрать данные из диалога и оформить их в файл по шаблону. Навыки подключаются в карточке агента в разделе «Инструменты».

​
API

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

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

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

​
Настройка API

1

Перейдите в раздел «Инструменты»

На главной панели платформы выберите раздел «Инструменты».
2

Создайте новое подключение

Нажмите «Добавить» и выберите тип «API». Укажите URL, метод (GET, POST), заголовки и параметры.
3

Протестируйте подключение

Отправьте тестовый запрос и убедитесь, что система возвращает корректный ответ.
4

Подключите к агенту

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

​
MCP (Model Context Protocol)

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

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

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

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

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

Большинство задач решаются комбинацией промпта и базы знаний. Подключайте инструменты только если базы знаний недостаточно.
Не подключайте всё сразу. Добавьте один инструмент, протестируйте, убедитесь, что работает — затем добавьте следующий.
Если агент имеет доступ к инструменту, но не знает, когда его использовать, он может обращаться к нему без необходимости или игнорировать. Опишите в промпте, в каких случаях агент должен использовать каждый инструмент.
Каждое новое подключение может повлиять на поведение агента. Тестируйте основные сценарии после каждого добавления.

Как найти задачу для автоматизации →

Критерии оценки задач, расчёт экономического эффекта и пошаговый алгоритм.