Skills

Pacotes reutilizáveis de instruções para ClickHouse Agents

Uma skill é um pacote reutilizável de instruções que um agente pode aplicar sob demanda. Use skills para procedimentos recorrentes em vários agentes — um guia de estilo da marca, um checklist de revisão de código, um runbook para um fluxo de trabalho específico — em vez de duplicar as instruções no prompt de sistema de cada agente.

​

Anatomia de uma skill

Uma skill é um arquivo Markdown com um pequeno cabeçalho de frontmatter:

---
name: revenue-report
description: Generates the weekly revenue report using our standard segments
always-apply: false
user-invocable: true
---

When asked to generate a revenue report:
1. Filter to the requested period.
2. Apply the standard MRR formula:
     SUM(CASE
       WHEN billing_cycle = 'monthly' THEN amount
       WHEN billing_cycle = 'yearly'  THEN amount / 12
       ELSE 0
     END)
3. Break down by segment: Enterprise, Mid-Market, SMB.
4. Render the result as a Markdown table.

Os parâmetros de frontmatter mais importantes:

• name - identificador em kebab-case.
• description - breve resumo usado pelo modelo para decidir quando esta skill é relevante. Trate este como o campo mais importante. Seja específico; descrições vagas levam à invocação da skill errada.
• always-apply - quando true, a skill é incluída em todos os turnos em vez de ser selecionada. Use com moderação; skills com always-apply consomem contexto em todas as mensagens.
• user-invocable - quando true (o padrão), a skill aparece no pop-up $ para seleção manual.

Você pode agrupar arquivos de suporte junto com a skill — documentação de referência, consultas de exemplo, pequenos scripts — enviando um .zip que contenha o SKILL.md e seus recursos.

​

Use uma skill

Três maneiras de um agente recorrer a uma skill em uma conversa:

• Invocação pelo usuário - pressione $ no composer e escolha a skill no popover. O conteúdo da skill é pré-carregado para o próximo turno.
• Seleção automática pelo modelo - com base na description da skill, o agente decide por conta própria quando aplicá-la.
• Always-apply - pré-carregado em todos os turnos para skills configuradas dessa forma.

​

Gerenciar skills

O painel Skills no console do Cloud permite criar skills diretamente nele, fazer upload de arquivos .md ou .zip e gerenciar quais skills ficam ativas para a sua conta. As skills de sua propriedade ficam ativas por padrão; desative uma para removê-la do popover e do catálogo do modelo sem excluí-la.

As skills podem ser compartilhadas com outros usuários (consulte compartilhamento e acesso).

​

Skills vs. instruções

• Instruções do agente definem o que o agente é e como ele se comporta de modo geral. Ficam sempre ativas para esse agente.
• Skills são situacionais — aplicadas quando relevante e restritas a fluxos de trabalho específicos.

Use uma skill quando o mesmo conjunto de instruções passo a passo continuar aparecendo em vários agentes ou quando você quiser que ela seja acionada apenas para solicitações específicas do usuário, em vez de em todas as interações.