Estende o Código Génio com competências de agente

Crie competências para estender o Código Genie no modo Agente com capacidades especializadas para tarefas específicas do seu domínio. Esta página explica como criar e otimizar competências.

O que são competências?

Crie competências para estender o Genie Code com capacidades especializadas. As competências seguem o padrão aberto das Competências de Agente. O pacote de habilidades agrega conhecimento especializado e fluxos de trabalho específicos do domínio que o Genie Code pode carregar quando necessário para realizar tarefas específicas. As competências podem incluir orientação, melhores práticas, código reutilizável e scripts executáveis.

As competências devem ser adaptadas a tarefas específicas de cada domínio. Com competências, podes fornecer mais contexto (como scripts, exemplos e outros recursos) para uma tarefa do que com instruções. Ao contrário das instruções personalizadas, que são aplicadas globalmente, as competências são carregadas automaticamente e apenas no contexto relevante. No modo Agente, o Código Génio carrega automaticamente as habilidades quando relevante, com base no teu pedido e na descrição da habilidade. Também podes invocar manualmente as habilidades ao @ mencioná-las. Isto mantém uma janela de contexto eficiente e reduz a necessidade de fornecer o mesmo contexto em várias conversas.

Observação

As habilidades só são suportadas no modo Agente do Código Génio.

Criar uma competência

As competências encontram-se no diretório /Users/{username}/.assistant/skills/. Cada habilidade deve ter a sua própria pasta e um SKILL.md ficheiro dentro dessa pasta.

Para criar uma nova competência:

1. Na pasta do teu espaço de trabalho de utilizador, cria uma nova pasta de competências. O caminho da pasta deve ser: /Users/{username}/.assistant/skills/.

   Após a criação, pode aceder rapidamente a esta pasta no painel do Código Genie. Definições, depois clica Abrir a pasta de competências.

2. Cria uma pasta dedicada para a tua competência dentro da pasta de competências. Cada habilidade deve ter a sua própria pasta. Por exemplo, se estiver a criar uma competência para fluxos de trabalho pessoais, a sua estrutura de pastas pode ser:

   /Users/{username}/.assistant/skills/
   └── personal-workflows/
       └── SKILL.md
   

3. Dentro da tua pasta de competências, cria um SKILL.md ficheiro. Este ficheiro é obrigatório e define a competência. As competências seguem as especificações das Competências do Agente.

4. Adicione o material inicial necessário para a sua competência:

   ---
   name: skill-name
   description: A description of what this skill does and when to use it.
   ---
   

5. Adiciona as instruções de skill em formato Markdown depois do frontmatter. Recomenda-se incluir as seguintes secções:

   • Instruções passo a passo: Orientação processual clara
   • Exemplos: Entradas de amostra e saídas esperadas
   • Casos extremos: Variações e exceções comuns

6. (Opcional) Para competências mais complexas, pode fornecer e consultar recursos adicionais:

   • Scripts contendo código executável que o agente pode executar.
   • Ficheiros que contêm documentação adicional para referência, como boas práticas e modelos.

   Ao referenciar outros ficheiros, use caminhos relativos da competência raiz.

   Por exemplo, pode ter uma competência pessoal de workflow que faça referência às melhores práticas de ETL, modelos de dashboards e scripts para configuração e implementação de pipelines. A pasta da tua competência pode incluir os seguintes ficheiros:

   /Users/{username}/.assistant/skills/
   ├── personal-workflows/
      ├── SKILL.md                # Workflow overview and best practices
      ├── etl-patterns.md         # Personal ETL best practices
      ├── dashboard-templates.md   # Reusable dashboard patterns
      └── scripts/
            ├── pipeline-setup.sh   # Environment setup scripts
            └── model-deploy.py     # Model deployment automation
   

O Código Génio aprende automaticamente as tuas habilidades da próxima vez que o usares no modo Agente. Também @ podes mencionar habilidades para garantir que o Código Génio as utiliza.

Melhores práticas

Siga estas orientações para escrever competências que sejam eficazes:

• Mantenha as habilidades focadas. As competências funcionam melhor quando se focam numa única tarefa ou fluxo de trabalho. O âmbito restrito facilita ao Código Génio reconhecer quando uma competência se aplica.
• Use nomes e descrições claras. Um nome conciso e descritivo e um resumo ajudam o Código Génio a ajustar a habilidade certa ao pedido certo.
• Seja explícito e baseado em exemplos. Descreva os fluxos de trabalho passo a passo e inclua exemplos concretos ou padrões que o Genie Code possa reutilizar.
• Evite contexto desnecessário. Inclua apenas a informação necessária para a tarefa. Detalhes extra podem tornar as competências mais difíceis de aplicar de forma fiável.
• Iterar ao longo do tempo. Trate as competências como fluxos de trabalho vivos. Pequenas atualizações baseadas no uso real podem melhorar significativamente os resultados.
• Separar orientação da automação. Use o markdown para explicar a intenção e as melhores práticas, e scripts para ações repetíveis. Manter estas preocupações distintas torna as competências mais fáceis de manter e reutilizar.

Consulte também

• Dicas para melhorar as respostas do Código Genie: Aprenda a referenciar manualmente as competências no prompt do chat.