Ao construir um agente, vários recursos se sobrepõem: um bloco determinístico e uma ferramenta de agente podem rodar a mesma integração, e uma ferramenta personalizada, uma ferramenta MCP e um workflow-as-tool podem dar a um agente a mesma ação. Esta página deixa as diferenças claras para você escolher a opção certa. Elas variam em três eixos: se a ação é determinística (sempre roda) ou decidida pelo modelo (um agente escolhe), se vive em um workflow ou é reutilizável no workspace, e se vem do Zoen ou de um provedor externo.
O exemplo contínuo é um workflow que pontua leads de vendas de entrada. Ele lê um lead novo, enriquece, decide uma pontuação, registra o resultado e notifica o time. Cada opção abaixo constrói uma parte dele:
Bloco determinístico
Um bloco é um passo único que roda em um ponto fixo do caminho, sem um modelo decidir se deve. Sempre roda quando o workflow o alcança. Use um quando a ação precisa acontecer toda vez: uma chamada de API, uma transformação de dados, uma ramificação.
No lead scorer, um bloco Google Sheets sempre acrescenta o lead pontuado a uma planilha de acompanhamento, e um bloco Function sempre reformata a resposta de enriquecimento nos campos que o próximo passo espera. Não há julgamento. O trabalho é garantido.
A maioria dos passos em um workflow são blocos. Recorra aos tipos abaixo só quando quiser que um modelo decida, ou quando quiser reutilizar algo.
Ferramenta de agente
Uma ferramenta de agente é uma ação que você entrega a um bloco Agent. O agente lê a tarefa e decide se e quando chamá-la. O mesmo catálogo de integrações que existe como blocos avulsos também pode ser anexado a um agente como ferramentas.
No lead scorer, o Agent tem uma ferramenta Search e uma Send Email. Para um lead com perfil fraco, ele roda Search para reunir contexto; para um lead forte, chama Send Email. Um lead óbvio e fraco pode não disparar nenhuma. O agente escolhe por execução.
Cada ferramenta carrega uma configuração usageControl. Auto deixa o modelo decidir (o padrão). Force faz o agente chamar a ferramenta em toda execução, para ações que nunca devem ser puladas, como sempre registrar a decisão. None remove a ferramenta daquele agente.
Um bloco e uma ferramenta de agente podem ser a mesma integração por baixo. A diferença é quem decide. Um bloco roda porque o caminho o alcançou. Uma ferramenta de agente roda porque o agente a escolheu.
Ferramenta personalizada
Uma ferramenta personalizada é uma ferramenta que você define uma vez com um schema de objeto e um trecho de JavaScript ou Python, e então reutiliza no workspace. Não precisa de conta externa. Use uma quando tiver lógica que vários agentes ou workflows duplicariam de outra forma.
No lead scorer, uma ferramenta personalizada normalizeCompanyDomain limpa um site bruto em um domínio canônico. A mesma ferramenta serve o lead scorer, um workflow de deduplicação e um agente de relatórios. Defina-a no workspace e escolha-a na lista de ferramentas de qualquer bloco Agent.
Servidor MCP
MCP (Model Context Protocol) é um padrão para conectar um provedor externo de ferramentas. Conecte um servidor MCP e suas ferramentas aparecem na lista do agente como um conjunto. Use para trazer um toolset completo que o Zoen não oferece nativamente, em vez de ligar cada ação na mão.
No lead scorer, o fornecedor do CRM oferece um servidor MCP. Depois de conectar uma vez, o agente pode ler contas e atualizar registros pelas ferramentas do próprio fornecedor. A diferença para uma ferramenta personalizada é quem mantém: uma ferramenta personalizada é código que você escreveu; um servidor MCP é uma caixa de ferramentas que outra pessoa mantém.
Workflow-as-tool
Um workflow-as-tool é um workflow inteiro entregue a um agente como uma ferramenta invocável. Você escolhe o workflow na lista de ferramentas do bloco Agent; o agente decide quando chamá-lo e fornece as entradas, que chegam no trigger Start do filho, e o resultado do filho volta como saída da ferramenta. Use quando um procedimento de vários passos deve estar à disposição do agente, não no caminho.
No lead scorer, o agente tem um workflow Deep Enrich como ferramenta — um procedimento próprio de cinco passos. Para um lead fraco, o agente o chama para preencher o perfil antes de pontuar; para um lead completo, nunca roda. O agente pondera um procedimento inteiro da mesma forma que pondera uma ação única.
Um workflow também pode rodar como passo fixo: o bloco Workflow chama um workflow filho porque o caminho o alcançou. Mesmo workflow filho, mesmo trigger Start — a diferença, como entre blocos e ferramentas de agente, é quem decide. O passo Enrich no diagrama é esse caso determinístico.
Skill
Uma skill é um conjunto reutilizável de instruções, um playbook escrito que um agente pode seguir. Cada skill tem um nome curto e uma descrição sempre visíveis ao agente, mais um corpo mais longo que o agente carrega só quando decide que a skill se aplica. Use para capturar como algo deve ser feito, separado das ferramentas que fazem.
No lead scorer, uma skill lead-scoring-rubric detalha as faixas e desqualificadores. O agente vê o nome e a descrição da skill em toda execução, e quando um lead é ambíguo carrega a rubrica completa e a aplica. A distinção é simples: uma ferramenta é uma ação que o agente toma, e uma skill é orientação que o agente lê. Gerencie skills no seu workspace.
| Quem decide que roda | Onde vive | Como você cria | |
|---|---|---|---|
| Bloco | O caminho | O workflow | Arraste e configure |
| Ferramenta de agente | O agente | No bloco Agent | Escolha nas integrações |
| Ferramenta personalizada | O agente | O workspace | Escreva o código uma vez |
| Servidor MCP | O agente | Um servidor externo | Conecte |
| Workflow-as-tool | O agente | Seu próprio workflow | Construa e depois escolha na lista de ferramentas |
| Skill | O agente | O workspace | Escreva as instruções |
Juntando tudo
O lead scorer usa seis tipos de uma vez: blocos para os passos que sempre devem rodar, ferramentas de agente para as chamadas que o modelo deve ponderar, uma ferramenta personalizada para lógica compartilhada, um servidor MCP para o CRM, um workflow de enriquecimento profundo que o agente chama quando um lead precisa, e uma skill para as regras de pontuação. Em geral, comece com um bloco e passe para uma ferramenta de agente quando um modelo deve decidir. Recorra ao resto só quando precisar de reuso, de um toolset externo, de um sub-workflow ou de orientação escrita.
Próximos passos
Construindo agentes
Os recursos que permitem a um agente agir, seguir instruções e usar seus dados.
Referência do bloco Agent
Cada modelo, configuração e campo de saída.
Usando ferramentas MCP
Conecte um servidor MCP externo aos seus agentes.
Skills
Escreva instruções reutilizáveis que os agentes podem carregar.