Use o Código Génio

O Genie Code ajuda os programadores a gerar, otimizar, explicar e corrigir código nos notebooks Azure Databricks, no editor SQL, em jobs, painéis de IA/BI e no editor de ficheiros.

Para saber como o Genie Code ajuda com código, veja Obter ajuda para programação no Genie Code.

Visão geral do painel Genie Code

Para abrir o painel do Código Génio, clique No canto superior direito da página.

Introduz um prompt na caixa de texto no fundo do painel, depois pressione Enter ou clique . É possível:

• Clique no Ícone Plus para se ligar a servidores MCP ou anexar ficheiros.
• Clique no entre @ para selecionar recursos que o Código Genie possa consultar.
• Enter / para selecionar e executar um comando de barra.

Se pedires ao Código Genio para ajudar com o código, ele guia-te na execução, aceitação ou rejeição das alterações que propõe.

Trabalhar com múltiplas threads como tabulações

O painel Genie Code mostra as conversas de chat abertas sob a forma de separadores ao longo da parte superior do painel. Podes executar mais do que uma tarefa ao mesmo tempo e mover-te entre threads sem perder o teu lugar.

• Mudar de tópico: Clique num separador para ativar esse tópico. Um thread continua a correr em segundo plano quando mudas de separador, por isso podes começar uma tarefa longa num thread e continuar a trabalhar noutra.
• Abra um novo tópico: Clique Novo chat para iniciar um tópico numa nova aba.
• Reabrir um tópico anterior: Clique Histórico de threads e seleciona um thread para abrir num separador.
• Gerir um tópico: Use o menu kebab num separador ativo para gerir o tópico, ou clique fechar o separador.

Controlos do painel Genie Code

O cabeçalho do painel Genie Code tem os seguintes controlos:

Controlo	Description
Novo chat	Inicia um novo tópico num novo separador.
Histórico da conversa	Veja os tópicos de chat anteriores e reabra um num separador.
Mais	Aceder às Definições e a outras opções. Consulte as definições do Código Genie.
Fechar	Colapsar o painel do Código Génio.

Definições do Código Génio

Para abrir as definições do Genie Code, clique no menu Mais no cabeçalho do painel e, em seguida, clique em Definições. O painel de definições inclui o seguinte:

Modo de agente

O Genie Code corre em modo Agente, que automatiza fluxos de trabalho em vários passos, planeia soluções, recupera ativos relevantes, executa código, utiliza as saídas das células para melhorar resultados e corrige erros automaticamente. Se quiser uma resposta conversacional direta sem execução autónoma de tarefas, diga isso no seu prompt, por exemplo: "Explique-me isto, não execute nenhum código."

Para concluir tarefas, o Genie Code envia o seu prompt e o contexto relevante para o modelo, incluindo nomes de tabelas e colunas, descrições, o código em que está a trabalhar, amostras de dados de tabelas e resultados das células. Todos os dados enviados para o modelo respeitam as permissões do seu Unity Catalog. Para mais detalhes, consulte as Perguntas Frequentes sobre privacidade e segurança.

Requirements

Para utilizar as capacidades agenticas do Genie Code, o seu espaço de trabalho precisa do seguinte:

• Funcionalidades de IA potenciadas por parceiros ativadas tanto para a conta como para o espaço de trabalho. Consulte Funcionalidades de IA potenciadas por parceiros.
• O seu espaço de trabalho deve estar numa região suportada. O Código Genie é um Serviço Designado que utiliza Geos para gerir a residência de dados. Consulte a disponibilidade geográfica das funcionalidades do Código Genie.

Se as funcionalidades de IA suportadas por parceiros forem desativadas, o Genie Code continua disponível, mas sem as suas capacidades autónomas, utilizando um modelo alojado pela Databricks.

Código Genie de página inteira (Beta)

O Genie Code tem uma experiência de command center de página completa, onde o thread ativo é mostrado de forma proeminente, apresentando ativos como cadernos e ficheiros ao lado como separadores quando necessário. Ver página completa Código Génio.

Aprovar ações da ferramenta

Quando o Genie Code precisa de usar uma ferramenta, como executar código, editar um caderno ou consultar uma tabela, pede a sua aprovação antes de avançar. Pode aprovar cada pedido individualmente, ou definir um modo de aprovação que se aplique ao resto da sua thread atual ou a todas as threads futuras.

Aprovar um único pedido

Quando o Genie Code pedir permissão para usar uma ferramenta, clique em Permitir para aprovar a ação ou em Ignorar para recusar.

Para alterar a forma como o Genie Code lida com futuros pedidos de aprovação no tópico atual, selecione um dos seguintes itens no mesmo prompt:

Definir um modo de aprovação predefinido

Para aplicar o mesmo modo de aprovação a cada thread do Código Genie, defina um padrão nas definições do Código Genie. Clica no cabeçalho do Código Génio para abrir definições.

Escolha uma das seguintes opções:

• Pergunte primeiro: Aprove cada ferramenta quando estiver a correr. As substituições definidas para cada ferramenta continuam a aplicar-se.

• Autoaprovação: Um classificador de IA analisa cada ação proposta contra a sua intenção declarada e aprova ou bloqueia cada uma, minimizando aprovações manuais enquanto bloqueia ações arriscadas.

  Importante

  A aprovação automática é uma funcionalidade de produtividade, não um limite de segurança. O classificador é uma heurística de melhor esforço que pode estar errada. Pode aprovar ações inseguras ou bloquear ações seguras. Não confie nela para impor requisitos de segurança, conformidade ou controlo de acessos. Mantenha a aprovação automática desligada ao trabalhar com dados de produção, espaços de trabalho sensíveis ou recursos partilhados onde as consequências de uma aprovação incorreta são importantes. Continuas responsável por rever os resultados do Código Génio.

Quando a aprovação automática está ativada, o Genie Code normalmente permite operações de baixo risco, como consultas apenas de leitura, edições nos seus próprios ficheiros de espaço de trabalho e cadernos, escritas em tabelas que possui e tarefas ou pipelines em execução que já referiu. Bloqueia tudo o que possa alargar o âmbito ou afetar recursos partilhados, como operações destrutivas, implementações em ambiente de produção, alterações de permissões e de segredos, chamadas externas para terceiros e operações arriscadas de controlo de versão, como envios forçados.

Quando uma ação é bloqueada, o Código Génio recebe a razão e adapta-se, por exemplo, tentando novamente com um âmbito mais restrito.

Partilhar um tópico de chat

Pode partilhar tópicos de chat do Código Genie com outros utilizadores, grupos ou responsáveis pelo serviço.

Para partilhar um tópico de conversa:

1. No painel do Código Génio, clique Histórico de tópicos para abrir o histórico do chat.

2. Passa o rato sobre o tópico de chat que queres partilhar e clica no Menu Kebab.

3. Clique Partilhar.

4. Na caixa de diálogo de partilha, adicione os utilizadores, grupos ou entidades de serviço com quem pretende partilhar. Os destinatários recebem a permissão Pode ver no tópico de conversa. Consulte as ACLs do chat do Genie Code.

5. (Opcional) Verifique Enviar um email aos novos utilizadores para enviar uma notificação por email aos novos utilizadores adicionados.

6. (Opcional) Para partilhar um link direto para a conversa, clique no Copie o link no final do diálogo de partilha.

7. Clique em Adicionar para partilhar a conversa.

Obter ajuda com o código

Obtenha ajuda com o código do Genie Code diretamente nos seus cadernos. O Código Génio oferece:

• Use o Genie Code para data science para ajudar a planear e automatizar workflows de ciência de dados em várias etapas.
• Preenchimento automático baseado em IA.
• Filtragem de dados com prompts de linguagem natural.
• Depuração de código com erro de diagnóstico.
• Quick Fix, que apresenta recomendações automáticas para corrigir erros de código que você pode aceitar e executar.
• Execução de código sem servidor.

Os utilizadores devem sempre rever qualquer código gerado pelo Genie Code antes de o executar, pois por vezes pode cometer erros.

Para mais informações sobre como o Genie Code pode ajudar com código, veja Obter ajuda para programação do Genie Code.

Código otimizado para o ambiente Azure Databricks

O código gerado pelo Genie Code destina-se a ser executado num ambiente de computação Databricks. Ele é otimizado para criar código em linguagens de programação, estruturas e dialetos suportados pelo Databricks. Não se destina a ser um assistente de programação de uso geral.

O Genie Code utiliza frequentemente informações de recursos do Databricks, como o site de documentação do Databricks ou a Base de Conhecimento, para responder melhor às perguntas dos utilizadores. Ele funciona melhor quando a pergunta do usuário está relacionada a perguntas que podem ser respondidas com conhecimento da documentação do Databricks, do Unity Catalog e do código do usuário no espaço de trabalho.

Obtenha respostas baseadas na documentação

O Genie Code pesquisa a documentação do Databricks para responder às suas perguntas. Quando faz referência à documentação, vê um passo de Pesquisa de documentação na resposta. Pode pedir ao Genie Code que cite as suas fontes, e ele fornece ligações para páginas de documentação relevantes.

Dá feedback sobre as respostas do Código Génio

Diz-nos se as respostas do Código Génio são úteis ou não:

1. Passe o rato logo abaixo da resposta do Código Génio.
2. Clique no botão ou .

Recursos adicionais

• Código Génio
• Obtenha ajuda de programação com a Genie Code
• Medir o impacto do Código Genie
• Dicas para melhorar as respostas do Código Génio
• Observabilidade de serviço de modelo com o Código Genie