Personalizando o Assistente Databricks com Instruções

Se você já disse algo como "use snake_case", "prefira Plotly", ou "puxe vendas de catalog.schema.gold_sales" para o Assistente Databricks você provavelmente já disse isso mais de uma vez. Repetir a mesma coisa em cada sessão rapidamente se torna monótono.

É aqui que entram as Instruções do Assistente Databricks. Em vez de lembrar o Assistente toda vez, você define suas preferências uma vez e elas são aplicadas em todas as conversas. É como se você entregasse ao Assistente seu guia de estilo e notas de domínio antecipadamente, para que ele funcione exatamente como você espera.

O que são Instruções?

As instruções são trechos curtos e reutilizáveis que o Assistente considera automaticamente ao responder. Elas ajudam você com:

• Convenções de código: como nomenclatura, formatação e padrões de código. Muitos clientes têm convenções de código específicas que desejam seguir. Fornecer essas convenções como instruções ajuda o Assistente a gerar um código que atenda aos seus padrões.
• Bibliotecas/frameworks preferidos: Ajudam o Assistente a escolher as ferramentas que você prefere, então você não precisa especificar a biblioteca em novas solicitações. Administradores de workspace podem usar isso para recomendar bibliotecas internas ou módulos que devem ser usados para tarefas específicas. Por exemplo, “Use Plotly para gráficos”.
• Fontes de dados canônicos: O Assistente ajudará você a relembrar onde encontrar dados específicos, como “Sempre use catalog.schema.gold_sales para dados de vendas.” Administradores de workspace também podem adicionar recursos úteis para o processo de integração de novos usuários.
• Contexto do domínio: como acrônimos da indústria e terminologia interna. Ensine ao Assistente sobre seu domínio para que ele possa entender suas perguntas com explicações mínimas.

Instruções em Ação

Suas instruções ficam ao lado de suas instruções para que o Assistente possa seguir suas orientações sem que você precise repeti-las. Vamos olhar alguns exemplos.

Se você quer usar o Plotly ao gerar visualizações, basta digitar o seguinte no chat do Assistente:

/addInstruction use plotly para visualização

O Assistente então lembrará desta instrução e irá incluí-la automaticamente em cada chat. Usando o comando /addInstruction, você também pode dizer ao Assistente coisas como:

/addInstruction Mantenha as cores do gráfico em [sua paleta de marca]
/addInstruction Use catalog.schema.gold_sales para dados de vendas
/addInstruction Siga o snake_casing para nomes de variáveis
/addInstruction Reconheça e use seus acrônimos do domínio
/addInstruction Arredonde todos os valores monetários para duas casas decimais

Com as Instruções, o Assistente aprende uma vez e aplica suas orientações em todos os lugares, reduzindo retrabalho e ajudando você a obter resultados mais rápidos.

Escopo das Instruções

Algumas instruções podem se aplicar a todos os usuários em seu espaço de trabalho, enquanto outras são mais relevantes para você. Para suportar isso, o Assistente tem dois tipos de instruções:

1. Instruções do usuário: Salve suas preferências em `/Users/[email protected]/.assistant_instructions.md`. Isso é ótimo para seu estilo de codificação pessoal, ferramentas ou atalhos.
2. Instruções do Espaço de Trabalho: Os administradores podem definir instruções compartilhadas em `/Workspace/.assistant_workspace_instructions.md`. Perfeito para convenções em toda a organização, recursos de integração, contexto de domínio, fontes de dados compartilhadas ou melhores práticas.

Apenas os primeiros 4.000 caracteres de cada arquivo são incluídos nas conversas do Assistente. Isso garante que as respostas permaneçam de alta qualidade e focadas.

Como Adicionar Instruções

É realmente fácil adicionar instruções, de forma que você pode fazê-lo sem perder o contexto atual. Existem dois caminhos leves:

1. Dizer ao Assistente no chat. Digite `/addInstruction` adicione sua nova instrução na mensagem e o Assistente irá salvá-la instantaneamente.
2. Edite o arquivo markdown das instruções: No Assistente, clique no ícone de Configurações (engrenagem), crie um arquivo de instruções e edite-o diretamente. Isso é útil para revisar suas instruções existentes para garantir que elas ainda estão relevantes.

O Assistente Databricks captura automaticamente as instruções na próxima vez que você interage com ele. Suas instruções guiam as respostas do Assistente, embora elas possam não ser aplicadas perfeitamente em todos os casos.

Dicas para escrever instruções eficazes

Queríamos compartilhar algumas dicas que podem ajudá-lo a aproveitar ao máximo as instruções do Assistente:

• Se você se vê corrigindo repetidamente o Assistente sobre algo, adicione essa correção às suas instruções.
• Escreva instruções específicas e concisas.
• Cuide do seu arquivo de instruções para ficar abaixo do limite de 4.000 caracteres.
• Use cabeçalhos e formatação de markdown para mantê-lo organizado e fácil de ler.

Trate suas instruções como um guia de conhecimento e de estilo. Pequenas edições ao longo do tempo podem economizar horas à medida que o Assistente se torna cada vez mais útil para o seu trabalho.

Experimente as Instruções do Assistente Hoje

Para começar, experimente com uma instrução que você sempre repete, como sua biblioteca de gráficos ou estilo de variável preferido. A partir daí, o Assistente Databricks começará a partir dos seus padrões, não do zero.

Por favor, leia nossa documentação do produto para aprender mais sobre as Instruções do Assistente Databricks. Estamos animados para ver como ele otimiza seus fluxos de trabalho assistidos por IA.

(This blog post has been translated using AI-powered tools) Original Post