Tarefa do Código Génio para empregos

Use a tarefa Código Genie para executar um agente autónomo como parte de um trabalho. Genie Code funciona com base num prompt em linguagem natural e é executado com aprovação automática.

O que a tarefa Genie Code faz

O tipo de tarefa Genie Code inicia uma nova conversa Genie Code com o seu pedido e gera uma resposta. O Código Génio lê dados, chama ferramentas e age conforme o seu comando sem necessidade de input ou aprovação adicional. Depois de a execução terminar, pode abrir o chat e continuar a interagir com o Genie Code.

Use uma tarefa Genie Code quando quiser automatizar análises complexas, operações de dados ou tomada de decisões como parte de um trabalho agendado. Por exemplo:

• Resume os resultados do trabalho durante a noite e envie um relatório por email.
• Analisar os dados recebidos e assinalar anomalias.
• Investigue um ticket do Jira e proponha uma correção.
• Gere uma auditoria semanal de conformidade.

Requirements

• Os vossos espaços de trabalho devem ter acesso às capacidades agentivas do Código Genie. Consulte Requisitos.
• A instrução da sua tarefa deve estar em conformidade com as políticas de utilização do Genie Code.

Configurar uma tarefa do Genie Code

Para adicionar uma tarefa do Código Génio:

1. Navegue para o separador Tarefas na UI de Trabalhos.
2. Adicionar tarefa.
3. Insira um nome no campo Nome da tarefa .
4. No menu suspenso do Tipo , selecione Genie Code.

Configurar o pedido

Introduza um prompt em linguagem natural no campo Prompt . O prompt descreve o que quer que o agente faça quando a tarefa é executada. Por exemplo:

Check the most recent results in the batch_errors table. If error_count is above 5, create a summary of the errors by type and severity, then post a summary to #data-ops Slack channel.

(Opcional) Utilize parâmetros e valores dinâmicos no prompt

Para reutilizar um prompt entre execuções com valores diferentes, refira os valores no prompt com chavetas duplas ({{ }}). Quando a tarefa é executada, o Azure Databricks substitui cada referência pelo seu valor. O prompt suporta:

• Parâmetros do trabalho: {{name}}, onde name é a chave do parâmetro do trabalho. Defina os parâmetros da tarefa na tarefa, usando Editar parâmetros na barra lateral Detalhes da tarefa. Consulte a seção Configuração dos parâmetros de trabalho.
• Referências de valores dinâmicos: por exemplo, {{job.id}}, {{job.start_time.iso_date}}, um valor definido por uma tarefa a montante com {{tasks.<task_name>.values.<key>}}, ou a entrada atual da tarefa Para cada com {{input}}. Ver Referências de valores dinâmicos.

Por exemplo, com um parâmetro da tarefa denominado region e uma tarefa ascendente denominada ingest que define o valor da tarefa como table:

Summarize yesterday's sales in {{tasks.ingest.values.table}} for {{region}} and flag anomalies.

Como as referências são tratadas:

• Uma referência que a tarefa não pode usar está listada num aviso sob o prompt e deixada tal como foi escrita, por exemplo {{input}} , fora de uma tarefa For each, uma referência a uma tarefa que não está a montante desta tarefa, ou um nome de tarefa que deve ser escapado com backticks.
• Um {{name}} marcador de posição sem parâmetro de trabalho correspondente permanece inalterado.
• Se um valor dinâmico não puder ser resolvido quando o trabalho é executado, por exemplo um valor de tarefa que a tarefa a montante não definiu, a tarefa falha antes de começar.

Finalizar a configuração do trabalho

1. (Opcional) Para configurar novas tentativas, limiares de duração da execução ou de backlog de streaming, ou notificações, consulte Definições avançadas da tarefa.
2. Clique em Salvar tarefa.

Para editar, clonar, desativar ou eliminar esta tarefa, consulte Configurar e editar tarefas em Lakeflow Jobs.

Como funcionam as tarefas do Código Genie

Execução autónoma com aprovação automática

Quando uma tarefa Código Genie é executada, o agente executa o seu prompt de forma autónoma. A aprovação automática está sempre ativa para as tarefas do trabalho, pelo que não precisa de confirmar chamadas à ferramenta durante a execução. O agente usa um classificador de IA para verificar cada ação com o seu prompt e bloqueia operações arriscadas que estejam fora do âmbito pretendido.

Para compreender como funciona a auto-aprovação e os seus limites, veja Aprovar ações da ferramenta.

Leitura dos resultados de tarefas anteriores

O agente pode ler os resultados das tarefas a montante no mesmo trabalho como parte do seu trabalho. Descreva no seu prompt os dados de origem que pretende que ele utilize, e o agente obtém os resultados relevantes das tarefas durante a execução.

Definições do Código Genie e ligações MCP

A tarefa herda as definições do Código Genie e quaisquer ligações personalizadas ao Model Context Protocol (MCP) que tenha configurado. O agente tem acesso às mesmas ferramentas e fontes de dados que usarias numa sessão interativa do Código Génio.

Output

Cada execução de uma tarefa produz uma conversa do Genie Code que pode ser continuada. Quando a tarefa termina, o Resultado da execução mostra uma ligação para a conversa, o pedido da tarefa e a resposta do agente. Para uma execução bem-sucedida, a resposta final mostra a mensagem final do agente. Se a mensagem for muito longa, a saída da execução mostra a primeira parte e a conversa mantém o texto completo. Clique em Abrir conversa para rever o que o agente fez, fazer perguntas de seguimento ou continuar o trabalho de forma interativa.

Uma tarefa a jusante pode usar a resposta final de uma execução bem-sucedida com a referência {{tasks.<task_name>.output.response}}de valor dinâmico , por exemplo, num parâmetro de tarefa, numa condição If/else ou no prompt de outra tarefa do Código Genie. Ver Referências de valores dinâmicos.

Limitations

• A aprovação automática não pode ser desativada: As tarefas do trabalho são sempre executadas com a aprovação automática ativada. Não pode desligá-lo nem rever as ações antes de serem executadas.
• Apenas na IU de Jobs: Para adicionar uma tarefa do Genie Code a um job, use a IU de Jobs. Definir uma tarefa Genie Code em Declarative Automation Bundles, na API Jobs ou nos SDKs Databricks não é suportado.

Recursos adicionais

• Configurar e editar tarefas em Lakeflow Jobs: Configurar e editar tarefas em Lakeflow Jobs.
• Funcionalidades e capacidades do Código Genie: Aprenda a usar o Código Genie em geral.
• Tarefas agendadas do Código Genio: Programar os prompts do Código Genie para serem executados de forma recorrente. Uma tarefa agendada é executada de forma interativa e cria uma conversa na tua lista de conversas, enquanto uma tarefa de job do Genie Code é executada como parte do fluxo de trabalho de um job.