For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Перейти к содержимому

Чтение URL-ссылок

Чтение ссылок — тип шага в действии, который открывает веб-страницу по ссылке и отдаёт агенту её текст. Ссылку можно задать фиксированно или собрать из переменных — например, взять ту, которую клиент

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

Создание действия

1

Перейдите во вкладку "Действия" и нажмите кнопку "Добавить"

2

Выберите тип шага "Чтение ссылок"

Шаг находится рядом с разделом API-вызовы, в котором лежит Вебхук.

3

Заполните форму действия

Название действия — название для отображения в общем списке действий.

Название шага — название самого шага чтения ссылки.

Переменные действий — то, что агент должен собрать перед вызовом. Для чтения ссылок нужна одна переменная под адрес страницы — назовите её link.

Константы действия — постоянные значения, доступные во всех шагах. Для чтения ссылок нужны, если вы читаете страницы одного и того же сайта: вынесите домен в константу, а от агента принимайте только адрес страницы.

4

Укажите URL в настройках шага

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

Два типовых варианта:

https://example.com/catalog/ + переменная product_slug

В поле URL оставляем только переменную link.

Подходит, когда клиент присылает ссылку на товар или объявление и просит по ней что-то уточнить.

В поле URL пишем начало адреса текстом, а переменную подставляем в конец:

https://example.com/catalog/ + переменная product_slug

Так агент не сможет уйти на посторонний сайт: домен задан вами, от агента приходит только часть адреса.

Цвет подставленной переменной в поле случайный и ни на что не влияет.

5

При необходимости сохраните текст в переменную

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

Это основной способ читать длинные страницы без роста стоимости ответа: агент получает не всю страницу, а только то, что вы передадите дальше — например, в вебхук или в поле сделки в CRM.

6

Настройте раздел "Условия срабатывания" и "Доп. настройки"

Название функции — по нему агент понимает, что вызывать. Пишется на английском без пробелов. Заполнив Название действия, можно нажать кнопку 🔃 справа от поля — название сгенерируется автоматически.

Описание функции — когда именно вызывать действие. Например: Used to read the content of a web page by its link when the customer sends a link.

Сообщение об ошибке, передаваемое агенту — что получит агент, если страницу открыть не удалось. Задайте осмысленный текст, например Не удалось открыть страницу: увидев его, агент попросит клиента прислать другую ссылку, а не будет придумывать содержимое страницы.

7

Сохраните шаг

После сохранения шага само действие сохраняется автоматически.

Вызов в инструкции

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

Если клиент прислал ссылку на товар — вызови функцию read_page_content
и передай туда ссылку из сообщения клиента. Отвечай только по тексту,
который вернула функция. Если функция вернула ошибку — попроси клиента
прислать ссылку ещё раз.

Подробнее о том, как агент выбирает функции:

Функции

Дополнительные настройки шага

Настройки ниже нужны, когда в действии несколько шагов — например, прочитать страницу, а затем передать текст в CRM.

Правила ответа агенту

Что вернётся агенту, если в действии несколько шагов: Все, Только первый или Только последний. По умолчанию — последний.

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

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

Пропускать шаг при ошибке

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

Остальные настройки раздела — задержка перед вызовом, остановка диалога, присвоение тега, уведомление об ошибке — работают так же, как в вебхуках, и описаны в разделе Веб-хуки.

Ограничения и типичные ошибки

Агент отвечает не тем, что написано на странице. Проверьте, что в инструкции есть запрет отвечать по собственным знаниям: без него агент дополняет текст страницы тем, что «знает» о товаре сам. Помогает и Контроль фактов.

Стоимость диалога заметно выросла. В контекст уходит текст страницы целиком. Читайте конкретные страницы вместо разделов каталога, а длинный текст сохраняйте в переменную вместо возврата агенту.

Агент уходит на посторонние сайты. Вынесите домен в константу или в фиксированную часть URL, а от агента принимайте только остаток адреса.

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

Последнее обновление

Это было полезно?