Tarefa do Genie Code para trabalhos

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

O que a tarefa do Genie Code faz

O tipo de tarefa do Genie Code inicia um novo chat do Genie Code com o seu prompt e gera uma resposta. O Código Gênio lê dados, chama ferramentas e age conforme seu comando sem exigir entrada ou aprovação adicional. Depois que a execução terminar, você pode abrir o chat e continuar a interagir com o Genie Code.

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

• Resuma os resultados da tarefa da noite e envie um relatório por e-mail.
• Analise dados recebidos e sinalize anomalias.
• Investigue um ticket do Jira e proponha uma correção.
• Gere uma auditoria semanal de conformidade.

Requirements

• Seus espaços de trabalho devem ter acesso aos recursos agênticos do Genie Code. Confira os Requisitos
• O prompt da sua tarefa deve estar em conformidade com as políticas de uso do Genie Code.

Configurar uma tarefa do Genie Code

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

1. Navegue até a guia Tarefas na interface de usuário de tarefas.
2. Clique Adicionar tarefa.
3. Insira um nome no campo Nome da tarefa .
4. No menu suspenso Tipo, escolha Genie Code.

Configure o prompt

Insira um prompt em linguagem natural no campo Prompt . O prompt descreve o que você quer que o agente faça quando a tarefa for 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) Use os parâmetros e valores dinâmicos no prompt

Para reutilizar um prompt em execuções com valores diferentes, faça referência aos valores no prompt com chaves duplas ({{ }}). Quando a tarefa é executada, o Azure Databricks substitui cada referência por seu valor. O prompt oferece suporte a:

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

Por exemplo, com um parâmetro de trabalho nomeado region e uma tarefa a montante nomeada ingest que define o valor tableda tarefa :

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 é listada em um aviso sob o prompt e deixada como digitada, por exemplo {{input}}, fora de uma tarefa “For each”, uma referência a uma tarefa que não está a montante dessa 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 definir novas tentativas, limites de tempo de execução ou de backlog de streaming ou notificações, confira as configurações de tarefa Avançadas.
2. Clique em Salvar tarefa.

Para editar, clonar, desabilitar ou excluir essa tarefa, consulte Configurar e editar tarefas em Trabalhos do Lakeflow.

Como funcionam as tarefas do Código Gênio

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

Quando uma tarefa do Código Gênio é executada, o agente executa seu prompt de forma autônoma. A aprovação automática está sempre ativada para as tarefas de trabalho; portanto, você não confirma as chamadas de ferramentas durante a execução. O agente usa um classificador de IA para verificar cada ação em relação ao seu prompt e bloqueia operações arriscadas que estejam fora do escopo pretendido.

Para entender como a autoaprovação funciona e seus limites, veja Aprovar ações da ferramenta.

Lendo saídas de tarefas anteriores

O agente pode ler as saídas de tarefas anteriores no mesmo trabalho como parte de seu trabalho. Descreva no seu prompt os dados de etapas anteriores que você deseja utilizar, e o agente recuperará as saídas de tarefa relevantes durante a execução.

Configurações do Código Gênio e conexões MCP

A tarefa herda suas configurações do Código Genie e quaisquer conexões personalizadas do Model Context Protocol (MCP) que você tenha configurado. O agente tem acesso às mesmas ferramentas e fontes de dados que você usaria em uma sessão interativa do Código Gênio.

Saída

Cada execução de tarefa gera um tópico de conversa do Genie Code que pode ser continuado. Quando a tarefa é concluída, a Run output exibe um link para a conversa, o prompt 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 revisar o que o agente fez, fazer perguntas de acompanhamento 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, em um parâmetro de tarefa, uma condição If/else ou o prompt de outra tarefa do Código Genie. Consulte referências de valor dinâmico.

Limitações

• A aprovação automática não pode ser desativada: Tarefas de trabalho sempre rodam com a aprovação automática ativada. Você não pode desligar ou revisar ações antes que sejam executadas.

Recursos adicionais

• Configurar e editar tarefas em Trabalhos Lakeflow: Configurar e editar tarefas em Trabalhos Lakeflow.
• Recursos e capacidades do Código Genie: Aprenda a usar o Código Genie em geral.
• Tarefas agendadas do Código Gênio: Programe os prompts do Código Gênio para serem executados de forma recorrente. Uma tarefa agendada é executada de forma interativa e cria uma conversa na sua lista de chats, enquanto uma tarefa de execução do Genie Code é executada como parte de um fluxo de trabalho.