Primeiros passos

Construa seu primeiro workflow de IA em 10 minutos. Neste tutorial, você vai criar um agente de pesquisa de pessoas que usa ferramentas de busca avançadas baseadas em LLM para extrair e estruturar informações sobre indivíduos.

O que você vai construir

Um agente de pesquisa de pessoas que:

  1. Recebe a entrada do usuário por uma interface de chat
  2. Pesquisa na web com ferramentas de IA (Exa e Linkup)
  3. Extrai e estrutura informações sobre indivíduos
  4. Retorna dados JSON formatados com localização, profissão e formação

Tutorial passo a passo

Clique em New Workflow no dashboard e dê a ele o nome "Getting Started".

Todo novo workflow já inclui um Start block por padrão — é o ponto de entrada que recebe a entrada do usuário. Como vamos disparar este workflow pelo chat, o Start block não precisa de nenhuma configuração.

Arraste um Agent Block do painel esquerdo para o workflow builder e configure:

  • Model: selecione "OpenAI GPT-4o"
  • System Prompt: "You are a people research agent. When given a person's name, use your available search tools to find comprehensive information about them including their location, profession, educational background, and other relevant details."
  • User Prompt: arraste a conexão da saída do Start block para este campo para conectar <start.input> ao user prompt

Amplie seu agente com busca na web. Clique no Agent block para selecioná-lo.

Na seção Tools:

  • Clique em Add Tool
  • Selecione Exa e Linkup entre as ferramentas disponíveis
  • Informe suas chaves de API para as duas ferramentas para habilitar a busca na web e o acesso aos dados

Teste seu workflow no Chat panel, no lado direito da tela.

No chat panel:

  • Clique no dropdown e selecione agent1.content para ver a saída do agente
  • Digite uma mensagem de teste: "John is a software engineer from San Francisco who studied Computer Science at Stanford University."
  • Clique em Send para executar o workflow

O agente vai analisar a pessoa e retornar informações estruturadas.

Configure seu agente para retornar dados JSON estruturados. Clique no Agent block para selecioná-lo.

Na seção Response Format:

  • Clique no ícone de varinha mágica (✨) ao lado do campo de schema
  • Digite o prompt: "create a schema named person, that contains location, profession, and education"
  • A IA gera o schema JSON automaticamente

Volte ao Chat panel para testar o formato de resposta estruturado.

Com o response format configurado, novas opções de saída ficam disponíveis:

  • Clique no dropdown e selecione a opção de saída estruturada (o schema que você acabou de criar)
  • Digite uma mensagem de teste: "Sarah is a marketing manager from New York who has an MBA from Harvard Business School."
  • Clique em Send para executar o workflow

Agora o agente retorna a saída em JSON estruturado, com as informações da pessoa organizadas nos campos de localização, profissão e formação.

O que você construiu

Você criou um workflow de IA que:

  • ✅ Recebe a entrada do usuário por uma interface de chat
  • ✅ Processa texto não estruturado com IA
  • ✅ Integra ferramentas de busca externas (Exa e Linkup)
  • ✅ Retorna dados JSON estruturados com schemas gerados por IA
  • ✅ Demonstra testes e iteração em tempo real
  • ✅ Mostra o poder de construir visualmente, por conversa ou com código

Conceitos principais que você aprendeu

Tipos de block usados

Start Block
Agent Block

Conceitos essenciais de workflow

Fluxo de dados
Conecte blocks arrastando as conexões para passar dados entre as etapas do workflow

Interface de chat
Teste workflows em tempo real no chat panel e escolha entre diferentes opções de saída

Integração de ferramentas
Amplie o que o agente faz integrando serviços externos como Exa e Linkup

Referências de variáveis
Acesse a saída dos blocks com a sintaxe <blockName.output>

Saída estruturada
Defina schemas JSON para garantir respostas consistentes e formatadas da IA

Schemas gerados por IA
Use a varinha mágica (✨) para gerar schemas a partir de prompts em linguagem natural

Desenvolvimento iterativo
Construa, teste e refine workflows rapidamente, com feedback imediato

Próximos passos

Explore os blocks

Conheça os blocks API, Function, Condition e outros

Veja as integrações

Conecte mais de 1.000 serviços, incluindo Gmail, Slack, Notion e muitos outros

Adicione lógica personalizada

Escreva funções próprias para processamento de dados avançado

Faça o deploy do seu agente

Deixe seu agente acessível por REST API ou webhooks

Recursos

Precisa de explicações detalhadas? Acesse a documentação de blocks para guias completos de cada componente.

Procurando integrações? Explore a documentação de Tools para ver todas as mais de 1.000 integrações disponíveis.

Pronto para ir ao ar? Veja Execução e deploy para deixar seus workflows prontos para produção.

Common Questions

Cerca de 10 minutos. O tutorial mostra como criar um agente de pesquisa de pessoas com ferramentas de busca na web e saída estruturada. No final, você terá um workflow totalmente funcional.
Você precisa de chaves de API para as ferramentas de busca usadas no tutorial (Exa e Linkup). Para o modelo de IA, você pode usar as chaves hospedadas do Studio (incluídas nos créditos do seu plano) ou usar sua própria chave da OpenAI. Se preferir não configurar as chaves das ferramentas de busca, ainda é possível montar um workflow básico de agente sem elas.
Não. Todo o tutorial usa a interface visual de arrastar e soltar. Você vai conectar blocks, ajustar configurações e testar pelo chat panel sem escrever nenhuma linha de código.
Sim. O bloco Agent aceita modelos da OpenAI, Anthropic, Google, Groq, Cerebras, DeepSeek, Mistral, xAI e outros. Você pode selecionar qualquer modelo disponível no dropdown. Com auto-hospedagem, também é possível usar modelos locais pelo Ollama.
O Studio ainda não permite importar workflows de outras plataformas. Em vez disso, você pode usar o Chat para descrever em linguagem natural o que quer e deixar o Studio montar o workflow, o que costuma ser mais rápido do que recriar tudo à mão.
Use o Chat panel para testar em ciclos curtos e inspecionar a saída de cada block. Clique no dropdown para ver a saída de blocks diferentes e descobrir onde está o problema. Os logs de execução (na aba Logs) mostram informações detalhadas de cada etapa, incluindo uso de tokens, custos e erros.
Explore a documentação de blocks para conhecer os blocks Condition, Router, Function e API. Veja a seção Tools para descobrir mais de 1.000 integrações que você pode adicionar aos seus agentes. Quando estiver pronto para o deploy, consulte a documentação de execução para conhecer as opções de REST API, webhook e triggers agendados.
IntroduçãoChat