Personalize e aprimore as respostas do Databricks Assistant

Esta página fornece dicas e práticas recomendadas para auxiliar o Databricks Assistant a fornecer respostas mais adequadas.

Personalize as respostas do Assistente adicionando instruções

É possível personalizar a forma como o Databricks Assistant responde adicionando instruções personalizadas. O assistente considera essas instruções ao gerar novas respostas.

Por exemplo, as instruções podem incluir:

• Informações sobre suas preferências, como qual biblioteca você prefere utilizar ao escrever código.
• Contexto sobre quem você é, como seu nome e função.
• Convenções de codificação a serem seguidas.
• Diretrizes a serem seguidas.
• Instruções sobre como o Assistente deve responder, como usar um tom casual.

Com exceção do Quick Fix e do Autocomplete, o Databricks Assistant aplica instruções a todas as respostas que gera, incluindo o Inline Assistant, o General Chat, o Suggest Fix e o modo Edit.

Databricks Assistant suporta dois tipos de instruções: instruções do usuário e instruções d workspace. Salvo indicação em contrário, o assistente geralmente prioriza as instruções d workspace e em detrimento das instruções do usuário.

Adicionar instruções do usuário

As instruções do usuário permitem que você forneça instruções em nível de sistema ao Assistente. Eles são uma forma persistente de compartilhar contexto, preferências ou métodos de criação preferidos. Essas instruções são específicas para você e se aplicam somente às suas interações com o Assistente.

Para adicionar instruções de usuário:

1. Abra o painel Assistente clicando em “ ” no canto superior direito da tela “ workspace”.

2. No painel Assistente, clique para abrir as configurações do Assistente.

   

3. Em Instruções do usuário , clique em Adicionar arquivo de instruções . Isso cria um arquivo .assistant_instructions.md no diretório workspace default do usuário (/Users/<your-username-or-email>) e o abre em uma nova tab de arquivo.

   Se você já tiver criado um arquivo de instruções, clique em Abrir arquivo de instruções para abrir o arquivo.

4. Edite o arquivo .assistant_instructions.md para adicionar suas instruções personalizadas. A Databricks recomenda adicionar suas instruções em texto simples em inglês, separando cada instrução como um novo ponto ou parágrafo. Consulte Práticas recomendadas para obter instruções do Assistente.

O Assistente seleciona automaticamente as instruções na próxima vez que você interagir com ele.

Você também pode usar o Assistente para adicionar instruções para você. No painel do Assistente ou em uma caixa de entrada do Assistente em linha, use o comando /addInstructions.

Adicione e view workspace instruções

nota

Apenas os administradores do espaço de trabalho podem adicionar ou editar instruções de “ workspace ”.

As instruções do espaço de trabalho são configuradas pelo administrador do workspace e fornecem mais contexto ao Assistente para ajudá-lo a seguir as diretrizes e operar com mais eficiência no workspace.

Se o seu workspace ainda não possui instruções de workspace, um administrador do workspace pode criar o arquivo de instruções seguindo estas etapas:

1. No diretório Workspace/ do workspace, crie um novo arquivo chamado .assistant_workspace_instructions.md.
2. Edite o arquivo para adicionar instruções para o Assistente que devem ser aplicadas em todo o domínio workspace. A Databricks recomenda adicionar suas instruções em texto simples em inglês, separando cada instrução como um novo ponto ou parágrafo. Consulte Práticas recomendadas para obter instruções do Assistente.

O Assistente seleciona automaticamente as novas instruções workspace na próxima vez que um usuário interagir com ele.

Para enviar para view ou editar as instruções de workspace:

1. Abra o painel Assistente clicando em “ ” no canto superior direito da tela “ workspace”.

2. No painel Assistente, clique para abrir as configurações do Assistente.

3. Nas instruções da área de trabalho , clique em “Exibir arquivo ”. Isso abre o arquivo .assistant_workspace_instructions.md em uma nova janela tab.

4. Se você é um administrador do workspace, pode editar o arquivo e adicionar instruções que se aplicam ao comportamento do Assistente em todo o workspace. Consulte as práticas recomendadas para instruções do Assistente para obter mais informações sobre como adicionar instruções.

   Se o usuário não for um administrador, ainda é possível enviar o arquivo para view para compreender quais instruções o Assistente está seguindo, além de quaisquer instruções do usuário que possam ter sido fornecidas.

   

Práticas recomendadas para instruções do Assistant

É importante considerar as possíveis limitações do Assistente ao fornecer instruções. Aqui estão algumas diretrizes gerais e dicas para escrever instruções para otimizar sua experiência e aproveitar ao máximo este recurso.

• Escreva instruções claras e específicas: Seja explícito e inequívoco ao escrever suas instruções.
• Mantenha as instruções abaixo de 4.000 caracteres: Os arquivos de instruções são limitados a 4.000 caracteres. Qualquer instrução que ultrapasse esse limite não será usada pelo Assistente. Seja conciso e priorize instruções importantes.
• Use cabeçalhos e delimitadores para estrutura: as instruções estão nos arquivos Markdown. Use a formatação Markdown em suas instruções para fornecer estrutura. Use marcadores como delimitadores para separar instruções distintas. Use cabeçalhos para agrupar um conjunto de instruções. Por exemplo, você pode ter um título para as convenções de código Python d ",", que inclui uma lista com marcadores das diretrizes específicas do Python que o Assistente deve seguir ao trabalhar com código Python.
• Escopo: o Assistente aplica instruções a cada resposta que gera quando você interage com ele usando o Assistente em linha, o bate-papo geral, a sugestão de correção, o modo de edição etc. No entanto, o Assistente não considera as instruções para correção rápida e preenchimento automático. Mantenha as instruções amplamente relevantes para as diferentes funções do Assistente para evitar comportamentos não intencionais.
• Forneça contexto e referências: embora o Assistente utilize o contexto circundante, como o código do Notebook e os metadados da tabela, ele ainda não busca proativamente informações adicionais com base nas instruções. Para garantir respostas úteis, inclua quaisquer detalhes key diretamente nas instruções, como quando utilizar uma tabela ou função específica.

Dicas para melhorar as respostas do Assistente

Fornecer instruções permite que o Assistente gere respostas personalizadas de acordo com suas preferências. Além disso, há outras coisas gerais que você pode fazer ao interagir com o Assistente para ajudá-lo a retornar respostas melhores.

O Databricks Assistant considera o histórico da conversa para você refinar suas perguntas à medida que avança.

Seja específico

A estrutura e os detalhes fornecidos pelo Databricks Assistant variam de tempos em tempos, mesmo para o mesmo prompt. Tente fornecer ao Assistente o máximo de orientação possível para ajudá-lo a retornar as informações desejadas no formato, nível de detalhe e assim por diante. Considere fazer o seguinte:

• Especifique o nível de detalhe que você está procurando. Por exemplo, " Explique esse código em algumas frases " ou " Explique esse código linha por linha. "
• Especifique qual biblioteca o Assistente deve utilizar. Por exemplo, "Crie uma visualização utilizando Matplotlib" ou "Crie uma visualização utilizando Seaborn."
• Especifique a estrutura da resposta que você deseja. Por exemplo, " Forneça instruções nas etapas numeradas " ou " Forneça instruções com as etapas como marcadores com breves explicações. "
• Seja específico em suas solicitações. O Databricks Assistant conhece o esquema e os metadados da sua tabela e coluna, permitindo que você utilize linguagem natural para formular suas perguntas. Por exemplo, " Liste a taxa de aprovação de passes dos quarterbacks ativos e aposentados da NFL, para aqueles que tiveram mais de 500 tentativas em uma temporada. " O Databricks Assistant responde utilizando dados de colunas como s.player_id e s.attempts.

O Databricks Assistant utiliza o contexto para fornecer respostas mais adequadas.

O Databricks Assistant tem acesso a esquemas de tabelas e colunas e metadados. Isso permite que você use a linguagem natural e gere consultas mais precisas. Por exemplo, se uma tabela tiver uma coluna chamada Estado , é possível solicitar ao Databricks Assistant que gere uma lista de usuários que residem em Michigan.

O Databricks Assistant utiliza o seguinte contexto:

• Codifique ou insira consultas na célula atual do Notebook ou em um editor Databricks SQL tab.
• Nomes e descrições de tabelas e colunas.
• Perguntas imediatas anteriores.
• Tabelas favoritas e ativas.
• Para o recurso de diagnóstico de erros , o rastreamento da pilha a partir da saída do erro.

Como o Databricks Assistant utiliza seu histórico de conversas para fornecer respostas melhores e mais precisas, é possível solicitar ao Databricks Assistant que altere o resultado de uma resposta anterior sem precisar reescrever todo o prompt. Utilize o histórico de chat do Assistente para limpar, explorar, filtrar e segmentar iterativamente um DataFrames e no painel do Assistente.

Ajudar o assistente a trabalhar com o conjunto de dados

O Assistente pode acessar o contexto sobre as tabelas com as quais você está trabalhando. Aqui estão algumas medidas que podem ser tomadas para auxiliar na melhor resposta ao trabalhar com conjuntos de dados:

• Ao procurar uma tabela, utilize o prompt “ "” (Pesquisar tabelas) em" ou o comando “ /findTables ” para obter melhores resultados. Por exemplo, " Encontre tabelas relacionadas aos jogos da NFL. "

• Use @<table-name> para referenciar uma tabela específica em um prompt. O Assistente personalizará suas respostas para usar essa tabela.

• Ao selecionar colunas de um DataFrame, é possível obter resultados mais precisos fornecendo uma consulta inicial. Por exemplo, forneça uma declaração como SELECT * FROM <table_name>. Isso permite que o Databricks Assistant obtenha os nomes das colunas sem precisar adivinhar.

• Se for necessário utilizar conversões de tipo de dados de coluna para executar operações, pode ser necessário fornecer detalhes. Por exemplo: "Converta este código de Pandas para PySpark, incluindo o código necessário para converter Pandas DataFrame para PySpark DataFrame e alterando o tipo de dados da coluna churn de Booleano para inteiro."

• Documentar tabelas e colunas no Unity Catalog. Consulte Adicionar comentários gerados pelo AIa objetos Unity Catalog. Isso dá ao Assistente mais contexto sobre os dados. Use comentários de tabela ou coluna no Catalog Explorer para adicionar uma linha de dados de amostra. Por exemplo, suponha que sua coluna de altura esteja no formato feet-inches. Para auxiliar o Assistente a interpretar os dados, adicione um comentário como “ "”. A coluna altura está no formato de strings e é separada por um hífen. Exemplo: '6-2'. " Para obter informações sobre comentários em tabelas e colunas, consulte Adicionar comentários aos dados e AI ativo.

Editar e executar código em um painel de chat d Databricks Assistant

execução no painel Assistente para validá-lo ou utilizá-lo como bloco de notas. Para executar o código, clique em “ ” no canto superior esquerdo da caixa de código no painel Assistente.

A guia abaixo apresenta exemplos para o código Python e SQL:

Python

SQL

Quando o código é executado no painel Assistente, a saída é exibida e as variáveis tornam-se utilizáveis no Notebook.

Também é possível editar o código gerado pelo Databricks Assistant diretamente na caixa de bate-papo do Assistente antes de transferi-lo para o Bloco de notas.

Use Shift + Enter para adicionar uma nova linha na caixa de texto do bate-papo

Use Shift + Enter para adicionar uma nova linha na caixa de texto de bate-papo do Assistente. Isso facilita a formatação e a organização das suas mensagens para o Databricks Assistant.

Utilizar ações de célula em um Bloco de Notas

As ações da célula incluem atalhos para tarefas comuns, como documentar (comentar), corrigir e explicar código.

Recurso adicional

Para obter mais dicas, consulte:

• Databricks Assistant Dicas e truques para analista de dados
• Databricks Assistant Dicas e truques para engenheiro de dados