Partilhar via

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.

Existem dois tipos de competências:

  • Competências no espaço de trabalho: Disponíveis para todos no local de trabalho. Os administradores de espaços de trabalho podem criar competências de espaço de trabalho e conceder a outros acesso à pasta de competências para adicionar mais. Use competências de espaço de trabalho para fluxos de trabalho que sejam amplamente úteis em toda a sua equipa, como fluxos de trabalho de aprendizagem automática ou processos específicos de domínio.
  • Competências de utilizador: Disponíveis apenas para si. Use competências de utilizador para fluxos de trabalho pessoais que não sejam relevantes para outros membros do espaço de trabalho.

Observação

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

Criar uma competência

As competências estão num .assistant/skills/ diretório. Cada habilidade deve ter a sua própria pasta e um SKILL.md ficheiro dentro dessa pasta. A localização depende do tipo de habilidade:

  • Competências no espaço de trabalho: Workspace/.assistant/skills/
  • Competências do utilizador: /Users/{username}/.assistant/skills/

Para criar uma nova competência:

  1. Cria uma nova pasta de competências no caminho apropriado para o teu tipo de habilidade.

    Após a criação, pode aceder rapidamente à sua pasta de habilidades no painel do Código Génio. Clica no ícone de engrenagem. Definições, depois clica no ícone de seta. 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:

    Workspace/.assistant/skills/
└── ml-workflows/
    └── SKILL.md

/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, uma competência de fluxo de trabalho de aprendizagem automática no ambiente de trabalho e uma competência de fluxo de trabalho pessoal podem ter a seguinte estrutura:

    Workspace/.assistant/skills/
├── ml-workflows/
   ├── SKILL.md                # Workflow overview and best practices
   ├── training-patterns.md    # Standard ML training patterns
   └── scripts/
         └── model-deploy.py   # Model deployment automation

/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

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:

  • Escolha o tipo de competência apropriado. Use competências de espaço de trabalho para fluxos de trabalho que beneficiem muitos utilizadores, como pipelines partilhados de aprendizagem automática ou processos específicos de domínio. Use competências de utilizador para fluxos de trabalho pessoais que não sejam relevantes para os outros.
  • 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

  • Last updated on