O Data Agent permite gerar, otimizar, explicar e testar códigos SQL e Python por meio de linguagem natural. Acesse-o pelo editor de código ou pelo modo Ask do Data Agent Chat.
Visão geral
O Data Agent utiliza um large language model (LLM) para oferecer suporte inteligente à programação em SQL e Python para desenvolvedores de dados. Ele disponibiliza dois métodos de interação: o editor de código, com conclusão de código em tempo real e atalhos no menu de contexto, e o Data Agent Chat (modo Ask), para perguntas e respostas em formato de conversa. As principais capacidades incluem geração, refatoração, depuração, otimização, explicação, criação de comentários, testes, Code Q&A, geração inteligente de células de Notebook e busca rápida de tabelas entre engines. Para aumentar a precisão, adicione contextos como tabelas, nós, Data Collections, Rules ou arquivos locais e alterne entre diferentes large language models. O Data Agent funciona imediatamente, sem exigir conhecimentos avançados de programação, aumentando a eficiência na modelagem de dados, no desenvolvimento de ETL e na depuração.
Acesso
Editor de código
Caso de uso 1: Conclusão inteligente de código
Como usar: Ao escrever código em um nó, o Data Agent prevê e sugere trechos com base no contexto, como o código existente e as estruturas das tabelas referenciadas. As sugestões aparecem automaticamente. Pressione Tab para aceitar uma sugestão.
Caso de uso 2: Atalhos no menu de contexto
Como usar: No editor de código, selecione o código desejado, clique com o botão direito e escolha Copilot no menu de contexto.
Data Agent Chat (modo Ask)
O modo Ask é o padrão do Data Agent Chat e resolve problemas específicos de codificação em formato de perguntas e respostas. Ele oferece suporte a geração, refatoração, depuração, criação de comentários, explicação, otimização, testes, Code Q&A, geração inteligente de células de Notebook e busca rápida de tabelas. Selecione trechos de código no editor para fornecer contexto às suas solicitações.
Início rápido
Siga estas etapas para começar a usar o Data Agent Chat (modo Ask).
Etapa 1: Abra o Data Agent Chat (modo Ask)
Faça login no console do DataWorks. No painel de navegação à esquerda, escolha . Selecione o workspace desejado e clique em para entrar no Data Studio.
Clique em no ícone
no canto superior direito da página do Data Studio para abrir o Data Agent Chat (modo Ask).
Etapa 2: Adicionar contexto (opcional)
Adicione contexto para ajudar o Data Agent a compreender melhor sua solicitação. Insira @ na caixa de diálogo ou clique em no ícone @ no canto inferior direito para abrir o menu de contexto e selecione um tipo de contexto.
Há suporte aos seguintes tipos de contexto:
Table: Referencie metadados de uma ou mais tabelas.
Node/Code file: Referencie o código dentro de um nó específico.
Data collection: Referencie uma Data Collection do Data Map.
Rules: Aplique temporariamente uma ou mais regras à conversa atual.
Local file: Carregue um documento local como contexto.
Etapa 3: Alternar o large language model (opcional)
O Data Agent utiliza o modelo padrão. Clique em no ícone 
na parte inferior da caixa de diálogo para selecionar um large language model diferente.
Etapa 4: Enviar uma pergunta e participar de conversas com múltiplas interações
Insira sua solicitação na caixa de diálogo. Faça perguntas complementares ou forneça detalhes adicionais em uma conversa com múltiplas interações para refinar sua intenção até que o Data Agent produza os resultados esperados.
Detalhes dos recursos
O Data Agent Chat (modo Ask) gera códigos SQL e Python por meio de linguagem natural e oferece conclusão, refatoração, otimização, explicação, depuração e geração de casos de teste. As principais capacidades incluem:
|
Capacidade |
Descrição |
Exemplo (comandos para o Data Agent) |
|
Gera código com base nas suas instruções. |
"Escreva uma consulta SQL para encontrar os três principais produtos por valor de vendas para cada cidade na tabela |
|
|
Reescreve o código especificado conforme necessário. |
"Reescreva este SQL que usa |
|
|
Encontra e corrige erros no código especificado. |
"Este SQL gera um erro |
|
|
Gera comentários para o código especificado. |
"Adicione comentários em chinês a esta lógica SQL complexa para explicar a finalidade de cada CTE." |
|
|
Explica o código especificado. |
"Explique o que significam |
|
|
Otimiza o código especificado. |
"Esta consulta está lenta. Ajude-me a otimizá-la e identifique gargalos de desempenho." |
|
|
Fornece um plano de testes para o código especificado. |
"Crie casos de teste para este SQL que calcula taxas de retenção de usuários. Quais edge cases devem ser considerados?" |
|
|
Responde a perguntas sobre sintaxe de código, funções e outros tópicos. |
"Qual é a diferença entre a função |
|
|
Gera inteligentemente uma célula de código em um notebook. |
"Crie uma célula que use pandas para ler o arquivo |
|
|
Busca tabelas-alvo por palavras-chave. |
"Encontre todas as tabelas relacionadas a 'user'." |
Geração de código / Geração de SQL
Descrição: Gera código a partir de instruções em linguagem natural.
Como usar: Há suporte a dois métodos:
No editor de código, clique com o botão direito em uma área em branco e escolha para abrir a interface do Data Agent. Em seguida, insira uma solicitação em linguagem natural para que o large language model retorne o código desejado.
No editor de código, clique em no ícone
no canto superior direito da página do Data Studio para abrir o Data Agent Chat (modo Ask). Na caixa de entrada, insira /e selecione Code generation. Depois, insira uma solicitação em linguagem natural para que o large language model retorne o código desejado.
Refatoração de código / Reescrita de SQL
Descrição: Reescreve o código especificado com base nos seus requisitos.
Como usar: Há suporte a dois métodos:
No editor de código, selecione o código-alvo, clique com o botão direito em uma área em branco e escolha para abrir a interface do Data Agent. Em seguida, insira seus requisitos de reescrita.
No editor de código, selecione o código-alvo, insira
/na caixa de entrada do Data Agent Chat (modo Ask), selecione Code rewriting, insira seus requisitos de reescrita e clique em Send. Aguarde o Data Agent retornar os resultados.
Depuração de código / Correção de SQL
Descrição: Encontra e corrige erros em trechos de código especificados.
Como usar: Há suporte a dois métodos:
No editor de código, selecione o código-alvo, clique com o botão direito em uma área em branco e escolha para abrir a interface do Data Agent.
No editor de código, selecione o código-alvo, insira
/na caixa de entrada do Data Agent Chat (modo Ask), selecione Code Error correction e clique em Send. Aguarde o Data Agent retornar os resultados.
Geração de comentários
Descrição: Gera comentários para conteúdo SQL especificado visando melhorar a legibilidade.
Como usar: Há suporte a dois métodos:
No editor de código, selecione o código-alvo, clique com o botão direito em uma área em branco e escolha para abrir a interface do Data Agent.
No editor de código, selecione o código-alvo, insira
/na caixa de entrada do Data Agent Chat (modo Ask), selecione Generate Comments e clique em Send. Aguarde o Data Agent retornar os resultados.
Explicação de código
Descrição: Explica conteúdo SQL especificado para melhorar a legibilidade.
Como usar: No editor de código, selecione o código-alvo, insira / na caixa de entrada do Data Agent Chat (modo Ask), selecione Code interpretation e clique em Send. Aguarde o Data Agent retornar os resultados.
Otimização de código
Descrição: Otimiza o código SQL selecionado para simplificar a lógica, melhorar a eficiência de execução e reduzir a carga do banco de dados.
Como usar: No editor de código, selecione o código-alvo, insira / na caixa de entrada do Data Agent Chat (modo Ask), selecione Code Optimization e clique em Send. Aguarde o Data Agent retornar os resultados.
Teste de código
Descrição: Gera um plano de testes e código de teste para o SQL selecionado, a fim de verificar se cada parte funciona conforme o esperado.
Como usar: No editor de código, selecione o código-alvo, insira / na caixa de entrada do Data Agent Chat (modo Ask), selecione Code Testing e clique em Send. Aguarde o Data Agent retornar os resultados.
Code Q&A
Descrição: Explica sintaxe SQL ou funções do MaxCompute e fornece exemplos de uso.
Como usar: No Data Agent Chat (modo Ask), insira sua pergunta na caixa de entrada e clique em Send. Aguarde o Data Agent retornar os resultados.
Geração inteligente de célula de Notebook
Descrição: Gera uma célula de notebook a partir de palavras-chave.
Como usar: No Data Agent Chat (modo Ask), insira / na caixa de entrada e selecione Intelligent Notebook Cell Generation. Em seguida, insira palavras-chave na janela de edição e clique em Send. O Data Agent gera o nó de notebook correspondente.
Busca rápida de tabelas
Descrição: Busca tabelas-alvo em todas as engines de computação e fontes de dados por palavra-chave.
Como usar: No Data Agent Chat (modo Ask), insira / na caixa de entrada e selecione Quick Find Table. Depois, insira palavras-chave na janela de edição e clique em Send. O Data Agent retorna tabelas que correspondem às palavras-chave em todas as engines de computação e fontes de dados associadas.