Pular para o conteúdo principal
Última atualização em

Tarefa do Genie Code para jobs

Use a tarefa do Genie Code para executar um agente autônomo como parte de um job. O Genie Code funciona a partir de um prompt em linguagem natural e é executado com aprovação automática.

O que a tarefa do Genie Code faz​

O tipo de tarefa Genie Code inicia um novo chat do Genie Code com seu prompt e produz uma resposta. O Genie Code lê dados, chama ferramentas e age conforme seu prompt sem exigir entrada ou aprovação adicional. Após a conclusão da execução, você pode abrir o chat e continuar a interagir com o Genie Code.

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

  • Resuma os resultados do job noturno e envie um relatório por email.
  • Analise os dados recebidos e sinalize anomalias.
  • Investigue um ticket do Jira e proponha uma correção.
  • Gerar uma auditoria de compliance semanal.

Requisitos​

  • Seus workspaces devem ter acesso às capacidades agentic do Genie Code. Consulte 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​

nota

A interface de jobs exibe opções dinamicamente com base em outras configurações definidas.

Para adicionar uma tarefa do Genie Code:

  1. Navegue até a tab Tarefas na interface do usuário de jobs.
  2. Clique em Ícone de mais. Adicionar tarefa .
  3. Insira um nome no campo Nome da tarefa .
  4. No menu suspenso Tipo , selecione Genie Code.

Configurar o prompt​

Insira um prompt em linguagem natural no campo Prompt . O prompt descreve o que você deseja 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) Usar 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 Databricks substitui cada referência pelo seu valor. O prompt suporta:

  • Parâmetros do job : {{name}}, em que name é a key do parâmetro do job. Defina os parâmetros do job no job, usando Editar parâmetros na barra lateral Detalhes do job . Veja Configurar parâmetros de job.
  • Referências de valor dinâmico : 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 uma tarefa For each com {{input}}. Veja Referências de valor dinâmico.

Por exemplo, com um parâmetro de job chamado region e uma tarefa upstream chamada ingest que define o valor da tarefa table:

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

Como as referências são manipuladas:

  • 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 Para cada, uma referência a uma tarefa que não é upstream desta tarefa ou um nome de tarefa que deve ser escapado com crases.
  • Um placeholder {{name}} sem nenhum parâmetro de job correspondente permanece inalterado.
  • Se um valor dinâmico não puder ser resolvido quando o job for execução, por exemplo, um valor de tarefa que a tarefa upstream não definiu, a tarefa falhará antes de começar.

Finalizar configuração do job​

  1. (Opcional) Para configurar tentativas, limites de duração de execução ou de backlog de transmissão, ou notificações, consulte Configurações avançadas de tarefa.
  2. Clique em Salvar tarefa .

Para editar, clonar, desativar ou excluir esta tarefa, consulte Configure and edit tasks in Lakeflow Jobs.

Como funcionam as tarefas de job do Genie Code​

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

Quando uma tarefa do Genie Code é executada, o agente executa seu prompt de forma autônoma. A aprovação automática está sempre ativada para tarefas de job, portanto, você não confirma chamadas de ferramenta durante a execução. O agente usa um classificador de AI para verificar cada ação em relação ao seu prompt e bloqueia operações arriscadas que estão fora do escopo pretendido.

Para entender como a aprovação automática funciona e seus limites, consulte Aprovar ações de ferramentas.

atenção

A aprovação automática é um recurso de produtividade, não um limite de segurança, e você não pode desativá-la para uma tarefa de job. Como a tarefa é executada sem supervisão, seja criterioso sobre quais dados de produção, workspaces confidenciais ou recursos compartilhados o prompt pode acessar.

Lendo saídas de tarefas upstream​

O agente pode ler as saídas de tarefas upstream no mesmo job como parte de seu trabalho. Descreva os dados upstream que você deseja que ele use em seu prompt, e o agente recupera as saídas de tarefas relevantes durante a execução.

Configurações do Genie Code e conexões MCP​

A tarefa herda suas configurações do Genie Code 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 Genie Code.

Saída​

Cada execução de tarefa gera um tópico de conversa do Genie Code que pode ser retomado. Quando a tarefa for concluída, o Resultado da execução exibirá um Link para a conversa, o prompt da tarefa e a resposta do agente. Para uma execução bem-sucedida, a Resposta final exibirá a mensagem final do agente. Se a mensagem for muito longa, a saída da execução exibirá a primeira parte, e a conversa manterá 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 downstream pode usar a resposta final de uma execução bem-sucedida com a referência de valor dinâmico {{tasks.<task_name>.output.response}}, por exemplo, em um parâmetro de tarefa, uma condição If/else ou um prompt de outra tarefa do Genie Code. Veja Referências de valores dinâmicos.

Limitações​

  • A aprovação automática não pode ser desativada : as tarefas de job sempre são executadas com a aprovação automática ativada. Você não pode desativá-la ou revisar as ações antes que elas sejam executadas.

Outros recursos​

Nesta página