Adicionar instruções personalizadas

Você pode personalizar a forma como o Databricks Assistant responde adicionando instruções personalizadas. O assistente leva em consideração essas instruções ao gerar novas respostas.

Por exemplo, as instruções podem incluir:

• Informações sobre suas preferências, como por exemplo, qual biblioteca 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 por exemplo, usando um tom informal.

Com exceção da Correção Rápida e do Preenchimento Automático, o Databricks Assistant aplica instruções a todas as respostas que gera, incluindo o Assistente Inline, o Chat Geral, a Sugestão de Correção, o Modo de Edição e o Modo Agente.

Databricks Assistant suporta dois tipos de instruções: instruções para o usuário e instruções workspace . A menos que seja instruído de outra forma, o assistente geralmente prioriza as instruções workspace em relação às instruções do usuário.

Adicionar instruções ao usuário

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

Para adicionar instruções ao usuário:

1. Abra o painel Assistente clicando em no canto superior direito da sua workspace.

2. No painel Assistente, clique em 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á criou 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 item ou parágrafo. Consulte as Melhores práticas para obter instruções do Assistente.

O Assistente aprende 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, peça ao Assistente para se lembrar de algo.

Adicionar e view instruções workspace

nota

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

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

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

1. No diretório Workspace/ do workspace, crie um arquivo chamado .assistant_workspace_instructions.md.
2. Edite o arquivo para adicionar instruções ao Assistente que devem ser aplicadas a todo workspace . A Databricks recomenda adicionar suas instruções em texto simples em inglês, separando cada instrução em um tópico ou parágrafo individual. Consulte as Melhores práticas para obter instruções do Assistente.

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

Para view ou editar as instruções workspace :

1. Abra o painel Assistente clicando em no canto superior direito da sua workspace.

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

3. Em instruções do espaço de trabalho , clique em visualizar arquivo . Isso abre o arquivo .assistant_workspace_instructions.md em uma nova tab.

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

   Mesmo que você não seja administrador, ainda poderá view 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.

   

Melhores práticas para instruções do Assistente

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

• Escreva instruções claras e específicas: Seja explícito e inequívoco ao escrever suas instruções.
• Mantenha as instruções com menos de 20.000 caracteres: Os arquivos de instruções estão limitados a 20.000 caracteres. Quaisquer instruções que ultrapassem esse limite não serão utilizadas pelo Assistente. Seja conciso e priorize as instruções importantes.
• Utilize títulos e delimitadores para estruturar o texto: as instruções estão nos arquivos Markdown. Utilize 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.
• Escopo: O Assistente aplica instruções a cada resposta gerada quando você interage com ele usando o Assistente embutido, o Chat geral, a opção Sugerir 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 relevantes para as diferentes funções do Assistente, a fim de evitar comportamentos indesejados.
• 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 detalhes key diretamente nas instruções, como quando usar uma tabela ou função específica.