Primeiros passos

Construa um agente de pesquisa de pessoas em 10 minutos. Ele recebe um nome por uma interface de chat, busca na web com ferramentas de busca por IA e devolve JSON estruturado com localização, profissão e formação da pessoa.

Tutorial

Na barra lateral, clique no + ao lado de Workflows e nomeie o novo workflow como "Getting Started". O bloco Start já está no canvas — é o ponto de entrada que recebe a entrada do chat.

Arraste um bloco Agent para o canvas e configure as Messages:

System: "You are a people research agent. When given a person's name, use your search tools to find their location, profession, educational background, and other relevant details."
User: insira <start.input> para o agente ler o que o chat receber.

Deixe o Model no padrão (claude-sonnet-4-6), ou escolha outro.

Na seção Tools do bloco Agent, adicione Exa e Linkup. O agente decide quando chamá-las.

Abra o painel Chat, selecione agent1.content como saída a exibir e envie: "John is a software engineer from San Francisco who studied Computer Science at Stanford University."

O agente busca e depois devolve o que encontrou.

Se a execução não ficar verde, abra o dropdown de saída e leia o que cada bloco devolveu — a falha quase sempre aparece ali. As duas causas mais comuns são uma chave de API ausente em uma ferramenta e uma referência apontando para um valor que não está lá. Para o método completo, veja rastreando uma falha de trás para frente.

Em Response Format do bloco Agent, clique na varinha mágica (✨) e peça: "create a schema named person, that contains location, profession, and education". O schema é gerado para você.

De volta ao painel Chat, selecione a nova opção de saída estruturada e envie: "Sarah is a marketing manager from New York who has an MBA from Harvard Business School."

O agente agora devolve JSON com os campos location, profession e education — prontos para qualquer bloco seguinte ler pelo nome.

Próximos passos

Workflows

O modelo completo: blocos, conexões, triggers e como as execuções rodam.

Bloco Agent

Tudo o que o bloco que você acabou de usar pode fazer — tools, memory, skills, saída estruturada.

Integrações

Mais de 1.000 serviços em que seus agentes podem agir, de Gmail a HubSpot.

Publique

Entregue o workflow como API, chat ou servidor MCP.

Common Questions

Cerca de 10 minutos. Ao final você terá um workflow funcionando de ponta a ponta.

Não. No Zoen hospedado, o modelo e as ferramentas de busca rodam nas chaves hospedadas do Zoen, incluídas nos créditos do seu plano. Você pode trazer suas próprias chaves de provedor se preferir.

Não. O tutorial inteiro usa o builder visual e o painel de chat — sem código.

Sim. O bloco Agent oferece suporte a modelos da OpenAI, Anthropic, Google, Groq, Cerebras, DeepSeek, xAI e mais, além de modelos locais via Ollama se você fizer self-host.

Não diretamente. Mas você pode descrever o que quer ao Mothership em linguagem natural e deixá-lo construir o workflow para você, o que costuma ser mais rápido do que recriar na mão.

Teste de forma iterativa no painel Chat e inspecione a saída de cada bloco no dropdown para achar onde as coisas saem do rumo. A página Logs registra toda execução, bloco a bloco, com entradas, saídas, timing e custo.