Configurando um agente de IA para seu aplicativo

Os agentes de IA transformam conversas simples em ações no seu aplicativo da Base44. Em vez de apenas responder com texto, eles atualizam registros, disparam fluxos de trabalho e se conectam a ferramentas para que você possa executar mais do seu processo em uma única conversa.

Aiagentexample — Using an AI agent to take actions and manage data in your app

Cada agente entende os dados do seu aplicativo e pode pesquisar na web, chamar funções de backend e seguir diretrizes detalhadas que você define. Você pode moldar o tom e a persona, decidir quais ferramentas ele pode usar e escolher o modelo de IA que impulsiona seu raciocínio. Por padrão, os agentes usam um modelo Automatic otimizado para respostas rápidas e econômicas, então tudo continua funcionando como antes a menos que você decida mudar. A memória está ativada por padrão para novos agentes, então cada interação parece mais pessoal e consistente desde o início. Seu agente pode lembrar detalhes importantes entre conversas, como preferências, escolhas passadas ou conhecimento compartilhado, e trazer esse contexto de volta na próxima vez que alguém entrar em contato. Os agentes descobrem automaticamente qual ferramenta usar com base no seu aplicativo e solicitação.

Exemplos:

“Marque minha reserva de férias de verão como concluída” → usa a ferramenta update_task.
“Qual foi o local mais visitado na Europa em 2024?” → usa a ferramenta google_search.
“Adicione 15 novas tarefas” → usa a ferramenta insert_task_records.

Configurando um agente de IA

Antes de começar a trabalhar com agentes de IA, você precisa ativá-los no painel do seu aplicativo. Em seguida, pode começar a criá-los usando o chat de IA. Você pode ativar agentes para todos os novos aplicativos por padrão nas configurações da sua conta no seu workspace.

Quando você conversa com um agente de IA, a Base44 usa créditos de integração. O preço começa em cerca de 3 créditos de integração por mensagem com o modelo padrão e varia com base no modelo selecionado e no tamanho da resposta.

Para configurar um agente de IA:

Vá para Dashboard no editor do seu aplicativo.
Clique em Agents.
Escolha um modelo de agente sugerido ou clique em Create from scratch para definir o seu próprio.

Dicas:

Use um modelo sugerido para começar rapidamente com uma função de agente pré-construída e instruções que você pode personalizar.
Se você escolher Create from scratch, descreva o que deseja no chat de IA e o agente será construído com base na sua entrada.
Você pode ativar agentes para todos os novos aplicativos por padrão nas configurações da sua conta.

Personalizando seu agente de IA

Cada agente tem seu próprio painel de configuração com as seguintes seções:

Guidelines: Define o comportamento, persona, modelo de IA e arquivos de contexto do agente.
Tools: Controla quais dados e ferramentas o agente pode usar.
Connectors: Permite que usuários do aplicativo conectem suas próprias contas externas ao agente via OAuth.
Skills: Adiciona conjuntos de instruções reutilizáveis que dão ao agente comportamentos ou expertise específicos.
Memory: Decide como o agente lembra informações entre conversas.
WhatsApp: Conecta o agente ao WhatsApp para que as pessoas possam conversar pelo telefone.
Telegram: Conecta o agente ao Telegram para que as pessoas possam conversar de qualquer lugar.
LINE: Conecta o agente ao LINE para que as pessoas possam conversar pelo aplicativo LINE.

Configurando diretrizes

Use a aba Guidelines para definir como seu agente se comporta e qual modelo de IA ele usa.

Agentguidelines 2 — Configuring the description, instructions and AI model for your agent

Para personalizar as diretrizes do seu agente:

Vá para Dashboard no editor do seu aplicativo.
Clique em Agents.
Clique em Edit Agent no agente relevante.
Clique em Guidelines.
Atualize a Description para definir a função e o comportamento geral do agente.
Atualize as Instructions com regras detalhadas que seu agente deve seguir.
Em Context Files, clique em Upload files ou Choose from library para adicionar material de referência que o agente pode usar para responder perguntas. Por exemplo, manuais de produto, documentos de preços, políticas ou FAQs. Você pode adicionar até 10 arquivos.
Em AI Model, selecione o modelo que impulsiona seu agente. Mantenha Automatic selecionado para respostas rápidas e econômicas, ou escolha um modelo do Google Gemini, OpenAI GPT ou Anthropic Claude para raciocínio mais avançado.
Clique em Save.

Escolhendo um modelo de IA

Para a maioria dos agentes, você pode usar a opção Automatic. Ela é otimizada para tarefas de uso geral e fluxos de trabalho interativos e geralmente custa cerca de 3 créditos de integração por mensagem.Se precisar de mais controle, você pode escolher um modelo diferente. Abaixo está uma estimativa do uso de créditos com diferentes modelos:

Modelo	Melhor para	Aprox. créditos / mensagem
Automatic	Uso geral, respostas rápidas	~3
Gemini 3 Flash	Raciocínio mais forte com custo moderado	~5
GPT-5	Análise complexa e tarefas críticas em precisão	~15

Os créditos são aproximados e variam com base no tamanho da resposta. Modelos mais leves usam menos créditos, enquanto modelos mais poderosos usam mais. Você pode trocar de modelo a qualquer momento se suas necessidades mudarem.

Se não tem certeza de qual modelo usar, deixe Automatic selecionado. Você pode sempre mudar para um modelo mais poderoso depois para raciocínio avançado ou fluxos de trabalho pesados em análise.

Permitindo acesso anônimo

Por padrão, as pessoas precisam fazer login no seu aplicativo antes de poderem usar um agente. Você pode permitir que visitantes conversem com um agente sem fazer login ativando o acesso anônimo para esse agente, para que qualquer pessoa possa iniciar uma conversa imediatamente. Você pode ver as conversas anônimas na aba Users no seu painel de Agents, assim como as conversas de usuários logados. Veja como visualizar conversas do agente.

Este recurso ainda não está disponível para todos os usuários.

Quando o acesso anônimo está ativado, os visitantes podem conversar com o agente sem fazer login, na web e em canais conectados (WhatsApp e Telegram). Usuários anônimos não podem acessar dados privados por usuário, então mantenha isso desativado para agentes que gerenciam dados pessoais. Conversas anônimas também consomem créditos de integração do pool do seu workspace, o mesmo que usuários logados, então ative isso apenas para agentes que você deseja abertos a todos. A configuração está desativada por padrão e você a controla por agente. Para permitir acesso anônimo para um agente:

Vá para Dashboard no editor do seu aplicativo.
Clique em Agents.
Clique em Edit Agent no agente relevante.
Clique em Guidelines.
Ative o botão Allow anonymous access.
Clique em Save.

Allow anonymous access setting in the agent Guidelines tab — Turning on anonymous access in the agent's Guidelines tab

Gerenciando ferramentas e acesso a dados

Use a aba Tools para decidir o que seu agente pode fazer e quais dados pode acessar.

Você pode pedir ao chat de IA para adicionar ou atualizar ferramentas para seu agente. Descreva o que deseja que o agente faça e a IA configura as ferramentas certas automaticamente, sem que você precise configurá-las na aba Tools.

Setting the tools and capabilities of your agent

Para gerenciar as ferramentas de um agente:

Vá para Dashboard no editor do seu aplicativo.
Clique em Agents.
Clique em Edit Agent no agente relevante.
Clique em Tools.
Escolha quais ferramentas o agente pode usar. Por exemplo:
- Ferramentas de entidade para criar, ler, atualizar ou excluir registros.
- Funções de backend para enviar notificações, disparar automações ou chamar APIs externas.
Ajuste quaisquer permissões específicas da ferramenta para que o agente acesse apenas os dados necessários.
Clique em Save.

Você pode adicionar ou remover ferramentas a qualquer momento conforme seu aplicativo evolui. Por exemplo, você pode começar com ferramentas de entidade somente leitura e depois permitir atualizações após testar o agente.

Adicionando conectores de usuário

Use a aba Connectors para permitir que os usuários do seu aplicativo conectem suas próprias contas externas ao agente. Quando um conector está ativado, o agente pode criar links de conexão OAuth para que cada pessoa possa autorizar o acesso à sua própria conta nesse serviço diretamente de uma conversa. Por exemplo, em um aplicativo de consultor de viagens, cada usuário poderia conectar seu próprio Google Calendar para que o agente pudesse planejar e agendar itinerários em seu nome. Saiba mais sobre a configuração de conectores para usuários do aplicativo. Para adicionar um conector de usuário para seu agente:

No chat de IA, peça ao agente para adicionar um conector de usuário, por exemplo: Quero que os usuários do meu aplicativo conectem suas próprias contas do LinkedIn a este agente.
Quando o formulário aparecer, preencha os detalhes necessários. Estes variam por provedor, mas geralmente incluem um nome do conector, Client ID, Client Secret e os escopos que seu aplicativo precisa.
Siga as instruções na tela para autorizar o conector e escolher as permissões que serão solicitadas aos usuários do seu aplicativo.
Clique em Approve.

Dicas:

Antes de preencher o formulário ao adicionar um conector, certifique-se de já ter criado um aplicativo OAuth no console de desenvolvedor do provedor e ter o Client ID, Client Secret e escopos necessários prontos.
Se um conector de usuário já estiver configurado no seu workspace, ele aparece automaticamente na aba Connectors. Vá para Edit Agent, clique em Connectors, ative-o e clique em Save.
A aba Connectors também mostra quais funções de backend estão usando cada conector, para que você possa ver exatamente o que o agente pode fazer com ele.

Adicionando habilidades ao agente

Habilidades são conjuntos de instruções reutilizáveis que você anexa a um agente para dar a ele comportamentos, expertise ou políticas específicos. Você pode anexar até 10 habilidades por agente.

Adding skills to your app agent in Base44

Existem dois tipos de habilidades:

App Skills: Habilidades que você cria para um aplicativo específico. Uma vez criadas, podem ser reutilizadas em todos os agentes desse aplicativo.
Workspace Skills: Habilidades compartilhadas em todo o seu workspace. Saiba mais sobre gerenciar habilidades do workspace.

Para adicionar uma habilidade de aplicativo ao seu agente:

Vá para Dashboard no editor do seu aplicativo.
Clique em Agents.
Clique em Edit Agent no agente relevante.
Clique em Skills.
Clique em Add Skill em App Skills.
Escolha como criar a habilidade:
- Selecione Start from scratch para escrever suas próprias instruções.
- Selecione um modelo como refund-policy, support-escalation, pricing-and-plans ou brand-voice para começar a partir de uma estrutura pronta.
Insira um Skill name, uma Description opcional e suas Instructions.
Ative o botão Enable for current agent se quiser que a habilidade esteja ativa imediatamente.
Clique em Create Skill.
Clique em Save.

Para usar uma habilidade de workspace, role até Workspace Skills e ative qualquer habilidade que queira ativar para este agente.

Configurando a memória

A memória do agente permite que seu agente lembre informações importantes entre conversas, como preferências, fatos-chave ou conhecimento compartilhado. Você controla se as memórias são compartilhadas entre todos ou mantidas específicas para cada pessoa.

A memória está ativada por padrão para novos agentes.

Para ativar a memória do seu agente:

Vá para Dashboard no editor do seu aplicativo.
Clique em Agents.
Clique em Edit Agent no agente relevante.
Clique em Memory.
Clique no botão Enable Memory para ativar a memória.
Em Memory Scope, escolha como este agente salva memórias:
- Global & Per User: O agente pode criar memórias compartilhadas para todos e memórias pessoais para cada pessoa.
- Global Only: O agente cria memórias que são compartilhadas entre todos que conversam com ele.
- Per User Only: O agente cria memórias que são específicas para cada pessoa.
Em Memory Instructions, insira orientações que expliquem quando salvar memórias e o que incluir.
Depois que seu agente tiver algumas conversas, revise Saved Memories para ver o que o agente armazenou. Clique em Refresh para carregar novas memórias.
Clique em Save.

Use as instruções de memória para manter seu agente focado. Por exemplo:

Salve memórias globais para atualizações de produto, anúncios da empresa e conhecimento compartilhado.
Salve memórias de usuário para preferências pessoais como estilo de comunicação, tom e interesses específicos.

Conectando-se a canais de mensagens

Conecte seu agente a aplicativos de mensagens externos para que as pessoas possam conversar com ele sem abrir o seu aplicativo. Cada canal conectado tem as mesmas capacidades do seu agente no aplicativo, e você configura e conecta cada um separadamente.

Conecte seu agente ao WhatsApp para que as pessoas possam enviar mensagens diretamente ao agente do seu aplicativo pelo telefone, sem sequer abrir o aplicativo.

Um agente conectado ao WhatsApp pode fazer tudo o que seu agente no aplicativo faz. Isso inclui criar, ler, atualizar ou excluir entidades no seu aplicativo, disparar funções de backend como enviar notificações ou iniciar automações, e gerenciar os dados do seu aplicativo, como atualizar tarefas e adicionar registros. Se seu agente pode fazer isso dentro do seu aplicativo, ele pode fazer no WhatsApp também.

Informações sobre o uso do WhatsApp com seu agente

Este recurso está disponível gratuitamente em todos os planos.
Um total de 3 agentes no aplicativo podem ser conectados ao WhatsApp em todos os seus aplicativos. Este limite é separado das conexões do Superagent no WhatsApp, que têm seu próprio pool. Se tentar conectar mais de 3, será solicitado a desconectar um antes de continuar.
Cada agente recebe seu próprio número do WhatsApp.
Agentes do WhatsApp usam apenas créditos de integração. Nenhum crédito de mensagem é cobrado. Cada mensagem enviada ou recebida usa 1 crédito de integração para o relay do WhatsApp, mais créditos de integração adicionais para ações do agente como chamadas LLM, geração de imagens ou envio de e-mails.
Os visitantes do seu aplicativo não precisam instalar nada para usar agentes do WhatsApp. Basta tocar no botão do WhatsApp no seu aplicativo para iniciar um chat. As pessoas devem enviar a primeira mensagem, para ajudar a prevenir spam e mantê-las seguras. Uma vez que a conversa começa, o agente pode responder assim como faz dentro do seu aplicativo.
A conversa do WhatsApp suporta imagens e mensagens de voz.
Se seu aplicativo é público, as pessoas precisam fazer login no seu aplicativo antes de poderem usar o agente do WhatsApp. Isso garante que o agente possa identificar com quem está conversando e responder com base nos dados dela. Para permitir que as pessoas conversem sem fazer login, ative Allow anonymous access na aba Guidelines do agente. Usuários anônimos não podem acessar dados privados por usuário.

Para ativar o WhatsApp para seu agente:

Vá para Dashboard no editor do seu aplicativo.
Clique em Agents.
Clique em Edit Agent no agente relevante.
Clique em WhatsApp.
Clique em Send to Chat em Add WhatsApp to Your App para adicionar um botão do WhatsApp ao seu aplicativo.
Personalize a mensagem de boas-vindas do WhatsApp.
Clique em Save.

Whatsapp Agent — Connecting your app agent to WhatsApp

Conecte seu agente ao Telegram para que as pessoas possam enviar mensagens diretamente pelo Telegram, sem abrir o seu aplicativo. Um agente conectado ao Telegram tem as mesmas capacidades do seu agente no aplicativo. Ele pode criar, ler, atualizar ou excluir registros, disparar funções de backend e gerenciar os dados do seu aplicativo.

Informações sobre o uso do Telegram com seu agente

Todos os recursos do chat web funcionam perfeitamente no Telegram, incluindo ferramentas e acesso a dados.
Os usuários podem enviar notas de voz e imagens para uma interação natural.
Seu bot do Telegram é criado e conectado instantaneamente sem necessidade de configuração manual.
Para iniciar uma conversa, os usuários abrem seu bot no Telegram e enviam /start.
Você pode adicionar um botão do Telegram ao seu aplicativo para que os usuários abram o bot diretamente do seu aplicativo.

Para ativar o Telegram para seu agente:

Vá para Dashboard no editor do seu aplicativo.
Clique em Agents.
Clique em Edit Agent no agente relevante.
Clique em Telegram.
Clique em Connect Telegram Bot.
Siga as instruções no Telegram para criar e conectar seu bot.
Clique em Send to Chat em Add Telegram to Your App para adicionar um botão do Telegram ao seu aplicativo.
Personalize a mensagem de boas-vindas do Telegram.
Clique em Save.

LINE

Conecte seu agente ao LINE para que as pessoas possam enviar mensagens diretamente pelo aplicativo LINE, sem abrir o seu aplicativo. Um agente conectado ao LINE tem as mesmas capacidades do seu agente no aplicativo. Ele pode criar, ler, atualizar ou excluir registros, disparar funções de backend e gerenciar os dados do seu aplicativo.

Observações:

O LINE está disponível apenas no Japão.
As respostas do LINE são apenas em texto simples. Evite usar markdown ou HTML na sua mensagem de boas-vindas ou diretrizes.

Para ativar o LINE para seu agente:

Vá para Dashboard no editor do seu aplicativo.
Clique em Agents.
Clique em Edit Agent no agente relevante.
Clique em LINE.
Escaneie o código QR ou copie o código de ativação, abra o LINE no seu telefone, adicione o bot da Base44 e envie o código de ativação para conectar.
Clique em Send to Chat em Add LINE to Your App para adicionar um botão do LINE ao seu aplicativo.
Personalize a mensagem de boas-vindas do LINE.
Clique em Save.

Os códigos de ativação expiram após 30 minutos. Se o seu expirou, clique em Regenerate Code para obter um novo.

Visualizando quem usa seus agentes

A aba Users no seu painel de Agents mostra cada usuário do aplicativo que conversou com um dos seus agentes. Para cada usuário, você pode ver sua função, quantos agentes ele usou, seu total de conversas e créditos usados. Você pode classificar a lista por agentes, conversas ou créditos.

Agent users tab — Viewing agent users in your app dashboard

Você pode aprofundar de um usuário até suas conversas com um agente específico e abrir qualquer conversa para ler a transcrição completa. Para visualizar usuários do agente:

Vá para Dashboard no editor do seu aplicativo.
Clique em Agents.
Clique na aba Users.
Clique em uma linha de usuário para ver com quais agentes ele conversou e quantas conversas e créditos cada agente usou.
Clique em View ao lado de um agente para ver a lista completa de conversas desse usuário com ele.
Clique em uma conversa para ler a transcrição completa, incluindo mensagens, chamadas de ferramentas e créditos usados.

Dicas:

Use a barra de pesquisa para encontrar alguém pelo nome ou e-mail.
Use Filter by para filtrar por agente ou função (User, Editor ou Admin).
Use o seletor de datas para filtrar por hoje, últimos 7 dias, últimos 30 dias ou todo o tempo.
Clique em um cabeçalho de coluna para classificar por agentes, conversas ou créditos.

Perguntas frequentes

Clique em uma pergunta abaixo para saber mais sobre agentes de IA.

Por que vejo um erro "Failed to send message" ou 404 ao enviar mensagens a um agente?

Isso pode acontecer se houver uma entidade vazia nas configurações de Tools and Capabilities do agente.Para resolver isso:

Abra as configurações do seu agente.
Clique na aba Tools and Capabilities.
Atualize ou remova a entidade vazia.
Clique em Save.

Após a atualização, você deve conseguir enviar mensagens sem erros.

Posso usar agentes no plano gratuito?

Sim. Os agentes estão disponíveis em todos os planos, incluindo o plano Free.

Posso ativar agentes para todos os aplicativos na minha conta?

Você pode ativar os agentes por padrão para cada novo aplicativo criado.Quando o botão Enable agents for new apps by default está ativado em suas Account settings, cada novo aplicativo tem automaticamente o botão AI Agents ativado em seu painel para que você possa começar a adicionar e configurar agentes imediatamente.Esta configuração não altera aplicativos existentes. Para ativar ou desativar agentes para um aplicativo existente, abra o Dashboard desse aplicativo, clique em Agents e ajuste o botão AI Agents lá.Para ativar agentes por padrão para novos aplicativos:

Clique no ícone do seu perfil no canto superior direito do seu workspace.
Clique em Settings.
Clique em Account settings.
Ative o botão Enable agents for new apps by default na seção Default Agents.

Quais são os benefícios de usar agentes?

Os agentes são ferramentas flexíveis e poderosas que ajudam você a:

Automatizar tarefas repetitivas.
Obter respostas informadas em tempo real.
Manter seu fluxo de trabalho dentro de um aplicativo.
Escolher as ferramentas certas automaticamente.

Onde posso encontrar meu histórico de conversas com um agente?

Vá para Dashboard, clique em Agents e clique na aba Users. Clique em um usuário para ver suas conversas por agente, depois clique em View para abrir a lista de conversas. Clique em qualquer conversa para ler a transcrição completa.

Como o modelo de IA que escolho afeta créditos e comportamento?

O modelo de IA que você escolhe afeta tanto como seu agente se comporta quanto quantos créditos de integração ele usa.

A opção padrão Automatic (baseada no Gemini 2.5 Flash) oferece respostas rápidas e de uso geral por cerca de 3 créditos por mensagem.
Modelos como Gemini 3 Flash fornecem raciocínio mais forte com um aumento moderado em créditos.
Modelos de alto nível como GPT-5 são projetados para análise complexa e decisões críticas em precisão e geralmente usam mais créditos por mensagem.

Se não tem certeza de qual modelo usar, mantenha Automatic selecionado para obter um bom equilíbrio de velocidade, qualidade e custo.

Quantas habilidades posso adicionar a um agente?

Você pode anexar até 10 habilidades por agente. As habilidades podem ser uma combinação de habilidades de aplicativo que você mesmo cria e habilidades de workspace compartilhadas em todo o seu workspace.

Como vejo quantos créditos meu agente usou?

Em Agents no painel do seu aplicativo, você pode ver o total de créditos usados por um agente diretamente abaixo do seu nome.

Qual é a diferença entre habilidades de aplicativo e habilidades de workspace?

Habilidades de aplicativo são criadas dentro de um aplicativo específico e podem ser reutilizadas em todos os agentes desse aplicativo. Habilidades de workspace são compartilhadas em todo o seu workspace e são gerenciadas nas configurações do seu workspace. Você pode alternar habilidades de workspace ativadas ou desativadas para agentes individuais sem editar a própria habilidade.

Posso disparar uma automação quando alguém iniciar uma conversa com meu agente?

Sim. Você pode configurar uma automação de agente no aplicativo que roda no momento em que uma nova conversa começa com seu agente. Use isso para ser notificado quando um cliente entra em contato, adicioná-lo aos seus contatos automaticamente ou enviar a si mesmo um resumo no final do dia.Quando você clica em New Automation, a Base44 mostra sugestões com base no contexto do seu aplicativo. Se seu aplicativo tem um agente, os gatilhos de agente no aplicativo aparecem na lista Suggested for you automaticamente. Você também pode clicar em Create from scratch e selecionar In-app agent como o tipo de gatilho.Saiba mais sobre a criação de automações.

Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a versão em inglês.

Começando

Superagentes

Criando seu app

Protegendo seu app

Promovendo seu app

Conectores

Integrações

Configurando um agente de IA para seu aplicativo

Configurando um agente de IA