Compartilhar via


Adicionar instruções personalizadas

Você pode personalizar como o Genie Code responde adicionando instruções personalizadas. O Genie Code considera essas 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.
  • Diretrizes a seguir.
  • Instruções sobre como o Genie Code deve responder, como usar um tom casual.

Com exceção de Correção Rápida e Preenchimento Automático, o Genie Code aplica instruções a cada resposta gerada, incluindo Assistente Embutido, Chat Geral, Sugestão de Correção, Modo de Edição e Modo de Agente.

O Genie Code dá suporte a dois tipos de instruções: instruções do usuário e instruções de workspace. A menos que seja instruído de outra forma, o Genie Code geralmente prioriza as instruções do workspace sobre as instruções do usuário.

Adicionar instruções do usuário

As instruções do usuário permitem que você forneça instruções no nível do sistema ao Genie Code. Eles são uma maneira persistente de compartilhar contexto, preferências ou métodos de criação preferenciais. Essas instruções são específicas para você e são aplicadas apenas às interações com o Genie Code.

Para adicionar instruções ao usuário:

  1. Abra o painel Código do Genie clicando no ícone do assistente avatar. no canto superior direito da área de trabalho.

  2. No painel Genie Code, clique no ícone Engrenagem. Para abrir as configurações do Genie Code.

    Adicionar instruções do Assistente.

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

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

  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 sem formatação, separando cada instrução como um novo ponto de marcador ou parágrafo. Consulte as práticas recomendadas para instruções do Genie Code.

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

Você também pode usar o Genie Code para adicionar instruções para você. No painel Genie Code, solicite ao Genie Code para lembrar de algo.

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

Observação

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

As instruções do workspace são configuradas pelo administrador do 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 o workspace ainda não possuir instruções de uso, um administrador do workspace poderá criar o arquivo de instruções seguindo estas etapas:

  1. Workspace/ No diretório do workspace, crie um arquivo chamado .assistant_workspace_instructions.md.
  2. Edite o arquivo para adicionar instruções para o Genie Code que devem aplicar para todo o workspace. O Databricks recomenda adicionar suas instruções em inglês claro, separando cada instrução em tópicos ou parágrafos. Consulte as práticas recomendadas para instruções do Genie Code.

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

Para exibir ou editar instruções de workspace:

  1. Abra o painel Código do Genie clicando no ícone do assistente avatar. no canto superior direito da área de trabalho.

  2. No painel Genie Code, clique no ícone Engrenagem. Para abrir as configurações do Genie Code.

  3. Nas instruções do Workspace, clique em Exibir arquivo. Isso abre o arquivo .assistant_workspace_instructions.md em uma nova guia.

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

    Se você não for um administrador, ainda poderá exibir 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.

    Exibir instruções do Assistente do espaço de trabalho.

Práticas recomendadas para instruções do Genie Code

É importante considerar as possíveis limitações do Genie Code 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ívoca 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. Quaisquer instruções além desse limite não serão usadas pelo Genie Code. Seja conciso e priorize instruções importantes.
  • Use títulos e delimitadores para estrutura: As instruções estão nos arquivos markdown. Use a formatação do Markdown em suas instruções para fornecer estrutura. Use pontos de marcador 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 inclui uma lista de tópicos com 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 Código do Gênio Embutido, Chat Geral, Sugestão de Correção, Modo de Edição etc. No entanto, o Genie Code não considera instruções para Correção Rápida e Preenchimento Automático. Mantenha 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 o contexto ao redor, como o código do notebook e os 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 principais diretamente nas instruções, como quando usar uma tabela ou função específica.