Partilhar via


Adicionar instruções personalizadas

Pode personalizar a resposta do Genie Code adicionando instruções personalizadas. O Código Génio 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 serem seguidas.
  • Orientações a seguir.
  • Instruções sobre como o Código Génio deve responder, como usar um tom casual.

Com exceção do Quick Fix e do Autocomplete, o Código Genie aplica instruções a todas as respostas que gera, incluindo Assistente Inline, Chat Geral, Sugestão de Correção, modo de Edição e modo Agente.

O Código Genie suporta dois tipos de instruções: instruções do utilizador e instruções para o espaço de trabalho. Salvo instrução em contrário, o Genie Code geralmente prioriza as instruções do espaço de trabalho em detrimento das instruções do utilizador.

Adicionar instruções de utilizador

As instruções de utilizador permitem-lhe fornecer instruções ao nível do sistema para o Genie Code. 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 ti e aplicam-se apenas às tuas interações com o Código Génio.

Para adicionar instruções de utilizador:

  1. Abra o painel do Código Génio clicando no ícone do assistente Avatar. no canto superior direito do seu espaço de trabalho.

  2. No painel do Código Génio, clique no ícone Engrenagem para abrir as definições do Código Génio.

    Adicionar instruçõ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 as melhores práticas para instruções do Código Genie.

O Código Génio capta automaticamente as instruções na próxima vez que interagires com ele.

Também podes usar o Código Genie para adicionar instruções para ti. No painel do Código Génio, pede ao Código Génio que se lembre de algo.

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

Observação

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

As instruções do espaço de trabalho são configuradas pelo administrador do seu espaço de trabalho e fornecem mais contexto ao Código Genie para o ajudar a seguir as diretrizes e a operar de forma mais eficiente no seu 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. No Workspace/ diretório do espaço de trabalho, crie um ficheiro chamado .assistant_workspace_instructions.md.
  2. Edite o ficheiro para adicionar instruções para o Código Genie que deverão aplicar-se a todo o espaço de trabalho. O Databricks recomenda adicionar as suas instruções em texto em inglês simples, separando cada instrução como um ponto ou parágrafo próprio. Consulte as melhores práticas para instruções do Código Genie.

O Código Genie capta automaticamente as novas instruções do espaço de trabalho na próxima vez que um utilizador interagir com ele.

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

  1. Abra o painel do Código Génio clicando no ícone do assistente Avatar. no canto superior direito do seu espaço de trabalho.

  2. No painel do Código Génio, clique no ícone Engrenagem para abrir as definições do Código Génio.

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

  4. Se for administrador de espaço de trabalho, pode editar o ficheiro e adicionar instruções que se aplicam ao comportamento do Genie Code em todo o espaço de trabalho. Consulte as melhores práticas para instruções do Código Genie para mais informações sobre como adicionar instruções.

    Se não for administrador, pode ver o ficheiro para perceber que instruções o Genie Code está a seguir, além de quaisquer instruções de utilizador que possa ter fornecido.

    Veja as instruções do Assistente do espaço de trabalho.

Boas práticas para instruções do Código Genie

É importante considerar as potenciais limitações do Código Genie 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.
  • Mantém as instruções abaixo dos 20.000 caracteres: Os ficheiros de instruções estão limitados a 20.000 caracteres. Quaisquer instruções que ultrapassem este limite não serão usadas pelo Código Genie. 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, pode ter um título para "Convenções de código Python" que inclui uma lista de diretrizes específicas para Python com marcadores que o Genie Code deve seguir ao utilizar código Python.
  • Âmbito: O Código Genie aplica instruções a todas as respostas que gera quando interages com ele usando Código Genie Inline, Chat Geral, Sugestão de Correção, modo de Edição, etc. No entanto, o Código Genie não considera instruções para Correção Rápida e Autocompletamento. Mantenha as instruções amplamente relevantes para diferentes funções do Código Génio para evitar comportamentos não intencionais.
  • Forneça contexto e referências: Embora o Código Genie utilize contextos envolventes, como o código do caderno e metadados das tabelas, ainda não recolhe 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.