Configurar Tarefas

Esta seção aborda a criação e a configuração de tarefas.

Tópicos:

Sobre Tarefas

As tarefas são blocos de código curtos e funcionais que você pode juntar em um fluxo como parte do trabalho ou promover para os próprios trabalhos.

As tarefas são os principais blocos de construção de todos os fluxos de trabalho no Oracle AI Data Platform. O tipo de tarefa determina o tipo de código que ela utiliza. Como parte de um job, você conecta tarefas para determinar sua sequência e prioridade quando o job é executado.

Tipo de tarefa Descrição
Tarefa de notebook Uma tarefa que foi salva em um notebook que você pode acessar
Tarefa Python Uma tarefa usando um trecho de código da linguagem de programação Python
Condição If/else Uma tarefa que usa condições if/else
Tarefa de tarefa aninhada Uma tarefa que usa um job existente e suas tarefas como uma tarefa aninhada
Tarefa Jar Uma tarefa que pode executar código Scala ou Java compilado em arquivos JAR (Java Archive).
Tarefa do agente Uma tarefa que chama um agente implantado como parte de um job de workflow.

Quando você tem mais de uma tarefa, é possível criar conjuntos de dependências de tarefa em que o sucesso ou a falha de uma tarefa pode acionar tarefas subsequentes em sequência. Você só pode criar dependências em jobs que tenham mais de uma tarefa. Consulte Criar uma Tarefa de Notebook.

As tarefas podem ser executadas em paralelo. É possível fazer isso tornando duas ou mais tarefas dependentes do sucesso ou da falha de outra tarefa no mesmo fluxo de trabalho, fazendo com que elas sejam executadas ao mesmo tempo.

As tarefas podem falhar devido a problemas transitórios, como interrupções na rede, indisponibilidade de recursos ou falhas temporárias no serviço. Nesses casos, a Plataforma de Dados de IA repete automaticamente a tarefa com base nas políticas de repetição configuradas quando a tarefa é criada. Como parte dessas políticas, você define:

  • Contagem de Repetições: O número máximo de tentativas de repetição.
  • Intervalo de Repetição: O tempo de espera entre novas tentativas.

Além das repetições de tarefas padrão, a Plataforma de Dados de IA também oferece suporte a Repetir no timeout. Se uma tarefa exceder seu limite de tempo de execução devido a restrições de recursos ou processamento lento e você quiser tentar novamente apenas para esses cenários, poderá optar por acionar automaticamente uma nova tentativa. Essas políticas de repetição aumentam a resiliência do fluxo de trabalho, garantindo que as tarefas tenham uma chance maior de execução bem-sucedida sem intervenção manual.

Profissionais de saúde Git como origem da tarefa (visualização)

Você pode selecionar Provedor de Git como origem para tarefas de Notebook e Python. Depois de selecionar Provedor de Git como sua origem, você precisará fornecer a localização relativa do arquivo, o provedor de Git (GitHub, Bitbucket, GitLab), suas credenciais e o URL e a ramificação do repositório. Para poder selecionar suas credenciais, você precisa ter vinculado uma conta Git à sua Plataforma de Dados de IA. Para obter mais informações, consulte Contas Vinculadas do Git (Visualização).

Observação:

Ao usar o Provedor Git como sua origem, o Local do Arquivo é o caminho relativo da raiz do repositório. Por exemplo, /GitDemo/01_GitSourceFile.ipynb.

Quando e Como Usar Logs de Computação

Verifique seus logs de computação se sua tarefa falhar com erros relacionados a recursos ou sistema, como erros de falta de memória ou uso da CPU excedendo os limites.

Revise os logs do Spark se você vir longos tempos de espera, novas tentativas inesperadas ou gargalos de desempenho do job. Esses logs fornecem informações sobre o driver e os nós de trabalho do cluster de computação que respaldam sua tarefa e podem ajudar a identificar a origem de possíveis problemas.

Para obter orientação sobre como verificar seus logs, consulte Monitorar uma Execução de Job Específica.

Você deve ter a permissão RBAC no nível de computação apropriada para exibir metadados e logs da instância de computação associada ao job. Entre em contato com o administrador para obter essas permissões caso não consiga exibir logs de computação. Para obter mais informações sobre Sobre Permissões.

Criar uma Tarefa Python

Você pode criar uma tarefa como parte do job de workflow que usa script Python.

  1. Na Home page, clique em Workflow.
  2. Clique no job para o qual deseja fazer uma tarefa.
  3. Clique em Adicionar tarefa.
  4. Informe um nome de tarefa.
  5. Para Tipo de tarefa, selecione Python.
  6. Escolha uma Origem:
    • Para Espaço de Trabalho, clique em Procurar e navegue até o script Python que você deseja adicionar como tarefa. Clique em Selecionar.
    • Para Provedor Git:
      1. Forneça a Localização do arquivo relativa.
      2. Selecione seu provedor de Git e sua credencial de Git nos menus suspensos.
      3. Forneça o URL do repositório Git e a ramificação Git.
  7. Selecione um cluster de computação para a tarefa Python, se ainda não houver um anexado.
  8. Selecione o número de novas tentativas que uma tarefa deve tentar em caso de falha. Se você selecionar mais de 0, também deverá especificar quanto tempo a execução do job deverá aguardar entre as novas tentativas e se as novas tentativas deverão ser feitas no tempo limite.

    Opções de repetição de tarefa quando o número de repetições for 1 ou maior

  9. Em Depende de, selecione todas as tarefas das quais você deseja tornar essa tarefa dependente. Selecione a resposta condicional a essa dependência na lista suspensa Executar se.
  10. Adicione parâmetros adicionais fornecendo suas Chave e Valor. Clique em Adicionar parâmetro para fornecer vários parâmetros.

Criar uma Tarefa de Notebook

Você cria tarefas usando notebooks que criou na sua Oracle AI Data Platform.

  1. Na Home page, clique em Workflow.
  2. Clique no job para o qual deseja fazer uma tarefa.
  3. Clique em Adicionar tarefa.
  4. Informe um nome de tarefa.
  5. Para Tipo de tarefa, selecione Livro de Notas.
  6. Escolha uma Origem:
    • Para Espaço de Trabalho, clique em Procurar e navegue até o script Python que você deseja adicionar como tarefa. Clique em Selecionar.
    • Para Provedor Git:
      1. Forneça a Localização do arquivo relativa.
      2. Selecione seu provedor de Git e sua credencial de Git nos menus suspensos.
      3. Forneça o URL do repositório Git e a ramificação Git.
  7. Selecione um cluster de computação para a tarefa de notebook, se ainda não houver um anexado.
  8. Selecione o número de novas tentativas que uma tarefa deve tentar em caso de falha. Se você selecionar mais de 0, também deverá especificar quanto tempo a execução do job deverá aguardar entre as novas tentativas e se as novas tentativas deverão ser feitas no tempo limite.

    Opções de repetição de tarefa quando o número de repetições for 1 ou maior

  9. Em Depende de, selecione todas as tarefas das quais você deseja tornar essa tarefa dependente. Selecione a resposta condicional a essa dependência na lista suspensa Executar se.
  10. Adicione parâmetros adicionais fornecendo suas Chave e Valor. Clique em Adicionar parâmetro para fornecer vários parâmetros.

Criar uma Tarefa de Job Aninhada

Você pode usar outro job de workflow e suas tarefas contidas como uma tarefa aninhada em outro workflow.

  1. Na Home page, clique em Workflow.
  2. Clique no job para o qual deseja fazer uma tarefa.
  3. Clique em Adicionar tarefa.
  4. Informe um nome de tarefa.
  5. Para Tipo de tarefa, selecione Tarefa de tarefa aninhada.
  6. Na lista drop-down Jobs, selecione um job existente do qual você deseja fazer uma tarefa.
  7. Selecione o número de novas tentativas que uma tarefa deve tentar em caso de falha. Se você selecionar mais de 0, também deverá especificar quanto tempo a execução do job deverá aguardar entre as novas tentativas e se as novas tentativas deverão ser feitas no tempo limite.

    Opções de repetição de tarefa quando o número de repetições for 1 ou maior

  8. Em Depende de, selecione todas as tarefas das quais você deseja tornar essa tarefa dependente. Selecione a resposta condicional a essa dependência na lista suspensa Executar se.
  9. Adicione parâmetros adicionais fornecendo suas Chave e Valor. Clique em Adicionar parâmetro para fornecer vários parâmetros.

Criar uma tarefa If/Else

Você pode criar uma tarefa que use condições if/else com base nos dados do catálogo para determinar se a tarefa é acionada.

  1. Na Home page, clique em Workflow.
  2. Clique no job para o qual deseja fazer uma tarefa.
  3. Clique em Adicionar tarefa.
  4. Informe um nome de tarefa.
  5. Para Tipo de tarefa, selecione Se/Outra.
  6. Informe as condições que determinam se a tarefa é acionada. Clique em Ícone de adição Adicionar para definir várias condições.
  7. Informe a expressão da condição.
  8. Selecione o número de novas tentativas que uma tarefa deve tentar em caso de falha. Se você selecionar mais de 0, também deverá especificar quanto tempo a execução do job deverá aguardar entre as novas tentativas e se as novas tentativas deverão ser feitas no tempo limite.

    Opções de repetição de tarefa quando o número de repetições for 1 ou maior

  9. Em Depende de, selecione todas as tarefas das quais você deseja tornar essa tarefa dependente. Selecione a resposta condicional a essa dependência na lista suspensa Executar se.
  10. Adicione parâmetros adicionais fornecendo suas Chave e Valor. Clique em Adicionar parâmetro para fornecer vários parâmetros.

Criar uma Tarefa Jar

Você pode criar tarefas que executam o código Scala ou Java compilado em arquivos JAR (Java Archive).

Observação:

Os arquivos de biblioteca dependentes devem usar versões do JDK, Scala ou Spark compatíveis com o runtime do cluster do Oracle AI Data Platform no momento da criação para evitar comportamento inesperado.
  1. Na Home page, clique em Workflow.
  2. Clique no job para o qual deseja fazer uma tarefa.
  3. Clique em Adicionar tarefa.
  4. Informe um nome de tarefa.
  5. Para Tipo de tarefa, selecione Tarefa JAR.
  6. Para Main class name, especifique o nome completo da classe que contém o método main que você deseja executar. Por exemplo, ProcessTransaction. Esta classe deve ser incluída em um dos arquivos adicionados como uma biblioteca dependente.
  7. Para Bibliotecas dependentes, clique em Adicionar.
  8. Selecione uma origem para seus arquivos de biblioteca dependentes. Pelo menos uma biblioteca que contenha o método de classe principal especificado acima deve ser incluída.
    • Para Espaço de Trabalho ou Volume, procure o espaço de trabalho ou volume da AI Data Platform, selecione o arquivo ou os arquivos que deseja adicionar como biblioteca e clique em Adicionar.
    • Para Fazer upload de arquivo no espaço de trabalho, procure na máquina local o(s) arquivo(s) a ser(em) carregado(s) como biblioteca e clique em Adicionar.
  9. Em argumentos de linha de comando, forneça argumentos delimitados por espaços em branco que você deseja passar para a classe principal.
  10. Selecione o número de novas tentativas que uma tarefa deve tentar em caso de falha. Se você selecionar mais de 0, também deverá especificar quanto tempo a execução do job deverá aguardar entre as novas tentativas e se as novas tentativas deverão ser feitas no tempo limite.

    Opções de repetição de tarefa quando o número de repetições for 1 ou maior

  11. Em Depende de, selecione todas as tarefas das quais você deseja tornar essa tarefa dependente. Selecione a resposta condicional a essa dependência na lista suspensa Executar se.
  12. Adicione parâmetros adicionais fornecendo suas Chave e Valor. Clique em Adicionar parâmetro para fornecer vários parâmetros.

Criar uma Tarefa do Agente

Você pode criar uma tarefa que envie um prompt para um agente implantado a partir de um job de workflow.

Antes de começar, implante o agente. A identidade usada para executar a tarefa deve ter permissão para chamar o ponto final do agente. Consulte Implantar um Agente e Chamar um Agente Implantado.

Observação:

Se você cancelar o workflow, a tarefa do agente não será cancelada. Isso significa que, se o agente já estiver em execução, ele continuará a fazê-lo mesmo que o workflow seja cancelado.
  1. Na Home page, clique em Workflow.
  2. Clique no job para o qual deseja fazer uma tarefa.
  3. Clique em Adicionar tarefa.
  4. Informe um nome de tarefa.
  5. Para Tipo de tarefa, selecione Tarefa do agente.
  6. Em Agente, selecione um agente implantado na lista.
  7. No Prompt do Agente, digite a mensagem a ser enviada ao agente. Você pode incluir referências de parâmetro de workflow para fornecer valores quando o job for executado.
  8. Selecione o número de novas tentativas que uma tarefa deve tentar em caso de falha. Se você selecionar mais de 0, também deverá especificar quanto tempo a execução do job deverá aguardar entre as novas tentativas e se as novas tentativas deverão ser feitas no tempo limite.
  9. Em Depende de, selecione todas as tarefas das quais você deseja tornar essa tarefa dependente. Selecione a resposta condicional a essa dependência na lista suspensa Executar se.
  10. Adicione parâmetros adicionais fornecendo suas Chave e Valor. Clique em Adicionar parâmetro para fornecer vários parâmetros.

Modificar uma Tarefa

Você pode alterar os atributos existentes de uma tarefa, como nome, tipo e parâmetros, para alterar como ela funciona no seu job.

  1. Na Home page, clique em Workflow.
  2. Clique no job para o qual deseja configurar tarefas.
  3. Na guia Tarefas, clique na tarefa que deseja editar.
  4. No painel Detalhes da Tarefa à direita, modifique os atributos da tarefa conforme necessário. As alterações são salvas automaticamente.

Exibir Logs de Tarefas

Você pode exibir os logs de execução de tarefas individuais em um job.

  1. Na Home page, clique em Workflows.
  2. Clique em Execuções de Jobs.
  3. Clique no job cujos logs de tarefa você deseja ver.
  4. Clique nos nós da tarefa para ver os logs dessa tarefa.

Excluir uma Tarefa

Você pode excluir uma tarefa removendo o nó da tarefa de um job.

  1. Na Home page, clique em Workflow.
  2. Clique no job do qual deseja excluir tarefas.
  3. No nó da tarefa, clique em Ações e, em seguida, clique em Remover nó.
  4. Clique em Excluir.