> For the complete documentation index, see [llms.txt](https://docs.suvvy.ai/ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.suvvy.ai/ru/deistviya/chtenie-url-ssylok.md).

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

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

Шаг возвращает текст страницы. Метод запроса, заголовки, тело и статус-коды здесь не настраиваются: если вам нужен HTTP-запрос к API со своей авторизацией и телом запроса, используйте шаг [Вебхук](https://docs.suvvy.ai/ru/deistviya/veb-khuki.md).

{% hint style="warning" %}
Текст страницы попадает в контекст диалога, поэтому её объём напрямую влияет на стоимость ответа.

Читайте адресные страницы — карточку товара, страницу услуги, конкретную статью, — а не разделы каталога и не главную страницу сайта. Если текст нужен не для ответа клиенту, а для передачи дальше (в следующий шаг или в CRM), сохраните его в переменную и не возвращайте агенту — см. Сохранение текста в переменную.
{% endhint %}

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

{% stepper %}
{% step %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FDh4ZU27m7FJO1Ukka6pC%2Fimage.png?alt=media&amp;token=240ea5ec-84ba-4c01-81ce-1dda133cc405" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FpRjXZgXUqB9aOwvClnQa%2Fimage.png?alt=media&amp;token=b839e85a-6429-40ec-9215-2a132b898abf" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

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

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

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FKBSvq9ynbWNOrAO3Nmu9%2Fimage.png?alt=media&amp;token=80b09783-487f-4bb9-9b50-f3930f95bf54" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Имя переменной пишется строчными латинскими буквами, через нижнее подчёркивание, без цифр и пробелов, не длиннее 24 символов: `link`, `product_url`. Имена вида `Link`, `link2` или `ссылка` сохранить не получится.
{% endhint %}
{% endstep %}

{% step %}

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FcIk3r1y2MdLIb5uiLYv2%2Fimage.png?alt=media&amp;token=50e1dae8-0b38-484e-bfb5-38c9a84ba38a" alt=""><figcaption><p><code>https://example.com/catalog/</code> + переменная <code>product_slug</code></p></figcaption></figure>

{% tabs %}
{% tab title="Ссылку присылает клиент" %}
В поле **URL** оставляем только переменную `link`.

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

{% tab title="Читаем свой сайт" %}
В поле **URL** пишем начало адреса текстом, а переменную подставляем в конец:

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

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

{% hint style="info" %}
Цвет подставленной переменной в поле случайный и ни на что не влияет.
{% endhint %}
{% endstep %}

{% step %}

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FgDb9LVH5gleEbg7HeINY%2Fimage.png?alt=media&amp;token=0641a3d7-9012-4962-bcc1-2979db1591a0" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FQtsoHfsvpQtl3n7lSYvz%2Fimage.png?alt=media&amp;token=f27ec3e3-ef63-4808-b381-37175e4b97f8" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FtZlKcfI2IWRaQ3yyQDxp%2Fimage.png?alt=media&amp;token=0c04bd41-88b3-4a70-ae24-a1a22605d903" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FYihoEWdgMb7dySlZQvst%2Fimage.png?alt=media&amp;token=67e2ede9-c365-4990-9fd4-bdaba735d692" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

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

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

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

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

{% content-ref url="/pages/Q8TRNdBr9HxbBPclEDH2" %}
[Функции](https://docs.suvvy.ai/ru/osnovnye-nastroiki/prompts/prompts-2.md)
{% endcontent-ref %}

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

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

| **Правила ответа агенту**                                     | Что вернётся агенту, если в действии несколько шагов: **Все**, **Только первый** или **Только последний**. По умолчанию — последний.                                                            |
| ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Прервать выполнение действия при успешном выполнении шага** | Если шаг отработал без ошибки, остальные шаги не выполняются, а действие считается успешным.                                                                                                    |
| **Пропускать шаг при ошибке**                                 | Если страницу открыть не удалось, действие продолжится со следующего шага. Если следующему шагу нужна переменная, которую должен был заполнить этот шаг, действие всё равно завершится ошибкой. |

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

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

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

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

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

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.suvvy.ai/ru/deistviya/chtenie-url-ssylok.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
