Escolhendo o que usar

Quando você constrói um agente, vários recursos se sobrepõem: um block determinístico e uma ferramenta de agente podem executar a mesma integração, e uma ferramenta personalizada, uma ferramenta MCP e um workflow como ferramenta podem dar ao agente a mesma ação. Esta página mostra as diferenças para você escolher a opção certa. Elas variam em três eixos: se a ação é determinística (sempre executa) ou decidida pelo modelo (um agente escolhe), se ela vive em um único workflow ou é reutilizável em todo o workspace, e se vem do Studio ou de um provedor externo.

O exemplo usado em toda a página é um workflow que pontua leads de vendas recebidos. Ele lê um novo lead, enriquece os dados, decide uma pontuação, registra o resultado e avisa o time. Cada opção abaixo constrói uma parte dele:

Block determinístico

Um block é um único passo que executa em um ponto fixo do caminho, sem nenhum modelo decidindo se deve ou não. Ele sempre executa quando o workflow chega até ele. Use um block quando a ação precisa acontecer todas as vezes: uma chamada de API, uma transformação de dados, uma ramificação.

No agente de pontuação de leads, um block Google Sheets sempre acrescenta o lead pontuado a uma planilha de acompanhamento, e um block Function sempre reorganiza a resposta do enriquecimento nos campos que o passo seguinte espera. Não há decisão a tomar. O trabalho é garantido.

A maioria dos passos de um workflow são blocks. Recorra aos tipos abaixo apenas 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 block Agent. O agente lê a tarefa e decide se e quando chamá-la. O mesmo catálogo de integrações que existe como blocks independentes também pode ser anexado a um agente como ferramentas.

No agente de pontuação de leads, o Agent tem uma ferramenta Search e uma ferramenta Send Email. Para um lead com perfil pobre, ele executa Search para reunir contexto; para um lead promissor, chama Send Email. Um lead pobre e óbvio pode não acionar nenhuma das duas. O agente escolhe em cada execução.

Cada ferramenta tem 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.

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 depois reutiliza em todo o workspace. Ela não exige nenhuma conta externa. Use uma quando tiver lógica que vários agentes ou workflows duplicariam.

No agente de pontuação de leads, uma ferramenta personalizada normalizeCompanyDomain transforma um site cru em um domínio canônico. A mesma ferramenta atende o agente de pontuação, um workflow de deduplicação e um agente de relatórios. Defina-a no workspace e depois selecione-a na lista de ferramentas de qualquer block Agent.

Servidor MCP

MCP (Model Context Protocol) é um padrão para conectar um provedor externo de ferramentas. Conecte um servidor MCP e as ferramentas dele aparecem em conjunto na lista de ferramentas do agente. Use isso para trazer um conjunto completo de ferramentas que o Studio não oferece nativamente, em vez de ligar cada ação na mão.

No agente de pontuação de leads, o fornecedor do seu CRM disponibiliza um servidor MCP. Depois de conectá-lo uma vez, o agente pode ler contas e atualizar registros pelas ferramentas do próprio fornecedor. A diferença em relação a uma ferramenta personalizada é quem mantém: uma ferramenta personalizada é código que você escreveu, enquanto um servidor MCP é uma caixa de ferramentas mantida por outra pessoa.

Workflow como ferramenta

Um workflow como ferramenta é um workflow inteiro entregue ao agente como uma única ferramenta chamável. Você seleciona o workflow na lista de ferramentas do block Agent; o agente decide quando chamá-lo e fornece as entradas, que chegam ao trigger Start do workflow filho, e o resultado do filho volta como saída da ferramenta. Use isso quando um procedimento de vários passos deve ficar à disposição do agente, e não no caminho.

No agente de pontuação de leads, o agente tem um workflow Deep Enrich como ferramenta — um procedimento próprio de cinco passos. Para um lead pobre, o agente o chama para completar o perfil antes de pontuar; para um lead completo, ele nunca executa. O agente pesa um procedimento inteiro do mesmo jeito que pesa uma única ação.

Skill

Uma skill é um conjunto de instruções reutilizáveis, um manual escrito que o agente pode seguir. Cada skill tem um nome curto e uma descrição que ficam sempre visíveis para o agente, além de um corpo mais longo que o agente carrega só quando decide que a skill se aplica. Use uma skill para registrar como algo deve ser feito, separado das ferramentas que fazem.

No agente de pontuação de leads, uma skill lead-scoring-rubric detalha as faixas e os critérios de desqualificação. 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 executa, e uma skill é orientação que o agente lê. Gerencie as skills no seu workspace.

Juntando tudo

O agente de pontuação de leads usa os seis tipos ao mesmo tempo: blocks para os passos que sempre devem executar, ferramentas de agente para as chamadas que o modelo deve avaliar, 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 block e passe para uma ferramenta de agente quando um modelo deve decidir. Recorra ao resto apenas quando precisar de reutilização, de um conjunto de ferramentas externo, de um sub-workflow ou de orientação escrita.

Próximos passos