Prompts

Biblioteca de prompts salvos para o ClickHouse Agente

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.

​

Criar um prompt

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.

​

Use um prompt

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

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.

​

Compartilhar prompts

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.

​

Prompts vs. skills vs. instruções

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