Agent Tasks

Tutorial do Agent Tasks — assista no YouTubeWatch the walkthrough · 7:13

O que o Agent Tasks faz

O Agent Tasks permite delegar tarefas recorrentes a agentes de IA em vez de fazê-las você mesmo. Você instrui um agente como instruiria uma pessoa, \"toda segunda de manhã, some os pedidos da semana passada e me envie o resumo por e-mail\", escolhe as ferramentas que ele pode usar e define quando ele deve rodar. O agente planeja os próprios passos na execução, trabalha dentro dos limites que você definiu e para para pedir a sua aprovação antes que qualquer coisa seja enviada a um cliente.

Três termos aparecem em todo lugar deste guia:

Um agente é uma tarefa que você configurou: sua instrução, suas ferramentas e seu gatilho.
Uma execução é uma rodada do agente. Cada execução deixa um registro passo a passo no Log de execuções.
Um conector é um serviço que um agente pode usar: sua loja, um canal de chat, uma planilha, um marketplace, um provedor de pagamento. Uma única conexão é compartilhada por todos os agentes do bot.

O Agent Tasks é um complemento. Depois da compra, Complementos → Agent Tasks deixa de aparecer em cinza na barra lateral do painel, com Visão geral, Agentes, Biblioteca, Conectores, Log de execuções e Configurações abaixo. Sem o complemento, a página mostra apenas uma breve descrição e mais nada.

Onde ficam as coisas

Abra Complementos → Agent Tasks na barra lateral do painel. O console tem cinco páginas, cada uma com sua entrada na barra lateral:

Visão geral: o que precisa de você agora, e uma tabela dos seus agentes ativos.
Agentes: todos os agentes, com pausar, executar, editar e excluir.
Biblioteca: agentes prontos que você adiciona com um clique, além do construtor em branco.
Conectores: o que já vem integrado, o que está conectado e o que você pode conectar.
Log de execuções: cada execução, seus passos, seu custo e qualquer aprovação que ela esteja aguardando.

O construtor abre a partir das abas Agentes e Biblioteca, e fica em Agentes enquanto você está nele.

Visão geral: o que precisa de você

O cartão PRECISA DE VOCÊ é o lugar para verificar. O cabeçalho conta o que está aguardando e quantas tarefas foram tratadas nesta semana. Aparecem três tipos de linha:

Uma execução retida: um agente quer enviar algo e está aguardando você. Revisar abre a execução com as mensagens exatas que ele propõe.
Uma conexão quebrada: o acesso de um conector expirou e os agentes que o usam vão falhar até você reconectar. Reconectar leva à aba Conectores.
Um agente rascunho: construído, mas nunca implantado. Abrir rascunho volta ao construtor.

Quando nada está aguardando, o cartão informa isso, e você pode deixar o console em paz: os agentes rodam sozinhos e só aparecem aqui quando um deles precisa de uma decisão.

Abaixo, AGENTES ATIVOS lista cada agente em execução com sua agenda, a próxima execução, os conectores que usa e o resultado da última execução.

Adicione um agente pela Biblioteca

O início mais rápido é um agente pronto. Abra Biblioteca, filtre por Cliente, Suporte, Operação ou Relatórios e pressione Adicionar agente em um cartão. Adicionar pela biblioteca é gratuito, e o agente fica ativo imediatamente na agenda mostrada no cartão.

Alguns modelos exigem uma conexão antes. Um cartão que lê uma planilha pede que você escolha o arquivo ao adicioná-lo, e se nenhuma planilha estiver conectada ainda, leva você à aba Conectores. Cartões que dependem de um serviço específico (Shopify, Calendly, AfterShip, Stripe, HubSpot, Slack, Mailchimp, um número de voz) só funcionam depois que esse conector estiver configurado.

A biblioteca inclui atualmente:

Relatórios: Resumo semanal de vendas (segundas de manhã), Registro de vendas para planilha (todas as manhãs), Exportação do registro de chamadas (todas as noites).
Operação: Atualização da base de conhecimento (semanal), Envio de campanha (semanal), Rodada de chamadas (de hora em hora), Alerta de estoque baixo (todas as manhãs), Auditoria de estoque em marketplaces (todas as manhãs).
Suporte: Monitor de status de pedidos (diário), Escalonamento de ticket atrasado (quando um ticket passa do SLA), Concierge de transferência (quando um cliente pede uma pessoa).
Cliente: Agendar um horário, Status de garantia, Encontrar uma loja, Status de entrega, Status de reembolso, Lista de espera para reposição. Estes são acionados pelos seus clientes no chat; veja *Deixe os clientes acionarem um agente pelo chat* abaixo.

Um agente adicionado pela biblioteca é seu para editar. Abra-o com Editar na aba Agentes: você pode alterar nome, instrução, modelo e agenda, e adicionar ou remover ferramentas. Remover uma ferramenta só restringe o que o agente pode fazer; nunca amplia.

Construa o seu próprio agente

Pressione + Criar agente na aba Agentes, ou + Construir do zero na Biblioteca. O construtor é uma única página com quatro cartões.

O que ele faz

Nome: como aparece nas listas e nos e-mails de aprovação.
Instrução: o briefing, até 4.000 caracteres. Escreva como escreveria para um membro da equipe: o que olhar, o que fazer e o que nunca fazer. O agente planeja os próprios passos a partir disso e para nas suas barreiras de proteção.
Modelo: Rápido para consultas curtas e respostas de rotina, Equilibrado para trabalho de várias etapas com chamadas de ferramentas (o padrão), Profundo para raciocínio longo em que erros são caros. Modelos mais profundos custam mais por execução.

Ferramentas que ele pode usar

As ferramentas são agrupadas em aquilo que o agente pode fazer, aquilo que pode ler e aquilo em que pode escrever. Pressione + Adicionar em cada grupo. Qualquer coisa que exija uma conexão que você ainda não fez é marcada como CONECTE PRIMEIRO; qualquer coisa ainda não disponível na plataforma é marcada como EM BREVE.

Ações que ele pode executar:

Mensagem: enviar mensagens nas conversas dos seus canais de chat conectados. Cada mensagem fica retida para a sua aprovação. Com mais de um canal conectado, escolha o canal no cartão ou deixe em *Qualquer canal*.
E-mail: enviar pela sua caixa de e-mail conectada para qualquer endereço. Cada e-mail fica retido para a sua aprovação. Relatórios para a sua própria caixa de entrada não precisam de nenhuma configuração.
Telefone: fazer ligações de saída pelo seu número de voz. Cada ligação fica retida para a sua aprovação e limitada a 15 minutos. Exige o canal de voz e um número.
API de um conector: uma entrada por serviço conectado. O agente compõe as chamadas; as credenciais ficam no servidor e nunca são visíveis para ele.
Crawler: buscar e ler páginas públicas da web citadas na instrução.
Busca na web: pesquisar na web por informações atualizadas.
Chamar uma API: chamar uma API em hosts que você listar no cartão, com uma chave opcional. A chave é armazenada com o agente e injetada pela plataforma; o agente nunca a lê.
Ferramentas MCP: usar as ferramentas de um servidor MCP cujo endereço você informa no cartão.

Fontes de dados que ele pode ler: a sua loja (pedidos e dados da loja Shopify, WordPress ou Wix, somente leitura), transcrições de conversas, a base de conhecimento do chatbot, a manutenção do conhecimento (atualizar a base de conhecimento a partir do seu site e ler a sua saúde), o conhecimento interno do agente do helpdesk, uma planilha que você escolhe no cartão, e a própria memória do agente de execuções anteriores.

Destinos de dados em que ele pode escrever: uma planilha que você escolhe no cartão, e a memória do agente, as anotações próprias do agente entre execuções, como quem já foi contatado.

Cada cartão de planilha fixa o próprio arquivo. O Google Sheets abre o seletor de arquivos do Google; o Microsoft Excel abre uma lista das pastas de trabalho no seu OneDrive conectado. O agente lê e escreve apenas o arquivo que você escolhe.

Quando ele roda

Em uma agenda: de hora em hora, todos os dias, dias úteis, fins de semana, semanal ou mensal, na hora e no fuso horário que você escolher. Uma linha verde abaixo do seletor mostra o resultado em palavras simples.
Em um evento: eventos de chat (transferência solicitada, abuso detectado, nenhuma resposta encontrada), eventos de helpdesk (novo ticket, precisa de aprovação, precisa de atenção, reaberto, fora do SLA), eventos de loja (novo pedido, pedido reembolsado, pedido cancelado, e no Wix também carrinho abandonado e estoque baixo) ou Em webhook. Escolher o webhook dá ao agente uma URL própria, exibida no cartão, para a qual qualquer sistema pode enviar um POST.
Quando um cliente pede no chat: o cliente inicia o agente a partir de uma conversa. Veja a próxima seção.
Somente manualmente: sem agenda e sem eventos. Você pressiona Executar agora na aba Agentes.

Barreiras de proteção

Duas barreiras de proteção estão sempre ativas: mensagens a clientes ficam retidas para a sua aprovação, e uma execução para se o gasto passar do limite por execução (atualmente US$ 2,00). Elas aparecem no cartão para que você saiba que existem.

Execução de teste e implantação

Para um agente construído a partir de um briefing, Executar teste roda o plano sem enviar nada e mostra o que teria feito, rotulado como *Prévia de teste, nada foi enviado*. As execuções de teste são cobradas como execuções reais. Quando estiver satisfeito, Implantar agente o torna ativo; um agente ativo que você recompila recebe Implantar atualização.

Depois de uma compilação, um banner verde diz *Compilado. Veja o que este agente fará*, seguido do plano em linguagem simples. Leia antes de implantar.

Deixe os clientes acionarem um agente pelo chat

Defina Quando executar como Quando um cliente pedir no chat e o construtor mostra um pequeno contrato:

Nome da ferramenta: o que a IA do chat chama internamente. Os clientes nunca veem isso.
Quando usar: uma frase que diz à IA do chat quando esta tarefa se aplica. Escreva como uma instrução para a equipe.
Entradas que o cliente pode fornecer: até cinco, cada uma com um nome, um tipo (texto, número, sim/não), uma descrição e se é obrigatória.
Execuções por cliente: quantas vezes um cliente pode iniciar esta tarefa em 24 horas, de 1 a 10. O padrão é 3.
Escopo de dados: uma instrução adicionada a cada etapa de uma execução acionada pelo cliente sobre o que o agente pode e não pode repetir.

O agente precisa da ação Mensagem, ou não tem como responder.

Duas coisas precisam ser entendidas antes de publicar. Primeiro, tudo o que uma tarefa pode ler, ela pode repetir para o cliente que a acionou. O escopo de dados é uma instrução para a IA, não um limite de segurança; não conceda a uma tarefa voltada ao cliente dados que ela nunca deveria mostrar. Por trás disso existe o seguinte: cada resposta produzida por uma tarefa acionada pelo cliente passa por uma verificação de vazamento, comparada com a solicitação do cliente e com o seu escopo de dados, antes de o chat entregá-la.

Uma resposta que informa ao cliente o horário da própria reserva é enviada; uma que lista a sua agenda, cita as suas anotações ou nomeia outro cliente para como uma execução retida, o cliente é informado de que a equipe da loja está revisando, e a sua aprovação ou rejeição no Histórico de execuções decide se ela é entregue ou encerrada.

As tarefas acionadas pelo cliente também não podem usar o Crawler nem a busca na web, mantêm a memória separada por cliente e só podem enviar e-mail para o cliente que pediu ou para você. Segundo, cada execução consome os seus créditos, limitada pelo limite por cliente. Um cliente que esgotou a sua cota é informado de que a tarefa não está disponível no momento; ele nunca recebe nenhuma informação sobre o seu saldo.

Quem conta como cliente: nos canais de mensagens (WhatsApp, Telegram, LINE, Messenger, Instagram, Discord), a conta própria do cliente é a identidade dele e não é preciso login. No seu site, o visitante precisa estar logado; visitantes anônimos são convidados a entrar primeiro. WordPress e o app Shopify tratam isso automaticamente. Qualquer outro site precisa do Segredo de assinatura de identidade mostrado na aba Agent Tasks em Configurar, uma tarefa única para quem construiu o site.

Implantar o agente é o que o publica. Pausá-lo na aba Agentes o despublica. Agent Tasks → Configurações lista os seus agentes acionáveis pelo chat, mas não é uma segunda chave.

Conectores

Abra Conectores. A linha superior, INTEGRADOS, é o que todo agente já tem sem nenhuma configuração: a sua plataforma de loja (Shopify, WordPress ou Wix, detectada automaticamente), o Chatbot (responder em qualquer canal), o Bot Knowledge, E-mail para você (relatórios apenas para a sua caixa de entrada), Memória do agente e Conversas.

Abaixo, a BIBLIOTECA DE CONECTORES lista todos os serviços que você pode adicionar, filtrados por Canais, Redes sociais, Marketplaces, Helpdesks, Pagamentos, CRM, Marketing e Produtividade. Cada cartão conecta de uma das quatro formas:

Conectar: um login com o provedor. Aprove a solicitação e você volta ao console; nada para copiar. Usado por Google Sheets, Microsoft Excel, Slack, Notion, os calendários, Calendly, Stripe, Square, Squarespace, Mailchimp, Klaviyo, Attentive, HubSpot, Zoho, Salesforce, Judge.me, a família Google, a família Meta, X, TikTok, YouTube e os marketplaces. Dois deles pedem uma coisa antes: o Judge.me quer o domínio da sua loja, e o WooCommerce quer a URL da sua loja, porque a tela de aprovação fica na própria loja.
Conectar com uma chave: você cola as credenciais do próprio painel do provedor. O formulário abre com um link Obter sua chave para a página certa e um caminho de uma linha a seguir depois de entrar lá. Usado por PayPal, AfterShip, ShipStation, Shippo, Rakuten, Resend, Mailtrap, Twilio, Vonage, Telnyx, Loox e Microsoft Clarity. O Apple Calendar usa o mesmo formulário com outro rótulo, Conectar com a conta, porque pede o seu Apple ID e uma senha específica de app, e não uma chave. As chaves são armazenadas cifradas em repouso, como todas as outras credenciais.
Conectado pelo seu bot: os canais de chat (Telegram, WhatsApp, Discord, Voz, LINE, Messenger, Instagram) e os helpdesks (Zendesk, Gorgias, Freshdesk, Help Scout) vêm da configuração do próprio bot. Se um deles ainda não estiver configurado, Conectar abre o mesmo formulário de configuração usado pela aba Canais.
Em breve: o conector existe, mas ainda não está ativado para a plataforma. Veja *Por que um cartão diz \"Em breve\"* abaixo.

Uma única conexão atende a todos os agentes do bot. Desconectar remove o nosso acesso armazenado e, quando o provedor permite, também o revoga do lado dele.

Quando o acesso de um provedor expira, o cartão muda para Reconectar, conexão expirada, a Visão geral sinaliza isso, e os agentes que dependem dele são pausados automaticamente, com o motivo mostrado na linha de cada um. Reconectar os retoma.

Alguns conectores têm particularidades, e a dica do formulário as explica: a chave de licença da Rakuten é renovada aproximadamente a cada 90 dias; a Pesquisa de Transações do PayPal pode levar até nove horas para ficar ativa depois de habilitada; o Mailtrap fixa um stream por conexão; o Twilio aceita uma chave de API ou o auth token da conta; o Loox exige um plano pago do Loox; o Resend só consegue enviar a partir de um domínio verificado na sua própria conta Resend; uma conexão do Squarespace que nenhum agente usou por uma semana precisa ser reconectada.

Aprovações e execuções retidas

Sempre que um agente quer enviar uma mensagem, um e-mail ou uma ligação a um cliente, a execução para antes de enviar e é marcada como RETIDA. Você recebe um e-mail com o assunto *O agente \"…\" está aguardando a sua aprovação*, e a execução aparece em PRECISA DE VOCÊ.

Abra-a no Log de execuções. A linha do tempo de passos termina em um bloco âmbar para cada escrita proposta: para quem vai, o assunto quando houver e o início do texto. Aprovar e enviar envia tudo o que a execução contém; Rejeitar descarta. A aprovação é tudo ou nada; não há como escolher mensagens individuais.

Uma execução retida espera sete dias. Se você não decidir até lá, ela expira, e o agente não inicia novas execuções agendadas enquanto houver uma decisão pendente. Dois destinos nunca retêm: um relatório para a sua própria caixa de entrada e uma planilha que você escolheu. Esses são confiáveis, então os agentes de relatório rodam sem supervisão desde o primeiro dia.

O Log de execuções

Cada execução aparece no Log de execuções, da mais recente para a mais antiga, filtrável por Todas, Com falha e Retidas. Cada linha mostra o agente, quando rodou e o que a acionou (agenda, evento, manual, teste, pedido de um cliente no chat ou uma aprovação), quanto tempo levou e o resultado. Exportar CSV baixa a lista.

Selecione uma execução para ver os seus passos à direita: cada passo em palavras simples, a ferramenta usada, quanto tempo levou e qualquer erro. As execuções retidas mostram as escritas propostas, com os botões de aprovar e rejeitar. As execuções de telefone listam cada ligação com um link para a sua transcrição. As execuções de teste mostram o painel de prévia.

Distintivos de resultado: CONCLUÍDA terminou; FALHOU parou por um erro, exibido na linha; RETIDA aguardando você; ENCERRADA parada por você ou pelo sistema, com o motivo; EXECUTANDO, NA FILA e APLICANDO estão em andamento.

Gerenciando agentes

Na aba Agentes, cada linha tem uma chave para pausar ou retomar, Executar agora, Editar e um menu ⋯ com Duplicar e Excluir.

Pausar interrompe a agenda e, para um agente acionável pelo chat, o despublica. Ligá-lo de novo retoma a agenda.
Executar agora inicia uma execução imediatamente. Só uma execução por agente fica em andamento de cada vez; se uma ainda estiver aberta, Executar agora aguarda.
Editar abre o construtor. As mudanças valem a partir da próxima execução. Alterar os conectores de um agente reescreve a instrução para o novo serviço, e essa reescrita é cobrada como qualquer chamada de modelo.
Duplicar cria uma cópia, de graça.
Excluir pede confirmação duas vezes. Apaga o agente, suas versões, seu histórico de execuções e sua memória. Conversas e o seu histórico de cobrança permanecem. Um agente com uma execução em andamento não pode ser excluído até ela terminar.

Um agente que foi pausado automaticamente porque um conector expirou informa isso na própria linha. Reconecte para retomá-lo, ou pressione a chave para retomá-lo mesmo assim.

Quanto custa

Tudo é descontado do mesmo saldo de créditos do restante da plataforma, e os números abaixo estão atualizados até a data de redação.

Adicionar pela biblioteca, duplicar, editar e alterar uma agenda: gratuito.
Compilar a partir de um briefing: o custo do modelo para compilá-lo, nada além disso.
Uma execução: as chamadas de modelo que ela faz, mais uma pequena cobrança de computação que é uma fração de centavo mesmo em uma execução pesada. Execuções de teste e de aprovação são cobradas da mesma forma. Uma execução para se passar do limite por execução, atualmente US$ 2,00.
Pesquisa na web: atualmente 0,01 crédito por consulta.
X (Twitter): o X cobra por chamada de API, e isso é repassado com o dobro da tarifa deles: atualmente 0,01 crédito por leitura e 0,03 por escrita.
Todas as outras chamadas de conector: sem taxa por chamada.

O gasto do mês até a data de cada agente aparece na linha dele na aba Agentes, e o custo de cada execução está no Log de execuções. Se o saldo estiver zerado, as compilações são recusadas e as execuções falham com *no_credits*; um cliente que tenta uma tarefa de chat recebe apenas a informação de que ela não está disponível. Execuções que falham por uma falha da plataforma são creditadas de volta automaticamente.

Limites que vale conhecer

30 agentes por bot. Arquive ou exclua um para abrir espaço.
Uma execução em andamento por agente por vez.
Uma execução para sozinha quando não está avançando: a mesma chamada com os mesmos argumentos três vezes, ou quatro ações seguidas recusadas ou com falha. Ela encerra como falha, e o Log de execuções informa em qual chamada ficou travada.
Tarefas acionáveis pelo chat: de 1 a 10 execuções por cliente a cada 24 horas, definido por agente.
Agentes acionados por webhook: no máximo dez execuções abertas na fila; novos envios são recusados até que uma termine. Os corpos das requisições são cortados após 4 KB; o que passar disso não é entregue ao agente.
Ligações telefônicas: 15 minutos cada.
Uma execução é interrompida após cerca de 15 minutos.
Atualização da base de conhecimento: uma vez por agente a cada 24 horas.

Se algum desses limites atrapalhar um trabalho real, escreva para support@proxyai.app informando qual limite você está atingindo e o que está tentando fazer. Eles são características do sistema, não uma cota, e preferimos ouvir o caso a ver você contornar o limite.

Privacidade e retenção

Os agentes nunca guardam as suas credenciais; as chamadas dos conectores passam pela plataforma, que adiciona as credenciais na saída. O registro de passos que você vê é escrito depois que os dados pessoais são mascarados, e páginas brutas ou respostas de API que um agente buscou não são mantidas. A auditoria detalhada das chamadas de conector é apagada após 90 dias. As mensagens propostas em uma execução retida são apagadas no momento em que você aprova ou rejeita, ou quando ela expira; as prévias de execuções de teste são mantidas por 24 horas para que você possa consultá-las.

Para tarefas acionadas pelo cliente, lembre-se de que o agente vai repetir o que consegue ler. Restrinja esses agentes ao mínimo necessário.

Por que um cartão diz \"Em breve\"

Um botão Em breve em um conector significa que o código está pronto, mas o provedor ainda não aprovou o nosso app, ou a conexão ainda não foi ativada para a plataforma. Alguns provedores revisam todo app que pede acesso; o Google, por exemplo, revisa apps que leem calendários, análises ou comentários do YouTube, e a Meta revisa apps que gerenciam anúncios ou páginas.

Até que a revisão seja aprovada, você pode ver uma tela de aviso do provedor durante a conexão, ou o cartão permanece em Em breve. Nada do seu lado desbloqueia isso; o cartão muda para Conectar no momento em que estiver disponível, sem nenhuma atualização necessária.

Correções rápidas

O cartão ainda diz \"Conectar\", mas tenho certeza de que está conectado: para canais de chat, a conexão vem da configuração do próprio bot; verifique em Configurações → Canais. Se o canal estiver ativo lá, atualize o console.
Conectar me manda ao provedor e de volta com um erro: a causa mais comum é uma configuração do lado do provedor que ainda não foi atualizada. Tente de novo após um minuto; se persistir, entre em contato com o suporte informando o nome do provedor.
Meu agente está pausado e eu não o pausei: um conector que ele usa expirou. A linha informa qual. Reconecte na aba Conectores.
O agente rodou, mas nada foi enviado: verifique no Log de execuções. Muito provavelmente está RETIDA aguardando sua aprovação, ou a execução atingiu a barreira de \"me pergunte antes de enviar para mais de N pessoas\" e o restante está aguardando ali.
Um cliente diz que a tarefa do chat \"não está disponível\": ele esgotou a cota do dia, o agente está pausado ou o saldo está zerado.
Quero ver o código: não há código para ver. O plano mostrado depois de uma compilação e o registro de passos após uma execução são toda a história.