Building your first agent — Gumloop (em inglês)
Gumloop é uma plataforma para criar agentes de IA conectados a ferramentas de trabalho. Em vez de receber apenas uma resposta de conversa, você define uma tarefa, fornece acesso aos aplicativos necessários e acompanha o que o agente faz. Para começar, o caminho apresentado na aula oficial combina três elementos: modelo, ferramentas e instruções.
O primeiro projeto deve ajudar a entender essa combinação. Uma boa escolha é organizar informações fictícias e conferir um resumo, antes de conectar contas com dados reais ou permitir alterações. Assim, você aprende a identificar a origem de uma resposta, o limite da tarefa e a diferença entre pedir uma ação e autorizar sua execução.
Este guia explica o primeiro uso com base na documentação do Gumloop e na demonstração do fabricante. O exercício proposto abaixo é fictício e não foi executado pela Café Online. O vídeo mostra um agente de vendas do próprio Gumloop; isso não significa que qualquer conta já tenha os mesmos conectores, permissões ou resultados.
O que você monta no Gumloop
Um agente reúne uma forma de interpretar pedidos, ferramentas disponíveis e orientações sobre o trabalho. O modelo participa do raciocínio e da resposta; os conectores permitem alcançar serviços; as instruções descrevem objetivo, comportamento e limites. Esses componentes precisam combinar com uma tarefa concreta, como consultar oportunidades comerciais e produzir um resumo para uma pessoa.
Na aula oficial de criação do primeiro agente, o exemplo usa HubSpot, Gmail e Slack. A demonstração passa por uma pergunta sobre o pipeline e pela preparação de um relatório enviado por e-mail. Esse caso ajuda a visualizar a plataforma, mas não é uma obrigação de conectar os três serviços para aprender.
Para avaliar utilidade no seu trabalho, comece pela pergunta que precisa responder. Um resumo de pendências tem critérios diferentes de um agente que pode atualizar um CRM. Se você consegue explicar o resultado esperado em duas frases, fica mais fácil perceber quando o agente resolveu o pedido, quando faltou informação e quando ele ultrapassou o escopo.
Também vale separar aprender o produto de decidir uma arquitetura maior. Este primeiro contato é sobre configurar e observar um agente no Gumloop. Questões como escolher frameworks, desenvolver integrações próprias ou distribuir responsabilidades numa equipe exigem outro planejamento.
Leia também: como planejar um agente de IA do zero, para organizar requisitos e escolhas técnicas antes de um projeto mais amplo.
Escolha uma tarefa cujo resultado possa ser conferido
Uma primeira tarefa adequada tem entrada pequena e resposta verificável. “Organize estas três oportunidades e some seus valores por etapa” permite comparar cada linha com o material fornecido. Já “melhore o comercial da empresa” deixa muitas decisões abertas: quais dados usar, o que modificar, quem consultar e como medir uma melhora.
Defina o que conta como conclusão. No exercício deste guia, o agente deve devolver uma tabela, totalizar os valores e apontar informação ausente. Ele não precisa pesquisar contatos, criar propostas, enviar mensagens ou alterar registros. A finalidade é aprender a conferir uma saída organizada, não colocar uma operação comercial inteira em funcionamento.
Escolha também o que ficará fora do pedido. Um valor de oportunidade não equivale a receita realizada. Uma etapa chamada “proposta” não garante fechamento. Se o material não informa a probabilidade de conversão, qualquer previsão seria uma hipótese adicional. O primeiro teste fica mais útil quando essas diferenças aparecem claramente no resultado.
Uma regra prática é imaginar como você faria a conferência sem o agente. Quais documentos abriria? Que conta precisaria consultar? Qual cálculo repetiria? Se essa conferência ainda depende de várias pessoas e fontes contraditórias, reduza a tarefa. Um recorte menor pode revelar um erro importante antes de você investir em uma automação mais extensa.
Para entender como tarefas se conectam num processo, veja o guia de workflow de IA e sua organização. O processo escolhido deve orientar a configuração, em vez de ser inventado depois que todas as ferramentas já estiverem conectadas.
Prepare o material e identifique o acesso disponível
Antes de configurar o agente, escreva o objetivo, a entrada e a saída em um pequeno roteiro. Para uma tarefa de leitura, especifique quais informações serão consultadas e qual formato ajudará a verificar a resposta. Isso evita transformar uma mudança de apresentação em uma mudança de finalidade sem perceber.
Use dados inventados na aprendizagem inicial. Troque nomes de clientes, identificadores e detalhes de negociação por exemplos que não correspondam a pessoas ou empresas reais. Não basta trocar o nome se o restante do texto ainda identifica um contrato confidencial. O exercício deve permitir praticar a organização sem depender de dados de produção.
Ao abrir o Gumloop, confira se você está no espaço e no agente pretendidos. A documentação distingue responsáveis pela configuração e usuários do agente. Caso uma opção citada no guia não apareça, verifique seu acesso e a tela atual antes de procurar um botão semelhante em outra área. A ausência pode estar relacionada às permissões, e não a uma falha do produto.
Não é necessário resolver todas as possibilidades na primeira sessão. Registre quais partes você conseguiu configurar e qual ficou pendente. Uma conexão indisponível pode impedir a consulta àquele aplicativo, mas não transforma um exercício com texto fornecido por você em um teste da integração. Mantenha essas duas evidências separadas nas suas anotações.
Da configuração ao primeiro pedido
A documentação atual descreve uma configuração guiada para um agente novo: ele pergunta do que deve cuidar e prepara sua configuração a partir da resposta. Se você estiver no construtor completo, as opções se distribuem pelas abas Agent, Triggers, Access e Settings. Apenas os responsáveis com acesso de configuração veem todas essas áreas.
- Na aba Agent, confira o modelo e as instruções. Para este primeiro exercício, mantenha o ponto de partida da conta e descreva a tarefa pequena. Não selecione um modelo apenas porque ele aparece no vídeo de outra data.
- Abra Connectors e use + Add somente se precisar de uma integração. Escolha o aplicativo necessário. O exercício com três oportunidades fictícias pode começar sem conectar CRM ou e-mail.
- Quando houver um conector, abra seus detalhes e confira a conta. A área de credenciais e contas define qual acesso será usado. Uma conexão pessoal e uma conta compartilhada podem representar conjuntos diferentes de informações.
- No detalhe do conector, confira Tool Management. Selecione o modo de aprovação compatível com a tentativa antes de executar uma tarefa com ferramentas. A seção de aprovações abaixo explica a diferença entre os modos.
- Salve a configuração. O construtor documentado só persiste alterações quando você usa Save. Antes disso, releia as instruções e confirme se não há dados ou credenciais que você não pretendia inserir.
- Abra New Task e apresente o exercício. Forneça os três registros fictícios e o pedido descrito adiante. Compare a resposta antes de acrescentar ferramentas, envio ou alteração de registros.
Esses nomes ajudam a localizar a configuração documentada; não demonstram que sua conta esteja conectada ou pronta. Se você estiver no fluxo guiado, acompanhe o que ele preparou antes de iniciar a tarefa. Não mude de espaço ou de agente apenas para encontrar uma interface visualmente igual à gravação.
Use o modelo como ponto de partida e escreva instruções objetivas
A aula oficial recomenda começar com o modelo selecionado inicialmente para o primeiro agente. A escolha pode ser revisitada quando você tiver uma tarefa e um critério de avaliação. Começar trocando modelos a cada resposta torna difícil saber se uma melhora veio dessa mudança ou de uma entrada mais clara.
Nas instruções, descreva papel, tarefa e formato. Para nosso exercício, a orientação pode ser: “Organize as oportunidades que eu fornecer, preserve os valores e indique campos ausentes. Entregue uma tabela e um resumo curto. Não invente nomes, datas ou probabilidades.” Esse é um exemplo editorial de instrução, não um comando que já tenha sido aplicado em uma conta.
Evite misturar objetivos incompatíveis. Pedir uma resposta curta e, ao mesmo tempo, uma análise detalhada de todos os cenários deixa a decisão de prioridade pouco clara. Prefira dizer qual informação precisa aparecer primeiro e quais detalhes podem ficar ao final. Se o resultado vier longo, identifique o trecho desnecessário antes de adicionar mais regras.
Instruções ajudam a orientar comportamento, mas não substituem os controles das ferramentas. Escrever “peça antes de enviar” não é a mesma coisa que configurar a exigência de aprovação para uma chamada de envio. Essa diferença precisa estar resolvida antes de conectar um serviço capaz de modificar dados ou se comunicar com outras pessoas.
A documentação atual de agentes do Gumloop reúne configuração, conectores, tarefas e orientações de ajuste. Use a interface e a documentação vigentes para localizar as opções; este artigo não pressupõe que todas as contas tenham a mesma apresentação visual.
Conecte somente o que a tarefa exige e confira a conta
Para entender o papel de um conector, pense na pergunta que ele precisa ajudar a responder. Uma consulta a oportunidades comerciais pode depender de acesso ao CRM. Um resumo preparado apenas com informações fictícias inseridas por você não precisa de acesso a uma caixa de e-mail para ser compreendido e conferido.
Ao adicionar um conector real, confirme qual conta ele representa. Um aplicativo conhecido pode ter contas pessoais, compartilhadas ou de equipes diferentes. A documentação do Gumloop descreve opções de seleção de conta; por isso, não deduza a origem de uma resposta apenas pelo logotipo do serviço. Registre qual fonte estava autorizada para aquele teste.
Antes de consultar o CRM, escolha uma informação de referência que você já conheça. Pode ser um registro de demonstração preparado para isso. Se o agente não o encontrar, investigue conta, acesso e escopo da consulta. Pedir uma busca cada vez mais ampla sem entender a origem do problema pode produzir uma resposta aparentemente convincente sobre o conjunto errado de dados.
Também separe consultar uma ferramenta de modificar informações nela. Ler o valor de uma oportunidade e mudar sua etapa são operações diferentes. O fato de o primeiro pedido funcionar não demonstra que a segunda ação deva ocorrer sem revisão. Decida o nível de acesso pela tarefa atual, mantendo mudanças fora do primeiro exercício.
Se a aplicação futura envolver o sistema comercial, aprofunde o planejamento em integração de IA com o CRM. O guia nominal do Gumloop ajuda no primeiro contato; a integração de uma operação exige conferir regras e responsabilidades próprias.
Configure a aprovação antes de permitir escrita ou envio
Na documentação de Human in the Loop do Gumloop, o modo padrão informado para um conector é Always allow. Portanto, não presuma que conectar Gmail, Slack ou outro serviço já ativa revisão humana de todas as ações. Confira a configuração antes de testar algo que escreva, envie ou exclua.
As opções documentadas incluem Ask for writes/deletes, que exige aprovação para alterações e operações de risco desconhecido, e Ask each time, que pede aprovação a cada chamada. A escolha depende do teste. Para observar cada acesso de um primeiro conector, pedir confirmação a cada chamada pode facilitar o acompanhamento; isso é uma recomendação editorial, não uma configuração que este guia aplicou por você.
Quando surgir uma aprovação, compare a proposta com o pedido original. A documentação esclarece que o cartão apresenta informações legíveis e detalhes importantes, mas não necessariamente todos os argumentos. Confira o contexto da tarefa, o destino e o conteúdo relevante. Uma apresentação resumida não elimina a necessidade de entender a ação.
Não marque Don't ask again for this tool durante a aprendizagem apenas para eliminar interrupções. A preferência pode persistir para a ferramenta naquele agente. A documentação também descreve uma particularidade de Manage Artifact: não há atualmente um controle de configuração para reativar esses pedidos. Aprovar uma chamada e mudar o comportamento futuro são decisões diferentes.
Exercício fictício: um resumo de três oportunidades
Considere uma empresa imaginária com três oportunidades. Não há clientes reais, conexão com CRM ou envio de e-mail neste exercício. Você pode usar o conjunto como material de referência para pensar na configuração e na conferência. Os nomes das oportunidades são apenas identificadores didáticos.
| Oportunidade fictícia | Etapa informada | Valor potencial | Próxima ação informada |
|---|---|---|---|
| Projeto A | Proposta | R$ 8.000 | Confirmar escopo |
| Projeto B | Proposta | R$ 5.000 | Não informada |
| Projeto C | Contato inicial | R$ 3.000 | Marcar conversa |
O pedido pode ser: “Organize essas oportunidades por etapa. Some os valores potenciais, mantenha a próxima ação exatamente como informada e destaque o que estiver ausente. Não complete lacunas nem proponha envio de mensagens.” A resposta esperada precisa permitir rastrear cada informação até uma linha da entrada.
Na conferência manual, há duas oportunidades em proposta, que somam R$ 13.000, e uma em contato inicial, com R$ 3.000. O total potencial é R$ 16.000. Esses valores são a soma do exemplo, não previsão de faturamento. A próxima ação do Projeto B está ausente e deve continuar identificada dessa forma.
Observe se a resposta inventa uma reunião, um responsável ou uma data. Mesmo uma sugestão plausível deve ser separada dos dados fornecidos. Para o primeiro teste, a ausência bem identificada é mais útil do que um preenchimento criativo que pareça uma informação do CRM.
Uma segunda rodada pode mudar apenas um elemento: informe uma próxima ação para o Projeto B e peça um novo resumo. Confira se o agente altera somente o necessário, preserva os valores e deixa de apontar aquela lacuna. Essa comparação ajuda a avaliar consistência sem introduzir uma integração diferente ou uma operação de escrita ao mesmo tempo.
Confira o resultado antes de ampliar o pedido
Faça a conferência em três passagens. Na primeira, verifique fidelidade: nomes, etapas e valores devem corresponder à entrada. Na segunda, confira os cálculos. Na terceira, avalie utilidade: a apresentação permite entender o que está pendente e decidir a próxima ação humana sem reler toda a conversa?
Não avalie somente se o texto está bem escrito. Um resumo elegante que transforma oportunidade em venda concluída muda o significado do dado. Uma tabela organizada com total errado continua inadequada. Registre o erro pelo seu efeito: soma incorreta, campo inventado, etapa trocada ou diferença entre a pergunta e a resposta entregue.
Quando houver uma integração real, acrescente a conferência da origem. Uma informação pode estar correta para outra conta, outro período ou outro conjunto de registros. Compare uma amostra conhecida e veja se o agente deixou claro o recorte usado. Se a origem não puder ser identificada, suspenda a conclusão em vez de tratar a resposta como um retrato completo da operação.
Guarde uma anotação simples da tentativa: qual era a entrada, qual resposta apareceu e qual correção você solicitou. Não é necessário criar um relatório extenso para cada interação de aprendizagem. O objetivo é conseguir repetir a comparação e descobrir se a alteração de instrução resolveu o erro observado.
Uma correção útil descreve a diferença concreta. “O Projeto B não tinha próxima ação; mantenha esse campo como não informado” ensina mais sobre o problema do que “seja mais preciso”. Se a mesma falha voltar, retome o escopo e os dados antes de acrescentar regras cada vez mais longas.
Veja o primeiro agente na demonstração oficial
O vídeo incorporado é Building your first agent, publicado pelo Gumloop em sua própria lição. O conteúdo é em inglês. Ele começa com a apresentação do conceito e mostra a interface de um agente de vendas conectado a ferramentas de trabalho, incluindo uma pergunta sobre o pipeline.
Assista procurando três elementos: onde aparecem as ferramentas disponíveis, como o pedido é apresentado e o que a resposta usa como base. O exemplo oficial ajuda a entender a relação entre configuração e tarefa. Ele não prova que um conector recém-adicionado à sua conta esteja autenticado ou tenha a mesma autorização.
A demonstração inclui envio de relatório por e-mail. Para seu primeiro exercício, prefira conferir o resumo antes de acrescentar essa ação. Se decidir testar envio depois, trate destinatário, conteúdo e aprovação como parte de uma nova tarefa, com os controles apropriados já configurados.
Em telas pequenas, os textos da interface gravada podem ficar difíceis de ler. Use a tela cheia do player ou acompanhe a lição original com transcrição. As explicações deste guia permitem entender o exercício sem depender de ler cada detalhe dentro da gravação.
Como investigar ferramenta errada, acesso e confirmação
Se o agente consultar uma ferramenta que não corresponde ao pedido, retome a tarefa em termos concretos. Indique qual fonte deve responder àquela pergunta e elimine ferramentas desnecessárias do primeiro teste. Várias integrações semelhantes podem dificultar a identificação do caminho usado, especialmente quando você ainda está conhecendo a plataforma.
Se ocorrer erro de autenticação, confira a conta conectada e o acesso no serviço correspondente. Não cole senha, chave ou outro segredo nas instruções para tentar resolver o problema. Um texto mais detalhado não concede acesso que a integração não possui. Diferencie uma autorização ausente de uma informação realmente não encontrada.
Se houver confirmações demais ou de menos, confira o modo de aprovação do conector e as regras específicas. Uma ferramenta de leitura pode pedir confirmação porque foi configurada para isso. Uma ação de escrita pode avançar porque o conector permaneceu no padrão. Investigue a configuração antes de concluir que o agente ignorou uma orientação textual.
Se a tarefa parar antes de concluir, veja qual etapa ficou pendente. Não repita o pedido inteiro automaticamente: uma parte pode já ter sido concluída. No exercício fictício, comparar a entrada e a saída é simples; numa futura operação com alterações, repetir sem entender o estado pode criar resultados duplicados ou confusos.
Leia também: quando transferir o atendimento para uma pessoa, caso o projeto futuro envolva clientes. Essa transferência é uma decisão de processo distinta de aprovar uma chamada de ferramenta no Gumloop.
Quando avançar para uma tarefa real
Avance quando conseguir explicar o que o agente recebeu, o que consultou e por que a resposta foi aceita. O primeiro objetivo não precisa ser eliminar toda intervenção humana. Pode ser reduzir o tempo gasto organizando uma informação, mantendo uma conferência clara antes de qualquer uso externo.
Escolha uma próxima mudança por vez. Você pode substituir o conjunto fictício por uma fonte de demonstração autorizada, acrescentar uma pergunta ou testar um formato diferente. Se mudar modelo, ferramenta, conta e instruções simultaneamente, ficará difícil identificar a causa de um resultado melhor ou pior.
A documentação informa consumo de créditos relacionado ao trabalho do agente e disponibiliza informações por tarefa. Confira o consumo exibido na sua conta e compare tentativas equivalentes. Este guia não apresenta preço por execução, gratuidade de modelo ou condição de plano como algo fixo. Uma tarefa curta e outra com várias ferramentas não são uma comparação adequada de custo.
Antes de compartilhar o agente, defina quem confere os resultados e como lidar com exceções. A pessoa que recebe o resumo precisa saber se há campos ausentes, qual origem foi usada e se alguma ação ficou aguardando decisão. Compartilhar uma resposta sem essas informações pode esconder justamente o limite que você identificou durante os testes.
Para uma expansão posterior, veja como organizar a escala de agentes no negócio. O aprendizado do primeiro uso deve orientar o próximo projeto: escolha uma tarefa compreensível, conecte o necessário, configure os controles e amplie a atuação conforme os resultados que você realmente conseguir verificar.
Perguntas frequentes sobre Gumloop
Preciso programar para criar meu primeiro agente no Gumloop?
A aula de primeiro agente apresenta um caminho de configuração com modelo, ferramentas e instruções. O exercício deste guia não exige escrever código. Isso não significa que toda integração ou projeto possa ser realizado sem conhecimento técnico; comece com uma tarefa pequena e confira os recursos efetivamente disponíveis na conta.
Preciso conectar Gmail, Slack e um CRM ao mesmo tempo?
Não é uma exigência deste primeiro exercício. Esses serviços aparecem no exemplo oficial de vendas. Conecte somente o que a tarefa precisa e confirme a conta usada. Para aprender a organizar informações fictícias fornecidas por você, não é necessário transformar o exercício em envio de mensagens ou atualização de registros.
Escrever uma instrução já obriga o agente a pedir aprovação?
Não equivale a configurar o controle de aprovação de uma ferramenta. Confira as opções do conector e o modo escolhido. A documentação informa Always allow como padrão e oferece modos que exigem confirmação. Uma ação real deve ser avaliada conforme esses controles e o contexto da tarefa, além do texto das instruções.
O resumo do exemplo representa uma previsão de receita?
Não. Os R$ 16.000 são apenas a soma dos valores potenciais de três oportunidades fictícias. Não há probabilidade de conversão, contrato fechado ou recebimento informado. O exercício ensina a preservar os dados e identificar lacunas; qualquer previsão exigiria informações e critérios adicionais.
Este artigo mostra um teste de integração feito pela Café Online?
Não. O procedimento é documental, o conjunto de oportunidades é fictício e o vídeo pertence ao Gumloop. Não foram conectadas contas de clientes nem enviados relatórios pela agência para produzir este guia. O resultado da sua configuração deve ser conferido antes de servir a uma operação real.