Personalize o Genie Code com instruções personalizadas

Personalize o Genie Code com instruções de usuário e de workspace que compartilham preferências, convenções de codificação, contexto de função e diretrizes. O Genie Code aplica estas instruções a todas as respostas, incluindo sugestões em linha e Sugerir Correção. Quick Fix e Preenchimento automático são as exceções.

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 Genie Code deve responder, como por exemplo, usando um tom informal.

Além das instruções de usuário e workspace , Genie Code descobre e lê automaticamente os arquivos AGENTS.md e CLAUDE.md em seu workspace. Ao abrir um Notebook ou arquivo, Genie Code percorre a árvore de diretórios e insere o conteúdo de quaisquer arquivos de instruções que encontrar em seu contexto. Nenhuma configuração é necessária.

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

Adicionar instruções de usuário

As instruções do usuário permitem que você forneça instruções de nível de sistema para o Genie Code. 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 Genie Code.

Para adicionar instruções ao usuário:

1. Abra o painel do Genie Code clicando em no canto superior direito do seu workspace.

2. No painel do Genie Code, clique em para abrir as configurações do Genie Code.

   

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 sobre o código Genie.

O Genie Code aprende automaticamente as instruções na próxima vez que você interagir com ele.

Você também pode pedir ao Genie Code para lembrar das coisas para você enquanto trabalha. Ele salva isso na própria memória, separado deste arquivo de instruções. Consulte Lembrar o contexto entre sessões com a memória do Genie Code.

Adicionar e visualizar instruções de workspace

nota

Somente administradores de Workspace podem adicionar ou editar instruções de Workspace.

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

Se seu Workspace ainda não tiver instruções de Workspace, um administrador do 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 para Genie Code que devem ser aplicadas em 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 sobre o código Genie.

Genie Code aprende 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 do Genie Code clicando em no canto superior direito do seu workspace.

2. No painel do Genie Code, clique em para abrir as configurações do Genie Code.

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 do workspace, poderá editar o arquivo e adicionar instruções que se aplicam ao comportamento do Genie Code em todo o workspace. Consulte Práticas recomendadas para instruções do Genie Code para obter mais informações sobre como adicionar instruções.

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

   

Melhores práticas para instruções do código Genie

Escreva as instruções do Genie Code como pontos de bala claros e específicos com menos de 20.000 caracteres e leve em consideração as limitações do Genie Code ao escrevê-las. As diretrizes a seguir ajudam você a obter o máximo das instruções.

• Escreva instruções claras e específicas : Seja explícito e inequívoco ao escrever suas instruções.
• Mantenha as instruções abaixo de 20.000 caracteres : Os arquivos de instrução são limitados a 20.000 caracteres. O Genie Code não usa nenhuma instrução além desse limite. Seja conciso e priorize as 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 cabeçalhos para agrupar um conjunto de instruções. Por exemplo, você pode ter um cabeçalho para "Convenções de código Python" que inclui uma lista com marcadores de diretrizes específicas do Python que o Genie Code deve seguir ao trabalhar com código Python.
• Escopo : O Genie Code aplica instruções a cada resposta gerada quando você interage com ele usando o Inline Genie Code, o General Chat, o Suggest Fix e recursos semelhantes. No entanto, o Genie Code não considera instruções para Quick Fix e Autocomplete. Mantenha as instruções amplamente relevantes para diferentes funções do Genie Code para evitar comportamentos não intencionais.
• Forneça contexto e referências : Embora o Genie Code use contexto ao redor, como código de notebook e metadados de tabela, ele 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 usar uma tabela ou função específica.