Amplie o Assistente com habilidades de agente.

Crie habilidades para estender Databricks Assistant 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?

Criar habilidades para ampliar o Assistente com capacidades especializadas. As habilidades seguem o padrão aberto de Habilidades de Agente. Pacote de competências: conhecimento específico da área e fluxo de trabalho que o Assistente 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 Assistente carrega automaticamente as habilidades relevantes, com base na 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.

nota

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

Criar uma habilidade

Para criar uma nova habilidade:

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

   Após a criação, você poderá acessar rapidamente esta pasta no painel do Assistente. Clique Configurações e, em seguida, clique em Abra a pasta de habilidades .

2. Crie um arquivo SKILL.md para sua habilidade. As habilidades seguem as especificações das Habilidades do Agente.

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

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

4. 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

5. (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, você pode ter uma habilidade pessoal de fluxo de trabalho que faça referência às melhores práticas ETL , padrões de painel e scripts para configuração e implantação 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 Databricks Assistant detecta automaticamente suas habilidades na próxima vez que você o usar no modo agente.

Melhores práticas

Siga estas orientações para escrever habilidades eficazes:

• Mantenha o foco nas suas habilidades. As habilidades funcionam melhor quando se concentram em uma única tarefa ou fluxo de trabalho. Um escopo restrito facilita ao Assistente reconhecer quando uma habilidade se aplica.
• Use nomes e descrições claras. Um nome e um resumo concisos e descritivos ajudam o Assistente a encontrar a habilidade certa para a solicitação certa.
• Seja explícito e dê exemplos. Descreva o fluxo 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 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.