Use o código Genie
Genie Code ajuda os desenvolvedores a gerar, otimizar, explicar e corrigir código nos notebooks do Databricks, no editor SQL, nos jobs, nos dashboards de AI/BI e no editor de arquivos. Use o modo Chat para explicações e geração rápida de código, e o modo Agente (o default) para que o Genie Code planeje e conclua autonomamente tarefas de várias etapas.
Caso desative os recursos de IA oferecidos por parceiros, o Genie Code executa apenas no modo de Chat, impulsionado por um modelo hospedado pela Databricks. O modo de agente requer recursos de IA oferecidos por parceiros.
Para aprender como o Genie Code ajuda com a programação, consulte Obtenha ajuda de programação do Genie Code.
Visita Guiada ao Painel do Genie Code
Para abrir o painel do Genie Code, clique em 
no canto superior direito da página.
Insira um prompt na caixa de texto na parte inferior do painel e, em seguida, pressione Enter ou clique em 
. Você pode:
- Clique no ícone de mais
para conectar-se aos servidores MCP ou anexar arquivos. - Clique no
ícone ou digite **@** para selecionar recursos para o Genie Code referenciar. - Insira **/** para selecionar e executar um comando de barra.
Se solicitar ao Genie Code para ajudar com o código, ele o orienta através da execução, aceitação ou rejeição das alterações que propõe.
Trabalhe com vários threads como tabs
O painel Genie Code exibe os threads de chat abertos como tabs na parte superior do painel. É possível executar mais de uma tarefa por vez e alternar entre threads sem perder o seu lugar.
- **Alternar tópicos**: Clique em uma tab para ativar esse tópico. Um tópico continua sendo executado em segundo plano quando você alterna entre tabs, então você pode começar uma tarefa longa em um tópico e continuar trabalhando em outro.
- Abrir um novo tópico : Clique em
Novo bate-papo para começar um tópico em uma nova tab. - Reabra um thread anterior : Clique em
Histórico de threads e selecione um thread para abri-lo em uma tab. - Gerenciar um tópico: Use o
menu kebab em uma tab ativa para gerenciar o tópico, ou clique 
em para fechar a tab.
Controles do painel Genie Code
O cabeçalho do painel do Genie Code tem os seguintes controles:
Controle | Descrição |
|---|---|
| Iniciar um novo tópico em uma nova tab. |
| Visualize threads de chat anteriores e reabra um em uma tab. |
| Acesse Configurações |
| Recolher o painel Genie Code. |
Configurações do Genie Code
Para abrir as configurações do Genie Code, clique no menu Mais no cabeçalho do painel e depois clique em Configurações 
. O painel de configurações inclui o seguinte:
Contexto | Descrição |
|---|---|
Ações | Defina como o Genie Code pede aprovação antes de usar uma ferramenta. Veja Aprovar ações da ferramenta. |
Servidores MCP | Conecte-se a ferramentas externas e fontes de dados usando servidores MCP e conectores integrados. |
Ativar/desativar view do painel | Escolha se deseja usar o Genie Code em uma view de painel Encaixado ou em uma view de painel Lateral . |
Instruções do usuário | Adicione instruções do usuário que orientam como o Genie Code responde. |
Instruções do workspace | Adicione instruções de workspace que se aplicam a todos no workspace. |
Habilidades | Adicione habilidades de agente reutilizáveis que o Genie Code pode aplicar a tarefas. |
Habilidades de workspace | Adicione habilidades que estão disponíveis para todos no workspace. |
Política de uso de serverless | Defina a política de uso serverless para executar código que o Genie Code gera na saída do chat. |
Modos de Chat e Agente
O Genie Code funciona em dois modos: Chat para perguntas rápidas e geração de código, e Agent para fluxos de trabalho autônomos de múltiplas etapas. O Modo Agente é o default.
O modo agente requer o seguinte:
- Recursos AI com tecnologia de parceiros habilitados tanto para a account quanto para workspace. Veja recurso AI com tecnologia de parceiros.
- Seu workspace deve estar em uma região compatível. Genie Code é um serviço designado que utiliza Geos para gerenciar a residência de dados. Veja a disponibilidadeGeo do recurso Genie Code.
Para alternar entre os modos, utilize o seletor de modo na parte inferior do painel do Genie Code:
A tabela abaixo resume os dois modos do Código Genie:
Mode | Capacidades | Quando usar | Exemplos de perguntas |
|---|---|---|---|
Bate-papo | Responda às perguntas para ajudá-lo a entender o código e os conceitos. Gere e execute o código dentro do chat. |
|
|
Agente | Automatize o fluxo de trabalho em várias etapas, planeje soluções, recupere ativos relevantes, código de execução, use saídas de células para melhorar resultados, corrija erros automaticamente e muito mais. |
|
|
O Genie Code envia dados diferentes para o modelo dependendo do modo:
- **Modo de chat** envia seu prompt e metadados relevantes, como nomes de tabelas e colunas, descrições e o código com o qual você está trabalhando. Não envia dados de suas tabelas.
- **Modo Agente** também pode ler amostras de dados de tabelas e analisar saídas de células para concluir tarefas de várias etapas.
Todos os dados enviados para o modelo respeitam suas permissões do Unity Catalog. Para obter detalhes sobre o que cada modo envia, consulte Perguntas frequentes sobre privacidade e segurança.
Genie Code de página inteira (Beta)
O Genie Code tem uma experiência de centro de comando de página inteira, onde o tópico ativo é exibido de forma proeminente, exibindo ativos como notebooks e arquivos ao lado dele como tabs quando necessário. Consulte Genie Code da página completa.
Aprovar ações da ferramenta
Quando o Genie Code precisa usar uma ferramenta, como executar código, editar um Notebook ou consultar uma tabela, ele pede sua aprovação antes de prosseguir. É possível aprovar cada solicitação individualmente, ou definir um modo de aprovação que se aplique ao restante do thread atual ou a todos os threads futuros.
Aprovar uma solicitação única
Quando o Genie Code solicita permissão para usar uma ferramenta, clique em **Permitir** para aprovar a ação ou em **Ignorar** para recusá-la.
Para alterar como o Genie Code lida com futuras solicitações de aprovação no tópico atual, selecione uma das seguintes opções a partir do mesmo prompt:
Opção | Comportamento |
|---|---|
Pergunte sempre | O Genie Code pede aprovação sempre que usa uma ferramenta. Este é o default. |
Permitir no thread atual | O Genie Code pode usar a ferramenta solicitada para o restante do tópico atual sem perguntar. |
Sempre permitir | O Genie Code pode usar a ferramenta solicitada em cada tópico sem perguntar. |
Aprovação automática | O Genie Code aprova automaticamente as ações de ferramentas para o restante do tópico atual. Um classificador de AI analisa cada ação e bloqueia as arriscadas. (Recomendado.) |
Definir um modo de aprovação default
Para aplicar o mesmo modo de aprovação a todos os tópicos do Genie Code, defina um default nas configurações do Genie Code. Clique em no cabeçalho do painel do Genie Code para abrir as configurações.
Escolha uma das seguintes opções:
-
**Peça primeiro**: aprove cada ferramenta quando ela for executada. As substituições por ferramenta ainda se aplicam.
-
Aprovação automática : Um classificador de AI revisa cada ação proposta em relação à sua intenção declarada e aprova ou bloqueia cada uma, minimizando as aprovações manuais e bloqueando ações arriscadas.
A aprovação automática é um recurso de produtividade, e 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 as seguras. Não o utilize para impor requisitos de segurança, compliance ou controle de acesso. Mantenha a aprovação automática desativada ao trabalhar com dados de produção, workspaces sensíveis ou recursos compartilhados nos quais as consequências de uma aprovação incorreta são importantes. A responsabilidade pela revisão dos resultados do Genie Code continua sendo sua.
Quando a aprovação automática está ativada, o Genie Code geralmente permite operações de baixo risco, como consultas somente leitura, edições nos próprios arquivos e notebooks do workspace, gravações em tabelas de titularidade do usuário e execução de jobs ou pipelines já referenciados. Ele bloqueia qualquer coisa que possa ampliar o escopo ou afetar recursos compartilhados, como operações destrutivas, implantações em produção, alterações de permissões e segredos, chamadas externas a terceiros e operações arriscadas de controle de código-fonte, como force pushes.
Quando uma ação é bloqueada, o Genie Code recebe o motivo e se adapta, por exemplo, ao retentar com um escopo mais restrito.
Compartilhar um tópico de bate-papo
Você pode compartilhar conversas Genie Code com outros usuários, grupos ou entidades de serviço.
Para compartilhar uma conversa:
-
No painel Genie Code, clique em
História do tópico para abrir a história do chat. -
Passe o cursor sobre a conversa que deseja compartilhar e clique em
Cardápio de kebabs. -
Clique
Compartilhar . -
Na caixa de diálogo de compartilhamento, adicione os usuários, grupos ou entidade de serviço com os quais deseja compartilhar. Os destinatários recebem permissão para visualizar a conversa no chat. Consulte as ACLs do chat do Genie Code.
-
(Opcional) Marque a opção "E-mail para novos usuários" para enviar uma notificação email aos usuários recém-adicionados.
-
(Opcional) Para compartilhar um link direto para a conversa, clique aqui.
Copie o link na parte inferior da caixa de diálogo de compartilhamento. -
Clique em Adicionar para compartilhar a conversa.
Obtenha ajuda com o código
Obtenha ajuda com o código do Genie Code diretamente no seu Notebook. Genie Code oferece:
- Use Genie Code for ciência de dados para ajudá-lo a planejar e automatizar o fluxo de trabalho científico de dados em várias etapas.
- Autocompletar baseado emAI.
- Filtragem de dados com instruções em linguagem natural.
- Depuração de código com diagnóstico de erro .
- Correção rápida, 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 usuários devem sempre revisar qualquer código gerado pelo Genie Code antes de executá-lo, pois ele pode, às vezes, conter erros.
Para obter mais informações sobre como Genie Code pode ajudar com programação, consulte Obtenha ajuda com programação do Genie Code.
Código otimizado para o ambiente Databricks
O código gerado pelo Genie Code se destina a ser executado em um ambiente de compute do Databricks. É otimizado para criar código em linguagens de programação, frameworks e dialetos compatíveis com o Databricks. Não se destina a ser um assistente de programação de uso geral.
Genie Code costuma usar informações do recurso Databricks , como o site de documentação do Databricks ou a Base de Conhecimento, para melhor responder às dúvidas dos usuários. Ele funciona melhor quando a pergunta do usuário está relacionada a questões que podem ser respondidas com conhecimento da documentação do Databricks, Unity Catalog e do código do usuário no espaço de trabalho.
Obtenha respostas com base na documentação.
Genie Code pesquisa documentação do Databricks para responder às suas perguntas. Quando houver referência à documentação, você verá " Documentação pesquisada " na resposta. Você pode pedir ao Genie Code para citar suas fontes, e ele fornece links para páginas de documentação relevantes.
Dê feedback sobre as respostas do Genie Code.
Informe-nos se as respostas do Genie Code foram úteis ou não:
- Passe o mouse logo abaixo da resposta do Genie Code.
- Clique em Útil
ou Não útil 
botão.