Виды ресурсов
| Ресурс | Назначение | Где выбирается |
|---|---|---|
| LLM-профиль | Провайдер, модель и параметры генерации. | В Agent-слоте. |
| Инструмент | Действие, доступное ИИ. | В разделе «Инструменты» Agent-слота. |
| База знаний | Документы для поиска ответов. | Как инструмент Agent-слота. |
| Внешний запрос | Заранее описанный HTTP-запрос. | В слоте внешнего запроса. |
LLM-профили
Профиль хранит выбор провайдера, модели, температуры и способ использования API-ключа. Несколько Agent-слотов могут использовать разные профили.
- Создайте профиль с понятным названием: «Быстрые ответы», «Основной GPT», «Анализ обращений».
- Один профиль можно сделать профилем по умолчанию.
- API-ключ не нужно вставлять в промпты или граф.
Инструменты
Инструмент дает ИИ дополнительное действие. Модель видит название и описание инструмента, а затем решает, когда он нужен.
| Инструмент | Пример задачи |
|---|---|
| Поиск в сети | Найти актуальную информацию или официальный источник. |
| Анализ изображения | Понять содержание отправленной фотографии. |
| Погода | Получить прогноз для указанного города. |
| Поиск по базе знаний | Найти ответ в документах компании. |
| Пользовательский инструмент | Запустить собственное действие или интеграцию. |
Базы знаний
База знаний содержит файлы компании: инструкции, FAQ, регламенты или каталоги. После загрузки дождитесь завершения индексации.
- Разделяйте разные темы на отдельные базы, если это упрощает выбор источника.
- Используйте актуальные документы без дублирующих старых версий.
- Проверяйте несколько реальных вопросов после обновления файлов.
Внешние запросы
Ресурс внешнего запроса описывает метод, URL, заголовки, тело запроса, таймаут и правила сохранения ответа в переменные. Заголовки и извлекаемые поля добавляются по одному через кнопку +.
GET https://api.example.com/orders/{{ order_id }}
Путь ответа Переменная
data.status order_status
data.total order_total
| Режим тела | Когда использовать |
|---|---|
| Без тела | Обычный GET или запрос, которому достаточно URL и заголовков. |
| JSON | API принимает JSON-объект. |
| form-data | API ожидает multipart/form-data, включая поля формы. |
| x-www-form-urlencoded | API принимает обычную URL-кодированную форму. |
| Raw | API ожидает произвольное тело запроса: текст, XML или заранее собранный payload. |
Параметры строки запроса указываются непосредственно в URL, например ?login={{ phone }}. Шаблоны работают в URL, заголовках и теле.
Перед использованием в графе запрос можно протестировать прямо из ресурса. iisy покажет подготовленный curl, итоговый URL, статус, время ответа, заголовки и тело ответа. Это удобно, чтобы проверить шаблоны и формат тела без запуска всего сценария.
После выполнения разобранное тело ответа сохраняется в last_external_response, HTTP-статус — в last_external_status, а техническая ошибка — в last_external_error. Нужные поля можно сразу извлечь по JSON-пути в отдельные переменные и затем проверить обычным условием.