> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Промпты

> Библиотека сохранённых промптов для ClickHouse Agents

[Возможность в статусе бета](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#beta-features)

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

## Создание промпта

Откройте панель **промптов** с помощью значка **промптов** в левой панели навигации и нажмите кнопку **+**, чтобы открыть форму **Create Prompt**. Заполните поля:

* **Prompt Name** (обязательно) - название, которое будет отображаться в списке выбора. Используйте понятные названия: *"Weekly active users by region"* лучше, чем *"WAU"*.
* **Text** (обязательно) - текст, который будет вставлен в поле ввода.
* **Special variables** - нажмите кнопку **Special variables**, чтобы вставить плейсхолдеры, или введите маркеры в формате `{{name}}` вручную. Перед вставкой список выбора предложит указать значения.
* **Category**, **Description**, **Command** (необязательно) - для организации библиотеки, текста предпросмотра в списке выбора и ярлыка для быстрого вызова.

Затем нажмите **Create Prompt** в правом нижнем углу.

![Панель промптов с выделенной слева кнопкой + и открытой справа формой Create Prompt, где показаны поля Prompt Name, Text, Category, Special variables, Description и Command, а также кнопка Create Prompt](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/prompts/create-prompt.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=82d6e479859d7f9d41973b2b646b8279)

## Использование промпта

На панели промптов откройте меню **...** на карточке промпта и выберите **Предпросмотр**:

![Панель промптов с выбранным промптом, его подробностями справа и контекстным меню с пунктами «Предпросмотр» и «Изменить»](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/prompts/preview.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=cc7095247943eee3072843e60cf95305)

В окне предпросмотра отображаются текст промпта, его автор и дата. Нажмите **Использовать промпт**, чтобы вставить содержимое в поле ввода. Если в промпте есть переменные, сначала заполните их.

![Модальное окно предпросмотра промпта с заголовком, автором, датой, текстом и кнопкой «Использовать промпт»](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/prompts/use-prompt-modal.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=d1970da2b819b82afcbffabb329e9ea2)

## Общий доступ к промптам

По умолчанию промпт доступен только тому, кто его создал. Владелец может изменить видимость промпта на:

* **Конкретные пользователи или группы** — любой, кого вы укажете, сможет найти и использовать промпт.
* **Вся организация** — любой пользователь в вашей организации ClickHouse Cloud сможет найти и использовать промпт.

Для промптов используется та же модель прав доступа, что и для агентов. Полную матрицу ролей и сведения о том, что может делать каждая из них, см. в разделе [Общий доступ и права доступа](https://clickhouse.com/docs/ru/agents/sharing-and-access.md).

## Промпты, навыки и инструкции: в чем разница

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

* **Промпты** - текст, который вы сами вставляете в поле ввода и редактируете для каждого запроса.
* **[Навыки](https://clickhouse.com/docs/ru/agents/builder/skills.md)** - наборы инструкций, которые агент загружает сам, когда считает их релевантными для задачи.
* **Инструкции агента** - постоянный системный промпт агента, который применяется к каждому диалогу.

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