Configure um agente de IA para seu aplicativo, escreva as diretrizes dele, escolha ferramentas e acesso a dados, adicione habilidades e memória e conecte-o ao WhatsApp, Telegram ou LINE.
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.
Usando um agente de IA para realizar ações e gerenciar dados no seu 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.
Os agentes de IA estão disponíveis em todos os aplicativos, então você pode começar a criá-los agora mesmo usando o chat de IA.
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.
Criando um agente no app
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 é construído com base na sua entrada.
Depois que a IA cria ou edita um agente, um card dele aparece no chat. Clique no card para abrir esse agente no editor.
Use a aba Guidelines para definir como seu agente se comporta e qual modelo de IA ele usa.
Definindo as instruções, os arquivos de contexto e o modelo do seu agente
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 dos modelos Google Gemini, OpenAI GPT, Anthropic Claude ou GLM 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 começa em cerca de 3 créditos de integração por mensagem, aumentando com o tamanho da resposta.Se precisar de mais controle, você pode escolher um modelo diferente. O custo de uma mensagem depende do modelo escolhido e do tamanho da resposta. Veja como os outros modelos se comparam ao Automatic:
Custo em comparação com Automatic
Modelos
Mais ou menos o mesmo
GPT-6 Luna
Várias vezes mais
Gemini 3.8 Flash, GLM 5.2, Claude Sonnet 5
Muitas vezes mais
Claude Opus 5.5, GPT-6.1 Sol
O mais caro
GPT-6 Astra, Claude Fable 5.1
Uma resposta longa em um modelo mais barato pode custar mais que uma resposta curta em um mais caro. Trate isso como um guia e verifique Credits Used em uma mensagem para saber o custo real. Você pode trocar de modelo a qualquer momento se suas necessidades mudarem.
Os modelos que você pode escolher para um agente
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.
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.
Turning on anonymous access in the agent's Guidelines tab
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.
Definindo as ferramentas de um agente
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, iniciar workflows 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.
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.
Conector de usuário configurado na aba Connectors de um agente
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.
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.
Adicionando habilidades a um agente
Existem 2 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.
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.
Ativando a memória do seu agente
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.
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.
Conectando seu agente ao WhatsApp
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 workflows, 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.
Usando seu agente no WhatsApp
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, você precisa 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.
As conversas do WhatsApp suportam imagens e mensagens de voz.
Seu agente também lê localizações e contatos compartilhados. Uma localização chega com suas coordenadas, nome do lugar e endereço. Um contato chega como nome e número de telefone, sem nada mais do cartão de contato.
Seu agente consegue perceber que alguém enviou uma figurinha, mas não o que a figurinha mostra.
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.
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.
As pessoas podem enviar notas de voz e imagens para uma interação natural.
Seu agente também lê localizações, figurinhas e contatos compartilhados. Um pin ou lugar nomeado chega com suas coordenadas e endereço. Uma figurinha chega como o emoji que ela representa, e um contato como nome e número de telefone, sem nada mais do cartão de contato.
Uma localização em tempo real dá ao seu agente um único registro do momento em que foi compartilhada, não atualizações contínuas.
Seu bot do Telegram é criado e conectado instantaneamente sem necessidade de configuração manual.
Para iniciar uma conversa, as pessoas abrem seu bot no Telegram e enviam /start.
Você pode adicionar um botão do Telegram ao seu aplicativo para que as pessoas 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.
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.
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.
Visualizando os usuários do agente no dashboard do seu app
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.
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.
Ferramentas de entidade e suas operações
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.
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.
Automatic escolhe um modelo rápido e de uso geral para cada mensagem e começa em cerca de 3 créditos, aumentando com o tamanho da resposta.
GPT-6 Luna custa mais ou menos o mesmo que o Automatic.
Gemini 3.8 Flash, GLM 5.2 e Claude Sonnet 5 custam várias vezes o Automatic.
Claude Opus 5.5 e GPT-6.1 Sol custam muitas vezes o Automatic.
GPT-6 Astra e Claude Fable 5.1 são feitos para o raciocínio mais difícil e são as opções mais caras.
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.
Créditos usados por um agente
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 iniciar um workflow quando alguém iniciar uma conversa com meu agente?
Sim. Um workflow com o gatilho In-app agent roda no momento em que alguém inicia uma nova conversa com seu agente. Use-o 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.Peça ao chat de IA para configurá-lo, por exemplo Quando alguém iniciar uma conversa com meu agente, envie para o meu e-mail o nome da pessoa e a primeira mensagem. Saiba mais sobre como criar workflows.
Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a versão em inglês.
Esta página foi útil?
Assistant
Responses are generated using AI and may contain mistakes.
