Personalize e melhore as respostas do Databricks Assistant

Esta página fornece dicas e práticas recomendadas para ajudar o Databricks Assistant a fornecer melhores respostas.

Personalizar as respostas do Assistente adicionando instruções

Você pode personalizar como o Databricks Assistant responde adicionando instruções personalizadas. O assistente considera estas instruções quando gera novas respostas.

Por exemplo, as instruções podem incluir:

• Informações sobre suas preferências, como quais bibliotecas você prefere usar ao escrever código.
• Contexto sobre quem você é, como seu nome e função.
• Convenções de codificação a seguir.
• Orientações a seguir.
• 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 geradas, incluindo o Assistente Inline, o Chat Geral, o modo Sugerir Correção e o modo Editar.

O Databricks Assistant suporta dois tipos de instruções: instruções do usuário e instruções do espaço de trabalho. A menos que seja instruído de outra forma, o assistente geralmente prioriza as instruções do espaço de trabalho sobre as instruções do usuário.

Adicionar instruções de utilizador

As instruções de utilizador permitem-lhe fornecer instruções ao nível do sistema ao Assistente. Eles são uma maneira persistente de compartilhar contexto, preferências ou métodos de criação preferidos. Estas instruções são específicas para si e aplicam-se apenas às suas interações com o Assistente.

Para adicionar instruções de utilizador:

1. Abra o painel Assistente clicando no no canto superior direito do espaço de trabalho.

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

   

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

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

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

O Assistente recolhe automaticamente as instruções da próxima vez que interagir com ele.

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

Adicionar e exibir instruções do espaço de trabalho

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

Se seu espaço de trabalho ainda não tiver instruções de espaço de trabalho, um administrador de espaço de trabalho poderá criar o arquivo de instruções seguindo estas etapas:

1. Workspace/ No diretório do espaço de trabalho, crie um novo arquivo chamado .assistant_workspace_instructions.md.
2. Edite o arquivo para adicionar instruções para o Assistente que deve ser aplicado em todo o espaço de trabalho. O Databricks recomenda adicionar suas instruções em texto em inglês simples, separando cada instrução como um novo marcador ou parágrafo. Consulte Práticas recomendadas para obter instruções do Assistente.

O Assistente seleciona automaticamente as novas instruções do espaço de trabalho na próxima vez que um usuário interage com ele.

Para visualizar ou editar instruções do espaço de trabalho:

1. Abra o painel Assistente clicando no no canto superior direito do espaço de trabalho.

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

3. Em Instruções do espaço de trabalho, clique em Exibir arquivo. Isso abre o .assistant_workspace_instructions.md arquivo em uma nova guia.

4. Se você for um administrador de espaço de trabalho, poderá editar o arquivo e adicionar instruções que se aplicam ao comportamento do Assistente em todo o espaço de trabalho. Consulte Práticas recomendadas para instruções do Assistente para obter mais informações sobre como adicionar instruções.

   Se você não for um administrador, ainda poderá visualizar o arquivo para entender quais instruções o Assistente está seguindo, além de quaisquer instruções de usuário que você possa ter fornecido.

   

Práticas recomendadas para instruções do Assistente

É 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 esse recurso.

• Escreva instruções claras e específicas: Seja explícito e inequívoco ao escrever as suas instruções.
• Mantenha as instruções abaixo de 4000 caracteres: Os arquivos de instruções são limitados a 4000 caracteres. Quaisquer instruções que ultrapassem este limite não serão utilizadas pelo Assistente. Seja conciso e priorize instruções importantes.
• Use cabeçalhos e delimitadores para estrutura: As instruções estão em arquivos Markdown. Use a formatação Markdown em suas instruções para fornecer estrutura. Use marcadores como delimitadores para separar instruções distintas. Use títulos para agrupar um conjunto de instruções. Por exemplo, você pode ter um título para "Convenções de código Python" que inclua uma lista com marcadores de diretrizes específicas do Python que o Assistente deve seguir ao trabalhar com código Python.
• Âmbito de aplicação: O Assistente aplica instruções a cada resposta que gera quando interage com ele usando o Assistente Inline, Chat Geral, Sugerir Correçã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 instruções amplamente relevantes para diferentes funções do Assistente para evitar comportamentos não intencionais.
• Forneça contexto e referências: Embora o Assistente use o contexto circundante, como código de bloco de anotações e metadados de tabela, ele ainda não busca proativamente informações adicionais com base nas instruções. Para garantir respostas úteis, inclua todos os detalhes importantes diretamente nas instruções, como quando usar uma determinada tabela ou função.

Dicas para melhorar as respostas do Assistente

O fornecimento de instruções permite ao Assistente gerar respostas personalizadas de acordo com as 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 que você possa refinar suas perguntas à medida que avança.

Seja específico

A estrutura e os detalhes que o Databricks Assistant fornece 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 desejado, nível de detalhe e assim por diante. Considere fazer o seguinte:

• Especifique o nível de detalhe que procura. Por exemplo, "Explicar este código em algumas frases" ou "Explicar este código linha por linha".
• Especifique qual biblioteca você deseja que o Assistente use. Por exemplo, "Criar uma visualização usando Matplotlib" ou "Criar uma visualização usando Seaborn".
• Especifique a estrutura da resposta desejada. Por exemplo, "Forneça instruções em 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, para que possa utilizar linguagem natural para colocar a sua questão. Por exemplo, "Liste a taxa de conclusão de passes de quarterbacks ativos e aposentados da NFL, para aqueles que tiveram mais de 500 tentativas em uma temporada." O Databricks Assistant responde usando dados de colunas como s.player_id e s.attempts.

O Databricks Assistant usa o contexto para fornecer respostas melhores

O Databricks Assistant tem acesso a esquemas e metadados de tabelas e colunas. Isso permite que você use linguagem natural e gere consultas mais precisas. Por exemplo, se uma tabela tiver uma coluna chamada Estado, você poderá pedir ao Databricks Assistant para gerar uma lista de usuários que moram em Michigan.

O Databricks Assistant usa o seguinte contexto:

• Código ou consultas na célula atual do bloco de anotações ou na guia do editor SQL do Databricks.
• Nomes e descrições de tabelas e colunas.
• Perguntas prévias.
• Mesas favoritas e ativas.
• Para o recurso de erro de diagnóstico , o rastreamento de pilha da saída do erro.

Como o Databricks Assistant usa seu histórico de conversas para fornecer respostas melhores e mais precisas, você pode pedir ao Databricks Assistant para alterar a saída de uma resposta anterior sem ter que reescrever todo o prompt. Use o histórico de bate-papo do Assistente para limpar, explorar, filtrar e fatiar iterativamente DataFrames no painel Assistente.

Ajudar o Assistente a trabalhar com conjuntos de dados

O Assistente pode acessar o contexto sobre as tabelas com as quais você está trabalhando. Aqui estão algumas coisas que você pode fazer para ajudá-lo a responder melhor ao trabalhar com conjuntos de dados:

• Ao procurar uma tabela, use o prompt "Localizar tabelas" ou o comando /findTables para obter melhores respostas. Por exemplo, "Encontre tabelas relacionadas a jogos da NFL".

• Use @<table-name> para fazer referência a uma tabela específica em um prompt. O Assistente adaptará as suas respostas para utilizar essa tabela.

• Ao selecionar colunas de um DataFrame, você pode obter resultados mais precisos fornecendo uma consulta inicial. Por exemplo, forneça uma instrução como SELECT * FROM <table_name>. Isso permite que o Databricks Assistant obtenha os nomes das colunas e não precise adivinhar.

• Se você precisar usar conversões de tipo de dados de coluna para executar uma operação, talvez seja necessário fornecer detalhes. Por exemplo: "Converta este código de pandas para PySpark, incluindo o código necessário para converter o DataFrame de pandas em um DataFrame PySpark e alterando o tipo de dados de rotatividade de coluna de booleano para inteiro."

• Documente tabelas e colunas no Catálogo Unity. Consulte Adicionar comentários gerados por IA a objetos do Catálogo Unity. Isso dá ao Assistente mais contexto sobre os dados. Use comentários de tabela ou coluna no Gerenciador de Catálogo para adicionar uma linha de dados de exemplo. Por exemplo, suponha que sua coluna de altura esteja no formato feet-inches. Para ajudar o Assistente a interpretar os dados, adicione um comentário como "A coluna de altura está em formato de cadeia de caracteres e é separada por um hífen. Exemplo: '6-2'." Para obter informações sobre comentários de tabelas e colunas, consulte Adicionar comentários a dados e ativos de IA.

Editar e executar código no painel de chat do Assistente do Databricks

Execute o código no painel Assistente para validá-lo ou usá-lo como um scratchpad. Para executar código, clique no no canto superior esquerdo da caixa de código no painel Assistente.

As guias abaixo mostram exemplos de código Python e SQL:

Python

SQL

Quando você executa o código no painel Assistente, a saída é exibida e as variáveis se tornam utilizáveis no bloco de anotações.

Você também pode editar o código que o Assistente Databricks gera diretamente na caixa de bate-papo do Assistente antes de mover o código para o bloco de anotações.

Usar 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 do bate-papo do Assistente. Isso facilita a formatação e organização de suas mensagens para o Databricks Assistant.

Usar ações de célula em um bloco de anotações

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

Recursos adicionais

Para mais dicas, consulte:

• Dicas e truques do Databricks Assistant para analistas de dados
• Dicas e truques do Databricks Assistant para engenheiros de dados