Инструменты и навыки

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

Настройка инструментов выполняется на вкладке MCP и инструменты формы ассистента.

Поля вкладки MCP и инструменты

Поле	Обязательно	Описание
Базовый адаптер	Да	Выберите адаптер, в котором содержится обязательный набор базовых методов. Этот адаптер будет использоваться всегда, в том числе при поиске по базам знаний и запуске навыков.
Макс. итераций инструментов	Нет	Укажите максимальное количество обращений к инструментам для генерации одного ответа. Значение по умолчанию: 5.
Включено	Нет	Установите флажок, чтобы разрешить ассистенту использовать инструменты. Если флажок снят, инструменты будут недоступны для ассистента.
Адаптеры	Нет	Выберите список дополнительных адаптеров, доступных ассистенту.
Скиллы	Нет	Выберите скиллы (навыки) – готовые сценарии выполнения задач, которые будут доступны ассистенту.

Инструменты

---

Инструмент – это метод, который ассистент может вызвать во время диалога, чтобы получить данные или выполнить действие.

Виды инструментов:

• Внутренние методы – действия внутри платформы SimpleOne.
• MCP-инструменты – внешние инструменты, подключенные по протоколу MCP (Model Context Protocol).

Инструменты объединяются в адаптеры – тематические наборы. Например, адаптер "databases" может содержать инструменты для работы с базами данных, а адаптер "Отчет по инцидентам" – инструменты для формирования отчетов.

note

Флажок Включено на вкладке MCP и инструменты является общим переключателем как для инструментов, так и для режима поиска знаний. Если флажок снят, ассистент не может использовать инструменты, даже если адаптеры выбраны.

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

Когда для ответа пользователю требуются данные из инструмента, ассистент вызывает подходящий и после получения результата продолжает формировать ответ. При необходимости ассистент может вызвать несколько инструментов подряд. Вы можете настроить максимальное количество обращений к инструментам при формировании одного ответа.

Во время вызова пользователь видит в чате соответствующий статус. Детальный ход выполнения (какой инструмент вызван и какой результат получен) отображается только при включенной отладке на вкладке Основное.

Связанные списки

Под формой в связанном списке Инструменты и методы отображаются инструменты, доступные через выбранные адаптеры. Так можно проверить, какой набор действий получит ассистент.

Навыки

---

Навык (скилл) – это готовый сценарий выполнения задачи, описанный в виде инструкции. Навык подсказывает ассистенту, как именно решать определенный тип задач и какими инструментами при этом пользоваться.

Например, навык code-reviewer может содержать инструкцию по проверке кода и перечень разрешенных для этого инструментов.

Навыки, добавленные в ассистент, доступны ему постоянно. При постановке пользователем задачи ассистент выбирает наиболее подходящий навык и приступает к ее выполнению следуя инструкции выбранного навыка.

Создание навыка

Чтобы создать новый навык и добавить его в ассистент, выполните следующие шаги:

1. Нажмите + рядом с полем Скиллы.
2. Заполните поля.
3. Нажмите Сохранить.

Поля формы Скиллы

Поле	Обязательно	Описание
Имя	Да	Уникальное имя навыка.
Описание	Нет	Краткое описание – по нему ассистент понимает, когда применять навык.
Разрешенные AI-методы инструменты	Нет	Методы, которые навык может использовать.
Разрешенные MCP-инструменты	Нет	MCP-инструменты, которые навык может использовать.
Скилл (MD)	Да	Подробное описание сценария в формате Markdown.