Aperfeiçoar o Assistente com habilidades de agente

Crie habilidades para estender o Assistente do Databricks no modo de agente com funcionalidades especializadas para suas tarefas específicas do domínio. Esta página explica como criar e otimizar habilidades.

O que são habilidades?

Crie habilidades para estender o Assistente com funcionalidades especializadas. As habilidades seguem o padrão aberto de Habilidades do Agente. Fluxos de trabalho e conhecimentos específicos do domínio são parte do pacote de habilidades que o Assistente pode carregar quando relevante para executar tarefas específicas. As habilidades podem incluir diretrizes, práticas recomendadas, código reutilizável e scripts executáveis.

As habilidades devem ser adaptadas para tarefas específicas do domínio. Com as habilidades, você pode fornecer um contexto maior (como scripts, exemplos e outros recursos) para uma tarefa do que você pode com instruções. Ao contrário das instruções personalizadas, que são aplicadas globalmente, as habilidades são carregadas automaticamente e somente no contexto relevante. No modo de agente, o Assistente carrega automaticamente as habilidades quando relevante, com base em sua solicitação e na descrição da habilidade. Isso mantém uma janela de contexto eficiente e reduz a necessidade de fornecer o mesmo contexto em vários chats.

Observação

As habilidades são suportadas apenas no modo de agente do Assistente do Databricks.

Criar uma habilidade

As habilidades residem no /Users/{username}/.assistant/skills/ diretório. Cada habilidade deve ter sua própria pasta e um SKILL.md arquivo dentro dessa pasta.

Para criar uma nova habilidade:

1. Na pasta do workspace do usuário, crie uma nova pasta de habilidades. O caminho da pasta deve ser: /Users/{username}/.assistant/skills/.

   Após a criação, você pode acessar rapidamente essa pasta no painel Assistente. Clique no Configurações e clique Abra a pasta de habilidades.

2. Crie uma pasta dedicada para sua habilidade dentro da pasta de habilidades. Cada habilidade deve ter sua própria pasta. Por exemplo, se você estiver criando uma habilidade para fluxos de trabalho pessoais, sua estrutura de pastas poderá ser:

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

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

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

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

5. Adicione as instruções de habilidades no formato Markdown após o frontmatter. É recomendável incluir as seguintes seções:

   • Instruções passo a passo: Orientações processuais claras
   • Exemplos: exemplos de entradas 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 que contêm código executável que o agente pode executar.
   • Arquivos que contêm documentação adicional para referência, como práticas recomendadas e modelos.

   Ao referenciar outros arquivos, use caminhos relativos da habilidade raiz.

   Por exemplo, você pode ter uma habilidade de fluxo de trabalho pessoal que faz referência às práticas recomendadas de ETL, modelos de painel e scripts para instalação e implantação de pipeline. A pasta da sua habilidade pode incluir os seguintes arquivos:

   /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 Assistente do Databricks reconhece automaticamente suas habilidades na próxima vez que você o utilizar no modo de agente.

Práticas recomendadas

Siga estas diretrizes para escrever habilidades eficazes:

• Mantenha o foco nas habilidades. As habilidades funcionam melhor quando se concentram em uma única tarefa ou fluxo de trabalho. O escopo estreito torna mais fácil para o Assistente reconhecer quando uma habilidade se aplica.
• Use nomes e descrições claros. Um nome conciso e descritivo e um resumo ajudam o Assistente a corresponder a habilidade certa à solicitação certa.
• Seja explícito e orientado a exemplos. Descreva os fluxos de trabalho passo a passo e inclua exemplos ou padrões concretos que o Assistente pode reutilizar.
• Evite contexto desnecessário. Inclua apenas as informações necessárias para a tarefa. Detalhes extras podem tornar as habilidades mais difíceis de aplicar de forma confiável.
• Iterar ao longo do tempo. Trate as habilidades como fluxos de trabalho vivos. Pequenas atualizações com base no uso real podem melhorar significativamente os resultados.
• Separe as diretrizes 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 torna as habilidades mais fáceis de manter e reutilizar.