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

O Genie Code traz competências integradas para fluxos de trabalho comuns do Azure Databricks: escrever código em cadernos, explorar dados no Unity Catalog, construir dashboards, criar pipelines e trabalhar com MLflow. Crie competências personalizadas para estender o modo Genie Code Agent com capacidades especializadas para as tarefas específicas da sua equipa. Esta página explica como criá-los e otimizá-los.

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 impor padrões a nível organizacional, entregar resultados consistentes entre utilizadores (por exemplo, uma competência de gestão de PII que oculte colunas sensíveis) ou servir equipas diferentes (por exemplo, modelos de pipeline para engenheiros de dados e playbooks de treino de modelos para utilizadores de plataformas de ML).
  • Competências de utilizador: Disponíveis apenas para si. Utilize as competências do utilizador para definir preferências pessoais, como bibliotecas preferidas, estilo de programação ou contexto da função e da experiência. As competências do utilizador também são úteis para prototipar uma competência antes de a promover ao nível 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.

Quando editas uma skill existente, começa uma nova conversa para aplicar as tuas alterações. As edições não têm efeito em tópicos ativos. Se uma competência ainda parecer obsoleta, como mostrar comportamento antigo ou uma descrição desatualizada, atualize o separador do navegador para limpar os metadados em cache da competência.

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 codificar padrões partilhados (como gestão de PIIs, convenções de nomeação ou modelos específicos de equipa) para que cada utilizador obtenha resultados consistentes. Use as competências do utilizador para preferências pessoais e para prototipar uma competência antes de a promover no local de trabalho.
  • 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.
  • Competências de autor com o Código Génio. Usa o Código Génio para desenhar e aperfeiçoar competências. Testa competências novas ou atualizadas em tarefas representativas para identificar onde o agente tem dificuldades, depois atualiza as instruções para colmatar essas lacunas.
  • 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.
  • Controla as tuas competências com controlo de versões. Guarda a tua pasta de competências com pastas Git do Databricks para acompanhar alterações, colaborar com colegas e reverter alterações quando necessário.

Consulte também

  • Last updated on