Como um agente funciona

Um agente não fica trabalhando o tempo todo. Ele acorda quando algo pede a atenção dele, faz uma sessão de trabalho, chamada execução, e volta a esperar. Em cada execução ele segue as suas instruções, usa as habilidades e as ferramentas que você liberou e deixa o resultado na própria tarefa: um comentário, uma mudança de status, um pedido de aprovação ou novas tarefas.

O que acorda um agente e o que sai de cada execução.

Quando usar

• Para entender por que um agente começou (ou não começou) a trabalhar numa tarefa.
• Antes de ajustar a Política de execução de um agente.
• Para saber onde acompanhar o que cada agente fez.

Como fazer

1. Saber o que acorda o agente

Um agente acorda quando:

• Recebe uma tarefa. Ao ser escolhido como responsável, ele é acordado para começar.
• Alguém comenta ou o menciona. Um comentário numa tarefa dele, ou uma menção ao nome dele em outra tarefa, acorda o agente para responder.
• Uma tarefa que o bloqueava é concluída. Ele volta à tarefa que estava esperando.
• Uma rotina dispara. A rotina cria uma tarefa para ele, e isso conta como uma tarefa recebida.
• Chega a hora do intervalo, se o Heartbeat por intervalo estiver ligado (veja o passo 3).
• Alguém o aciona à mão, pelo botão de execução no topo da página do agente, ao lado de Atribuir Tarefa.

Um agente pausado não acorda: as tarefas continuam sendo atribuídas a ele, mas ficam paradas até alguém clicar em Retomar. Um agente que ainda espera a aprovação de contratação também não trabalha.

2. Entender a execução

Cada vez que acorda, o agente faz uma execução. Nela ele lê as Instruções dele, usa as Habilidades ligadas e só as Ferramentas que você liberou, e pode consultar os servidores MCP e as fontes de conhecimento que você permitiu. Tudo o que ele produz fica registrado na tarefa e na Atividade.

A aba Execuções da página do agente lista cada execução, com o motivo de ter acordado, a duração, o log e o custo. A que está em andamento aparece com o selo Ao vivo.

A aba Execuções. Na empresa da imagem a agente ainda não trabalhou, por isso a lista está vazia.

3. Ajustar a política de execução

Na aba Configuração do agente, a seção Política de execução define quando ele trabalha:

• Heartbeat por intervalo: acorda o agente sozinho de tempos em tempos (em Executar heartbeat a cada, em segundos), para conferir se há trabalho novo. Vem desligado. Ligue só quando o agente precisa olhar algo periodicamente; para trabalho em horário fixo, prefira uma rotina.
• Em Política de execução avançada:
  • Acordar sob demanda: deixa o agente ser acordado por tarefas, comentários e acionamentos. Vem ligado; desligado, ele só trabalha pelo intervalo.
  • Intervalo mínimo (s): o tempo mínimo entre duas execuções seguidas.
  • Máximo de execuções simultâneas: quantas execuções o agente pode ter ao mesmo tempo.
  • Continuar após parada por limite de turnos: quando uma execução para porque chegou ao limite de passos, agenda continuações automáticas, com Tentativas de continuação e Atraso da continuação (s).

Política de execução, com a parte avançada aberta.

Depois de mudar, clique em Salvar, no canto inferior direito da tela.

Detalhes que importam

• Cada execução tem custo. Quanto mais o agente acorda, mais ele gasta. Um intervalo curto no Heartbeat por intervalo gera execuções mesmo quando não há trabalho. Acompanhe em Custos.
• Ferramentas bloqueadas por padrão. Um agente só usa as ferramentas de plugin ligadas na aba Ferramentas dele. Veja Página do agente.
• Pausar cancela o que está em andamento. Ao pausar um agente, as execuções dele em curso são canceladas.
• Quem pode mudar. A aba Configuração do agente aparece para todos, mas só Proprietário e Administrador veem o conteúdo e editam.

Relacionado

• Criar um agente
• Página do agente
• Tarefas: o que acontece com a tarefa enquanto o agente trabalha.
• Execução isolada: onde o agente roda.

Vídeo em breve

Do pedido ao resultado: um agente trabalhando

Duração prevista: ~4 min

O que o vídeo vai mostrar

1. Criar uma tarefa e escolher um agente como responsável.
2. Abrir a página do agente e ver a execução aparecer como Ao vivo na aba Execuções.
3. Abrir a execução e acompanhar o log.
4. Voltar à tarefa e ler o comentário e o novo status deixados pelo agente.
5. Mostrar a Política de execução na aba Configuração.