Programar execuções de agentes

Pré-lançamento

Este recurso está sujeito aos "Termos da Oferta Pré-GA" na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis no estado em que se encontram e podem ter assistência limitada. Para mais informações, consulte as descrições das fases de lançamento.

É possível configurar o agente para executar tarefas automaticamente de forma recorrente. Uma programação serve como um gatilho automatizado para as instruções ou comandos predefinidos do agente.

Observação: os agentes programados são executados automaticamente para tarefas pessoais, como criar convites para a agenda ou enviar e-mails para você mesmo. No entanto, qualquer ação que envolva outras pessoas será pausada para sua análise e aprovação.

Adicionar uma programação de execução

Console

Para adicionar uma programação de execução ao seu agente, faça o seguinte:

1. Abra o agente no modo de edição.
2. Na tela do Agent Designer, clique na guia Programação.

3. Clique em + Adicionar programação e configure a recorrência e o horário de execução:

   1. Frequência de repetição:selecione a frequência com que o agente deve ser executado para executar o comando fornecido. As seguintes opções estão disponíveis:

      • Por hora:executa a tarefa a cada número especificado de horas e em um minuto específico dentro dessa hora.
      • Diária:executa a tarefa uma vez por dia no horário especificado.
      • Semanal:executa a tarefa uma vez por semana no dia e horário especificados.
      • Mensal:executa a tarefa uma vez por mês no dia e horário especificados.
      • Anual:executa a tarefa uma vez por ano no mês, dia e horário especificados.

   2. Horário e fuso horário de execução:defina as configurações de intervalo específicas com base na frequência selecionada e escolha o fuso horário de execução.

   3. Comando:insira o comando ou a instrução específica que o agente vai receber no horário programado. Isso define a tarefa que o agente vai executar.

4. Clique em Salvar para criar a programação e adicioná-la ao seu agente no estado Rascunho.

5. Opcional: teste sua programação para verificar se ela funciona conforme o esperado.

6. Para ativar a programação e reiniciar o agente com as mudanças atualizadas, clique em Atualizar.

Testar a programação de execução

Depois de configurar uma programação, você pode testar imediatamente a execução do agente para garantir que ele realize a tarefa conforme o esperado sem esperar o próximo intervalo programado.

Console

Para testar a programação de execução, faça o seguinte:

1. Na tela do Agent Designer, clique na guia Programação.

2. Encontre o card de programação que você quer testar e clique em Executar na prévia.

   Isso aciona o agente usando o comando e a configuração salvos.

Editar uma programação de execução

Edite uma programação de execução para fazer mudanças na frequência, no horário, no fuso horário ou no comando.

Console

Para editar uma execução programada, faça o seguinte:

1. Na tela do Agent Designer, clique na guia Programação.
2. Encontre o card de programação que você quer testar e clique em Editar.
3. Modifique a Frequência de repetição, o Tempo de execução, o Fuso horário e o Comando conforme selecionado.
4. Clique em Salvar.
5. Clique em Atualizar para garantir que todas as mudanças, incluindo a nova programação, sejam salvas e aplicadas ao agente.

Excluir uma programação de execução

Se uma tarefa recorrente não for mais necessária, exclua e remova da lista Programações do agente.

Console

Para excluir uma programação de execução, faça o seguinte:

1. Na tela do Agent Designer, clique na guia Programação.
2. Encontre o card de programação que você quer testar e clique em Excluir.
3. Confirme a exclusão para remover permanentemente a programação de execução do seu agente.

Atualizar programações de agentes

Os programadores de agentes operam usando suas credenciais de usuário. Para garantir a privacidade e a segurança dos dados, essas credenciais expiram a cada 14 dias. É preciso atualizar manualmente os agendamentos de agentes para garantir que eles continuem sendo executados automaticamente sem interrupção.

Console

Para atualizar as programações de todos os agentes, faça o seguinte:

1. Abra o app Gemini Enterprise e acesse a página Galeria de agentes.

2. Realize uma das seguintes ações para atualizar seus agendamentos:

   • Acesse a seção Seus agentes e clique em event_repeat (Atualizar os agendamentos atuais).

   • Abra um agente no modo de edição e faça o seguinte:

     1. Na tela do Agent Designer, clique na guia Programação.
     2. Clique em Atualizar programações.

Suas credenciais de usuário são atualizadas, e todos os agentes programados continuam sendo executados por mais 14 dias.

Conferir e aprovar execuções programadas

Todas as execuções programadas, incluindo as que aguardam aprovação, são listadas no histórico de chat.

Console

Para ver e aprovar execuções programadas, faça o seguinte:

1. Abra o app Gemini Enterprise e acesse a seção Conversas no menu de navegação.
2. Encontre e abra a conversa correspondente ao agente programado.
3. Se a execução programada estiver pausada, revise a ação proposta e clique em Aprovar para concluir a tarefa.

Limitações

• É necessário atualizar manualmente as programações a cada 14 dias para evitar falhas nos agentes programados.
• Pode haver um atraso máximo de 5 minutos na execução da programação do agente.
• Os programações são compatíveis apenas com locais multirregionais.

A seguir

• Saiba como editar seu agente.
• Saiba como excluir seu agente.