Estenda o Assistente com competências de agente

Crie competências para estender o Databricks Assistant em 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 expandir o Assistente com capacidades especializadas. As competências seguem o padrão aberto das Competências de Agente. As competências organizam conhecimentos e processos específicos do domínio que o Assistente pode carregar sempre que 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 Assistente carrega automaticamente as habilidades quando relevante, com base no seu pedido e na descrição da habilidade. Isto mantém uma janela de contexto eficiente e reduz a necessidade de fornecer o mesmo contexto em várias conversas.

Observação

As competências só são suportadas no modo agente do Databricks Assistant.

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 Assistente. 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 Databricks Assistant aprende automaticamente as tuas competências da próxima vez que o usares em modo agente.

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 Assistente reconhecer quando uma competência se aplica.
• Use nomes e descrições claras. Um nome conciso e descritivo e um resumo ajudam o Assistente a ajustar a competência 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 Assistente 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.