Depois de salvar o agente, entram em cena os botões que o colocam para funcionar: Validar com a Filipa, Ativar agente, Pausar, Retomar e Executar agora. Este artigo explica o que a validação faz por dentro (e por que ela é a etapa que mais evita erros), como ler o resultado, como resolver as pendências, o que muda em cada status e quando cada botão aparece. Ao final, você terá o agente ativo e saberá operá-lo no dia a dia.
Índice
Os botões flutuantes e quando aparecem
| Botão | Aparece quando | O que faz |
|---|---|---|
| Salvar | Formulário válido e com alterações | Grava o agente. Novo agente fica em Rascunho. |
| Validar com a Filipa (rosto da Filipa) | Descrição preenchida e sem alterações pendentes de salvar | Envia a descrição e o cadastro para a Filipa analisar e reescrever. |
| Ativar agente | Agente salvo, sem alterações, e não ativo | Registra o agendamento e muda para Ativo. |
| Pausar | Agente ativo | Remove o agendamento e muda para Pausado. |
| Retomar | Agente pausado | Volta o agendamento e muda para Ativo. |
| Executar agora | Agente ativo ou pausado | Enfileira uma execução imediata (gatilho Manual). |
| Histórico de execuções | Agente salvo, sem alterações | Abre o histórico filtrado por este agente. |
Sempre que você altera algo, Validar com a Filipa, Ativar agente e Histórico de execuções somem até salvar. Isso evita validar ou ativar um agente com uma instrução diferente da gravada. Pausar e Executar agora continuam disponíveis e agem sobre a versão gravada.
Validar com a Filipa
A validação é uma análise feita pela Filipa antes de o agente rodar sozinho. Ela recebe a sua descrição mais os dados do cadastro (nome, empresas, agendamento, entrega, destinatários e formato) e faz o seguinte:
Descobre os dados: consulta a estrutura de dados do Vendelo autorizada para o seu usuário e confirma que cada informação pedida existe e pode ser filtrada e ordenada como você quer. Ela não executa consultas de negócio nesta etapa; só verifica a estrutura.
Reescreve a descrição: produz uma instrução completa e sem ambiguidade para execução autônoma, com períodos relativos à data da execução, valores padrão explícitos para o que ficou aberto, e sem pedidos de envio (a entrega é do Vendelo).
Lista pendências: tudo o que precisaria ser perguntado a você e que o cadastro não define: critérios, limites, regras de desempate.
Conclui a viabilidade: marca como viável, ou como inviável quando os dados necessários não existem no Vendelo, explicando o motivo.
Ao terminar, a instrução reescrita substitui o texto do campo de descrição e aparece uma mensagem com o resumo da Filipa (em forma de aviso quando a tarefa for inviável). A validação também pode ajustar o formato de saída. Leia a instrução com atenção, ajuste o que quiser e salve.
Se a validação terminar com uma mensagem técnica do provedor dizendo que o modelo não é suportado (por exemplo, “model is not supported when using Codex with a ChatGPT account”), o modelo escolhido no agente não está disponível para o provedor configurado. Troque o Modelo do agente por um modelo homologado (gpt-5.6-luna ou superior, claude-sonnet-5 ou superior), salve e valide de novo. Modelos inferiores podem até constar da lista, mas não foram validados com a Filipa.
Lendo o resultado da validação
O bloco de validação aparece acima da descrição com o título Validação concluída (viável) ou Validação pendente (inviável ou com problemas). Ele traz:
- Resumo: uma frase em linguagem simples dizendo o que o agente vai entregar e quando. Exemplo: “Toda segunda às 8h você receberá uma planilha com as cotações que vencem na semana, por vendedor.”
- Pendências a resolver: lista de decisões que faltam. Exemplo: “Definir se cotações já em negociação devem ser incluídas”.
Quando a tarefa é inviável, o próprio resumo explica por que os dados do Vendelo não permitem executá-la.
Um agente com pendências ainda pode ser ativado: a instrução reescrita adota um padrão explícito para cada pendência. Mas o ideal é resolver as pendências no texto e validar de novo, para o resultado ser exatamente o que você quer.
Resolvendo pendências
Leia cada pendência e decida a resposta.
Edite a instrução reescrita, acrescentando a decisão no ponto certo (por exemplo, “incluir cotações em negociação”).
Salve e toque em Validar com a Filipa de novo. A nova validação deve vir sem aquela pendência.
Repita até o bloco mostrar “Validação concluída” sem pendências, ou apenas com pendências que você aceita deixar no padrão.
Se a validação apontar inviabilidade, o caminho é reformular a tarefa com dados que o Vendelo tem, ou pedir ao administrador que libere a consulta necessária.
Ativar agente
Com o agente salvo, toque em Ativar agente. O Vendelo confirma o provedor e o modelo, registra o agendamento no fuso escolhido e muda o status para Ativo, exibindo “Agente ativado”. A partir daí, cada horário do agendamento cria uma execução. Se não houver agendamento, o agente ativo fica aguardando o “Executar agora”.
A ativação exige que o proprietário do agente tenha e-mail confirmado e que o provedor de agentes esteja configurado. Se faltar algum, a ativação é recusada com a mensagem correspondente.
Executar agora
Disponível para agentes ativos ou pausados, o botão enfileira uma execução imediata com gatilho Manual e mostra “Execução solicitada”. Use para testar um agente novo antes do primeiro horário ou para obter o relatório fora da programação. A execução aparece no Histórico de execuções em segundos, primeiro como Na fila, depois Em processamento, e por fim Pronto ou Falhou. A entrega é feita normalmente ao concluir.
Teste sempre com Executar agora depois de ativar. Confira o arquivo gerado e o e-mail ou webhook recebido. Ajuste a instrução se necessário, valide e salve; as próximas execuções usam a instrução atual.
Pausar e retomar
Pausar remove o agendamento e muda para Pausado, mostrando “Agente pausado”. Nenhuma execução agendada acontece enquanto pausado, mas Executar agora continua disponível. Retomar registra o agendamento de novo, zera o contador de falhas e volta para Ativo (“Agente retomado”).
O Vendelo também pausa o agente sozinho depois de três falhas consecutivas, para não consumir IA em loop. Instabilidade momentânea na consulta aos dados, espera de cota do provedor por assinatura e falha apenas na entrega não contam para essa pausa. Verifique o motivo no histórico, corrija e retome.
Os três status do agente
| Status | Agendamento | Executar agora | Como chega aqui |
|---|---|---|---|
| Rascunho | Não registrado | Indisponível | Ao criar o agente, ou enquanto nunca foi ativado. |
| Ativo | Registrado | Disponível | Após Ativar ou Retomar. |
| Pausado | Removido | Disponível | Após Pausar, ou automaticamente após três falhas seguidas. |
Perguntas frequentes
A validação é obrigatória para ativar?
Tecnicamente não, mas é fortemente recomendada. Sem ela, o agente roda com a sua descrição original, que pode ser ambígua e falhar repetidas vezes.
A validação consome tokens?
Sim, como qualquer interação com a Filipa. É um consumo pequeno em comparação com execuções repetidas de um agente mal definido.
A instrução reescrita ficou muito técnica. Posso simplificar?
Pode editar à vontade, mas mantenha os nomes de dados que a Filipa citou: eles foram confirmados na estrutura do Vendelo e garantem que o agente encontre a informação.
Editei a instrução de um agente ativo. Preciso reativar?
Não. Salvar já basta; a próxima execução usa a instrução salva. Se mudou o agendamento ou o fuso, o novo horário é registrado ao salvar.
Executar agora e o horário agendado podem rodar ao mesmo tempo?
Sim, são execuções independentes, ambas registradas no histórico com o gatilho correspondente.
O que acontece se o provedor estiver sem créditos no horário?
Com provedor pago por token, a execução falha com a mensagem do provedor e conta como falha; após três seguidas, o agente pausa. Regularize a conta e retome. Com provedor por assinatura sem cota, a execução volta para Na fila e é retomada quando a cota libera, sem contar como falha.
Próxima leitura
Entrega por e-mail e webhook: veja o que os destinatários recebem e como integrar com Slack, Teams, Discord, Google Chat ou o seu sistema.
