Перейти к основному содержимому

Инструменты

Инструменты позволяют ИИ получать актуальные данные из других систем: цены, остатки, адреса магазинов или статус заказа. Раздел доступен администратору.

Настройка инструмента требует готового адреса API и описания его параметров. Если этих данных у вас нет, запросите их у технического специалиста.

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

ИИ видит имя, описание и список параметров всех активных инструментов. Отдельно привязывать инструмент к вопросу или коллекции базы знаний не нужно.

Самое важное поле — description. Напишите простыми словами, какую информацию возвращает инструмент и в каких случаях его использовать.

Хороший пример:

Возвращает актуальные остатки товара в выбранном магазине. Используй, когда клиент спрашивает о наличии конкретного товара.

Плохой пример: Получение данных.

Поля настройки​

  • name — уникальное техническое имя латиницей, например get_shop_balance.
  • description — понятное ИИ назначение инструмента.
  • parameters — параметры запроса в формате JSON Schema.
  • method — способ запроса: GET или POST.
  • urlTemplate — адрес запроса. Значения параметров вставляются вместо конструкций вида {{productId}}.
  • bodyTemplate — тело запроса для метода POST.
  • headers — дополнительные заголовки, если их требует внешняя система.
  • isActive — доступен ли инструмент ИИ.

Пример схемы одного обязательного параметра:

{
  "type": "object",
  "properties": {
    "productId": {
      "type": "string",
      "description": "Код товара"
    }
  },
  "required": ["productId"]
}

Пример адреса:

http://normalizer-1c:3000/products/{{productId}}

После настройки​

  1. Сохраните инструмент активным.
  2. Задайте вопрос, для которого он предназначен.
  3. Проверьте правильность полученных данных.
  4. Задайте похожий вопрос, где инструмент использовать не нужно, и убедитесь, что ИИ не вызывает его без причины.

Если инструмент не вызывается, сначала уточните description. Если появляется техническая ошибка, передайте специалисту имя инструмента и время проверки.

:::warning Безопасность Не меняйте адреса, схемы и заголовки без понимания API. Сервер также должен разрешать адрес внешней системы; это настраивает технический специалист. :::