Crie seu primeiro agente de IA

Criar um agente envolve definir uma tarefa, montar o cenário, configurar o modelo, adicionar ferramentas e conhecimento e conferir os resultados. Este guia acompanha a documentação do Make AI Agent (New) consultada em 26 de setembro de 2026; a captura anterior usava o rótulo Make AI Agents (New) > Run an agent (New).

1. Planeje a tarefa

Defina o que o agente fará, quais dados receberá, quais ferramentas poderá usar e que material de referência precisa consultar. O exemplo do Make é um especialista em conteúdo com uma planilha de pautas, ferramentas de trabalho e um guia de estilo.

2. Monte o cenário

1. Entre no Make e clique em Create scenario.
2. Clique no botão de adição e escolha o aplicativo que fornecerá as informações.
3. Selecione e configure o módulo adequado à entrada.
4. Abra o ícone de relógio e ajuste Schedule settings.
5. Salve o módulo e o cenário.

A execução imediata ao chegar um evento corresponde aos gatilhos identificados como instant. Consulte agendamento de cenários para escolher o comportamento correto.

Se o agente precisa de dados complementares, adicione módulos antes dele, como uma etapa de download. Configure e salve cada módulo.

No botão de adição ao lado do último módulo, pesquise Make AI Agent (New) e selecione Run an agent.

3. Configure o agente

Provedor e modelo

Antes de selecionar Connection type, confira a seção Choose an AI provider and model do guia oficial. Na versão consultada em 26 de setembro de 2026, a orientação distingue Make's AI Provider para contas no plano Free de conexões personalizadas com provedores, oferecidas para planos pagos. Contas em planos pagos também podem escolher Make's AI Provider. Uma conta Free não deve seguir o caminho de uma conexão personalizada presumindo a mesma elegibilidade. Para essa condição de acesso, prevalece o guia técnico do recurso; preços não são tratados aqui.

1. Em Connection, selecione uma conexão existente ou clique em Add.
2. Escolha o tipo de conexão oferecido para sua conta.
3. Dê um nome e preencha os campos solicitados. Se houver uma chave de API, obtenha-a na conta do provedor.
4. Salve e escolha o Model.

Considere o tipo de tarefa ao escolher o modelo. Não presuma que todos os modelos aceitam os mesmos arquivos ou oferecem as mesmas opções.

Instruções e entrada

Em Instructions, descreva o papel, os objetivos, o comportamento e a forma de executar a tarefa.

Em Input, escreva a solicitação daquela execução ou mapeie os dados dos módulos anteriores. Para arquivos, preencha Input files, informando File name e mapeando o conteúdo em Data.

Confirme o suporte a arquivos na documentação do modelo e na referência atual indicada pelo Make. Arquivos de entrada e arquivos de conhecimento cumprem funções diferentes.

Conversa e formato de resposta

• Conversation ID: use um identificador ou mapeie o ID de uma conversa anterior. Sem esse valor, o agente gera um novo ID a cada execução e não mantém aquela continuidade.
• Maximum conversation history: em Advanced settings, ajuste o histórico da conversa quando usar um ID.
• Step timeout: configure o tempo de execução por etapa conforme a documentação e a interface.
• Response format: escolha Text para texto ou Data structure para uma estrutura personalizada.

Salve as configurações.

4. Adicione ferramentas

Módulos

1. Passe o cursor sobre o botão de adição do agente e clique em Add tool.
2. Pesquise o aplicativo e escolha o módulo correspondente à ação.
3. Configure e salve.
4. Se necessário, clique em Tool settings na rota e escolha os Tool outputs que o agente receberá.

A documentação atual informa que metadados internos são excluídos das saídas por padrão; inclua-os apenas quando necessários.

Um cenário existente

1. Em Add tool, pesquise Scenarios.
2. Escolha Call a scenario.
3. Selecione o cenário em Scenario.
4. Em Description, explique a função e quando utilizá-lo.
5. Em Wait for the scenario to finish, escolha Yes se o agente precisar esperar o resultado.
6. Salve.

Para devolver dados, o cenário chamado precisa terminar com o módulo de retorno de saídas.

Um novo cenário

1. No mesmo módulo Call a scenario, escolha Create scenario.
2. Dê nome e descrição ao cenário.
3. Defina as entradas e saídas.
4. Clique em Create scenario.
5. Acrescente os módulos entre os módulos Scenarios.
6. Mapeie as entradas nos campos necessários.
7. Mapeie as saídas em Scenarios > Return output.
8. Ative On demand na barra do cenário e salve.

Servidores MCP

Na documentação atual, Add MCP permite selecionar ou criar uma conexão em Connection. Em Tools, escolha as ferramentas que o agente poderá acessar e salve. Restrinja a seleção ao necessário para a tarefa.

Outros agentes

A referência atual também descreve agentes como ferramentas:

1. Em Add tool, escolha Make AI Agent (New) > Run an agent.
2. Em Tool settings, escreva Tool name e Tool description para o agente principal entender a finalidade.
3. Selecione a conexão e o modelo, ou a opção Let AI Agent decide quando oferecida.
4. Defina as Instructions do agente auxiliar.
5. Para Input e Input files, escolha Let AI Agent decide quando a entrada deve vir do agente principal.
6. Em Conversation ID, decida entre um novo identificador por execução e um ID específico.
7. Ajuste Tool outputs se precisar filtrar o retorno.

O agente principal usa o nome e a descrição para escolher essa ferramenta; não recebe automaticamente as instruções e ferramentas do agente auxiliar. Confira as condições de uso na referência oficial antes de projetar encadeamentos de agentes.

5. Adicione conhecimento

Conhecimento é material de referência, como um glossário ou guia de estilo. A documentação descreve a recuperação de trechos relevantes, em vez de colocar todo o arquivo em cada solicitação.

Envio direto

1. No botão de adição do agente, abra Knowledge.
2. Em Knowledge files, clique em Upload files e Choose file.
3. Selecione um arquivo aceito pela interface e salve.
4. Clique no lápis ao lado do arquivo e confira a Description gerada.
5. Em Advanced settings, ajuste a consulta e a quantidade de resultados, ou deixe o agente decidir.
6. Salve.

Pelo app Knowledge

Para arquivos atualizados com frequência, a fonte apresenta um cenário separado:

1. Crie um cenário com um módulo de download, por exemplo Google Drive > Download a File.
2. Configure, salve e execute Run once para obter dados mapeáveis.
3. Adicione Knowledge > Upload knowledge.
4. Mapeie o nome em File name e o conteúdo em File content.
5. Salve e execute Run once para carregar o material.

Separar esse fluxo evita repetir o upload em toda execução do cenário principal. A fonte também descreve o download e o upload após o agente no cenário principal; considere em qual execução o conhecimento deve estar disponível.

6. Teste antes de ativar

Conversar com o agente

Abra Chat no botão de adição ou Chat with Agent no menu do módulo. Envie uma solicitação de exemplo, confira a resposta e expanda ferramentas com indicação de erro. Ajuste instruções, ferramentas ou conhecimento e repita.

Executar com dados anteriores

Abra a seta ao lado de Run once, escolha uma execução em Scenario run e execute novamente para avaliar o comportamento com aqueles dados.

Desativar uma ferramenta para comparar

Clique com o botão direito na rota da ferramenta e selecione Disable tool. Para reativar, use Enable tool. O agente chama somente ferramentas habilitadas.

Inspecionar os resultados

Abra History, escolha Details em uma execução com erro e clique na bolha de saída. Em Output, examine Response e Metadata > Execution steps. A aba Reasoning contém informações adicionais apresentadas pela interface.

Recomendação editorial: teste com dados e ações de baixo risco. O chat pode chamar ferramentas; testar não significa que ações externas sejam apenas simuladas. Este guia não relata um teste próprio.

Duplicar ou excluir

• Clone, no menu do módulo, duplica somente o agente. Reconecte-o, revise as configurações e salve.
• Para copiar agente e ferramentas, selecione o conjunto com Shift e arraste no canvas. Use Ctrl+C / Ctrl+V no Windows ou Command+C / Command+V no Mac. Reconecte, revise e salve.
• Delete module remove o módulo do agente.
• Para excluir o cenário inteiro, abra Scenarios, localize-o e use o menu de três pontos > Delete.

Como próximo exemplo, consulte o caso de agente para prospecção de vendas.

Fonte

Documentação oficial do Make, consultada em 26 de setembro de 2026.