> ## 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

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>Бета</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                Возможность в статусе бета. 
                <u>
                    <a href="/docs/docs/beta-and-experimental-features#beta-features">
                        Подробнее.
                    </a>
                </u>
            </span>
        </div>;
};

<BetaBadge />

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

<div id="create-a-prompt">
  ## Создание промпта
</div>

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

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

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

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/prompts/create-prompt.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=b2718ba048bd45cba4a6d21ec58a9cb9" alt="Панель промптов с выделенной слева кнопкой + и открытой справа формой Create Prompt, где показаны поля Prompt Name, Text, Category, Special variables, Description и Command, а также кнопка Create Prompt" size="lg" width="3836" height="1176" data-path="images/cloud/agent-builder/prompts/create-prompt.webp" />

<div id="use-a-prompt">
  ## Использование промпта
</div>

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

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/prompts/preview.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=52a9b1cb081eceabe6ab0dd49f8ac645" alt="Панель промптов с выбранным промптом, его подробностями справа и контекстным меню с пунктами «Предпросмотр» и «Изменить»" size="lg" width="3836" height="1310" data-path="images/cloud/agent-builder/prompts/preview.webp" />

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

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/prompts/use-prompt-modal.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=6da9ccdb6cc2eaa55afd4d475d7d912c" alt="Модальное окно предпросмотра промпта с заголовком, автором, датой, текстом и кнопкой «Использовать промпт»" size="md" width="2052" height="516" data-path="images/cloud/agent-builder/prompts/use-prompt-modal.webp" />

<div id="share-prompts">
  ## Общий доступ к промптам
</div>

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

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

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

<div id="prompts-vs-skills-vs-instructions">
  ## Промпты, навыки и инструкции: в чем разница
</div>

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

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

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