Tarefa do Código Gênio 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.

Overview

O tipo de tarefa Genie Code inicia um novo chat do Genie Code a partir do 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) Configurar parâmetros

Para reutilizar um prompt em várias execuções com valores diferentes, faça referência a parâmetros da tarefa no prompt. Os parâmetros do job são repassados automaticamente à tarefa, portanto você não configura parâmetros na própria tarefa.

1. Defina parâmetros da tarefa como pares chave-valor na tarefa, usando Editar parâmetros na barra lateral Detalhes da tarefa. Consulte Configurar parâmetros do trabalho.
2. No prompt, referenciar um parâmetro com {{name}}, onde name é a chave do parâmetro do trabalho.

Por exemplo, com um parâmetro de trabalho chamado region:

Summarize yesterday's sales for {{region}} and flag anomalies.

Quando a tarefa é executada, o Azure Databricks substitui cada {{name}} marcador pelo valor do parâmetro. Um marcador sem parâmetro correspondente permanece inalterado. O valor de um parâmetro de trabalho pode ser um valor estático ou uma referência dinâmica, como o valor de uma tarefa a montante. Consulte referências de valor dinâmico.

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 tarefas de trabalho, então você não confirma chamadas de ferramenta 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 as saídas das tarefas anteriores

O agente pode ler as saídas de tarefas anteriores no mesmo trabalho como parte de seu trabalho. Descreva os dados upstream que deseja que ele use no prompt, e o agente recupera as saídas relevantes da tarefa 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 saída Run exibe um link para a conversa, o prompt da tarefa e a resposta mais recente. Clique no link para abrir o tópico e revisar o que o agente fez, faça perguntas de acompanhamento ou continue o trabalho de forma interativa.

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.
• Use o Código Gênio: Aprenda a usar o Código Gênio 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.