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

# Prompts

> Biblioteca de prompts salvos para o 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>Beta</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                Funcionalidade Beta. 
                <u>
                    <a href="/docs/docs/beta-and-experimental-features#beta-features">
                        Saiba mais.
                    </a>
                </u>
            </span>
        </div>;
};

<BetaBadge />

A biblioteca de Prompts é onde você salva e reutiliza prompts em linguagem natural que digita com frequência. Pense nela como snippets para o composer do chat — úteis quando a mesma pergunta analítica ou instrução de formatação aparece em várias conversas.

<div id="create-a-prompt">
  ## Criar um prompt
</div>

Abra o painel Prompts pelo ícone **Prompts** na navegação à esquerda e clique no botão **+** para abrir o formulário **Criar prompt**. Preencha os campos:

* **Nome do prompt** (obrigatório) - o que aparece no seletor. Seja descritivo: *"Usuários ativos semanalmente por região"* é melhor do que *"WAU"*.
* **Texto** (obrigatório) - o texto em si que será inserido no composer.
* **Variáveis especiais** - clique no botão **Variáveis especiais** para inserir placeholders ou digite diretamente marcadores no formato `{{name}}`. O seletor solicita os valores antes de inserir.
* **Categoria**, **Descrição**, **Comando** (opcional) - para organizar a biblioteca, o texto de visualização no seletor e um atalho de execução rápida.

Em seguida, clique em **Criar prompt** no canto inferior direito.

<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="Painel Prompts com o botão + destacado à esquerda e o formulário Criar prompt aberto à direita, mostrando os campos Nome do prompt, Texto, Categoria, Variáveis especiais, Descrição e Comando, com um botão Criar prompt" size="lg" width="3836" height="1176" data-path="images/cloud/agent-builder/prompts/create-prompt.webp" />

<div id="use-a-prompt">
  ## Use um prompt
</div>

No painel Prompts, abra o menu **...** no card de um prompt e escolha **Preview**:

<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="Painel Prompts com um prompt selecionado, seus detalhes visíveis à direita e um menu de contexto mostrando as opções Preview e Edit" size="lg" width="3836" height="1310" data-path="images/cloud/agent-builder/prompts/preview.webp" />

A visualização mostra o texto do prompt, além do autor e da data. Clique em **Use Prompt** para inserir o conteúdo no composer. Se o prompt tiver variáveis, preencha-as primeiro.

<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="Modal de visualização do prompt mostrando o título, o autor, a data, o texto e o botão Use Prompt" size="md" width="2052" height="516" data-path="images/cloud/agent-builder/prompts/use-prompt-modal.webp" />

<div id="share-prompts">
  ## Compartilhar prompts
</div>

Por padrão, um prompt é privado e visível apenas para a pessoa que o criou. O proprietário pode alterar a visibilidade de um prompt para:

* **Usuários ou grupos específicos** - qualquer pessoa que você indicar pode encontrar e usar o prompt.
* **Toda a organização** - todos da sua organização do ClickHouse Cloud podem encontrá-lo e usá-lo.

Os prompts usam o mesmo modelo de permissões que os agentes. Para ver a matriz completa de funções e o que cada uma pode fazer, consulte [Compartilhamento e
acesso](/docs/pt-BR/products/cloud/features/ai-ml/agents/sharing-and-access).

<div id="prompts-vs-skills-vs-instructions">
  ## Prompts vs. skills vs. instruções
</div>

Prompts, skills e instruções do agente adicionam texto ao modelo, mas diferem em quem os aciona e no quanto persistem.

* **Prompts** - texto que você mesmo insere no composer, editado a cada interação.
* **[Skills](/docs/pt-BR/products/cloud/features/ai-ml/agents/builder/skills)** - conjuntos de instruções que o agente carrega por conta própria quando considera que são relevantes para a tarefa.
* **Instruções do agente** - o system prompt persistente do agente, aplicado a toda conversa.

Use um prompt quando quiser reutilizar uma formulação, mas manter o controle da redação a cada vez. Use uma skill quando quiser que o agente aplique
a mesma orientação de forma consistente em um tipo de tarefa sem que você precise digitá-la. Use instruções do agente quando esse comportamento precisar valer por toda a
vida útil do agente.