Pular para o conteúdo principal
Última atualização em

Amplie o Genie Code com habilidades de agente.

Crie habilidades para estender Genie Code no modo Agente com recursos especializados para sua tarefa específica de domínio. Esta página explica como criar e otimizar habilidades.

O que são habilidades?​

Crie habilidades para ampliar o Genie Code com funcionalidades especializadas. As habilidades seguem o padrão aberto de Habilidades de Agente. O pacote de habilidades inclui conhecimento específico da área e fluxo de trabalho que Genie Code pode carregar quando relevante para executar tarefas específicas. As habilidades podem incluir orientação, melhores práticas, código reutilizável e scripts executáveis.

As habilidades devem ser adaptadas para tarefas específicas da área. Com habilidades, você pode fornecer um contexto mais amplo (como roteiros, 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 habilidades são carregadas automaticamente e apenas no contexto relevante. No modo Agente, o Genie Code carrega automaticamente as habilidades quando relevantes, com base na sua solicitação e na descrição da habilidade. Você também pode invocar habilidades manualmente mencionando-as @ . Isso mantém uma janela de contexto eficiente e reduz a necessidade de fornecer o mesmo contexto em vários chats.

Existem dois tipos de habilidades:

  • Habilidades no ambiente de trabalho : Disponíveis para todos no workspace. Os administradores do espaço de trabalho podem criar habilidades workspace e conceder acesso à pasta de habilidades a outros usuários para que adicionem mais habilidades. Utilize habilidades workspace para fluxo de trabalho que sejam amplamente úteis em toda a sua equipe, como fluxo de trabalho de machine learning ou processos específicos do domínio.
  • Habilidades do usuário : Disponíveis somente para você. Utilize habilidades de usuário para fluxo de trabalho pessoal que não sejam relevantes para outros membros workspace .
nota

As habilidades são suportadas apenas no modo Agente do Genie Code.

Criar uma habilidade​

As habilidades ficam em um diretório .assistant/skills/ . Cada habilidade deve ter sua própria pasta e um arquivo SKILL.md dentro dessa pasta. A localização depende do tipo de habilidade:

  • Habilidades no ambiente de trabalho : Workspace/.assistant/skills/
  • Habilidades do usuário : /Users/{username}/.assistant/skills/

Para criar uma nova habilidade:

  1. Crie uma nova pasta de habilidades no caminho apropriado para o seu tipo de habilidade.

    Após a criação, você pode acessar rapidamente sua pasta de habilidades no painel do Genie Code. Clique Ícone de engrenagem. Configurações e, em seguida, clique em Seta no ícone. Abra a pasta de habilidades .

  2. Crie uma pasta específica para sua habilidade dentro da pasta de habilidades. Cada habilidade deve ter sua própria pasta. Por exemplo:

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

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

  3. Dentro da sua pasta de habilidades, crie um arquivo SKILL.md . Este arquivo é obrigatório e define a habilidade. As habilidades seguem as especificações das Habilidades do Agente.

  4. Adicione o frontmatter necessário para sua skill:

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

  5. Adicione as instruções da habilidade em formato Markdown após o frontmatter. Recomenda-se incluir as seguintes seções:

    • Instruções passo a passo: Orientações claras sobre o procedimento
    • Exemplos: Entradas de amostra e saídas esperadas
    • Casos extremos: variações e exceções comuns

  6. (Opcional) Para habilidades mais complexas, você pode fornecer e referenciar recursos adicionais:

    • Scripts contendo código executável que o agente pode executar.
    • Arquivos contendo documentação adicional para consulta, como melhores práticas e padrões.

    Ao referenciar outros arquivos, utilize caminhos relativos a partir da skill raiz.

    Por exemplo, uma habilidade de fluxo de trabalho machine learning workspace e uma habilidade 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 Genie Code detecta automaticamente suas habilidades na próxima vez que você o usar no modo Agente. Você também pode @ mencionar habilidades para garantir que o Genie Code as utilize.

Melhores práticas​

Siga estas orientações para escrever habilidades eficazes:

  • Escolha o tipo de habilidade apropriado. Utilize habilidades workspace para fluxo de trabalho que beneficiem muitos usuários, como um pipeline machine learning compartilhado ou processos específicos do domínio. Utilizar habilidades de usuário para fluxo de trabalho pessoal que não sejam relevantes para os outros.
  • Mantenha o foco nas suas habilidades. As habilidades funcionam melhor quando se concentram em uma única tarefa ou fluxo de trabalho. O escopo restrito facilita ao Genie Code reconhecer quando uma habilidade se aplica.
  • Use nomes e descrições claras. Um nome conciso e descritivo, juntamente com um resumo, ajuda o Genie Code a associar a habilidade certa à solicitação certa.
  • Seja explícito e dê exemplos. Descreva o fluxo de trabalho passo a passo e inclua exemplos concretos ou padrões que Genie Code pode reutilizar.
  • Evite contexto desnecessário. Inclua apenas as informações necessárias para a tarefa. Detalhes excessivos podem dificultar a aplicação confiável de habilidades.
  • Iterar ao longo do tempo. Trate as habilidades como um fluxo de trabalho vivo. Pequenas atualizações baseadas no uso real podem melhorar significativamente os resultados.
  • Separe a orientação da automação. Use Markdown para explicar a intenção e as melhores práticas, e scripts para ações repetíveis. Manter essas preocupações distintas facilita a manutenção e a reutilização das habilidades.

Veja também​

On this page