
Configurando um agente de IA
Antes de começar a trabalhar com agentes de IA, você precisa habilitá-los no painel da sua aplicação. Em seguida, pode começar a criá-los usando o chat de IA. Você pode habilitar agentes para todas as novas aplicações por padrão nas configurações da conta no seu workspace.- Vá para Dashboard no editor da sua aplicação.
- Clique em Agents.
- Escolha um modelo de agente sugerido ou clique em Create from scratch para definir o seu.

Personalizando seu agente de IA
Cada agente tem seu próprio painel de configuração com as seguintes seções:- Guidelines: Defina o comportamento do agente, a persona, o modelo de IA e os arquivos de contexto.
- Tools: Controle quais dados e ferramentas o agente pode usar.
- Connectors: Permita que usuários da aplicação conectem suas próprias contas externas ao agente via OAuth.
- Skills: Adicione conjuntos de instruções reutilizáveis que dão ao agente comportamentos ou expertise específicos.
- Memory: Decida como o agente lembra informações ao longo das conversas.
- WhatsApp: Conecte o agente ao WhatsApp para que as pessoas possam conversar pelo celular.
- Telegram: Conecte o agente ao Telegram para que as pessoas possam conversar de qualquer lugar.
- LINE: Conecte o agente ao LINE para que as pessoas possam conversar pelo app LINE.
Configurando diretrizes
Use a aba Guidelines para definir como seu agente se comporta e qual modelo de IA ele utiliza.
- Vá para Dashboard no editor da sua aplicação.
- Clique em Agents.
- Clique em Edit Agent no agente relevante.
- Clique em Guidelines.
- Atualize a Description para definir o papel e o comportamento geral do agente.
- Atualize Instructions com regras detalhadas que o 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 alimenta 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
| Modelo | Indicado para | Créditos aprox. / mensagem |
|---|---|---|
| Automatic | Uso geral, respostas rápidas | ~3 |
| Gemini 3 Flash | Raciocínio mais forte a um custo moderado | ~5 |
| GPT-5 | Análises complexas e tarefas críticas em precisão | ~15 |
Gerenciando ferramentas e acesso a dados
Use a aba Tools para decidir o que seu agente pode fazer e quais dados pode acessar.
- Vá para Dashboard no editor da sua aplicação.
- 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 qualquer permissão específica de ferramenta para que o agente acesse apenas os dados necessários.
- Clique em Save.
Adicionando conectores de usuário
Use a aba Connectors para permitir que os usuários da sua aplicação conectem suas próprias contas externas ao agente. Quando um conector está habilitado, o agente pode criar links de OAuth para que cada pessoa autorize o acesso à própria conta naquele serviço diretamente em uma conversa. Por exemplo, em uma aplicação de consultoria de viagens, cada usuário pode conectar seu próprio Google Calendar para que o agente planeje e agende itinerários em seu nome. Saiba mais sobre como configurar conectores para usuários da aplicação. Para adicionar um conector de usuário ao seu agente:- No chat de IA, peça ao agente para adicionar um conector de usuário, por exemplo:
I want my app users to connect their own LinkedIn account to this agent. - Quando o formulário aparecer, preencha os detalhes necessários. Eles variam por provedor, mas normalmente incluem nome do conector, Client ID, Client Secret e os escopos exigidos pela sua aplicação.
- Siga as instruções na tela para autorizar o conector e escolher as permissões que serão solicitadas aos usuários.
- Clique em Approve.

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íficas. Você pode anexar até 10 habilidades por agente.
- App Skills: Habilidades criadas para uma aplicação específica. Uma vez criadas, podem ser reutilizadas em todos os agentes daquela aplicação.
- Workspace Skills: Habilidades compartilhadas em todo o seu workspace. Saiba mais sobre como gerenciar habilidades de workspace.
- Vá para Dashboard no editor da sua aplicação.
- 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 fique ativa imediatamente.
- Clique em Create Skill.
- Clique em Save.
Configurando a memória
A memória do agente permite que ele lembre informações importantes ao longo das conversas, como preferências, fatos-chave ou conhecimento compartilhado. Você controla se as memórias são compartilhadas entre todos ou específicas para cada pessoa.
- Vá para Dashboard no editor da sua aplicação.
- 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 compartilhadas entre todos que conversam com ele.
- Per User Only: O agente cria memórias específicas para cada pessoa.
- Em Memory Instructions, insira orientações que expliquem quando salvar memórias e o que incluir.
- Após algumas conversas, revise Saved Memories para ver o que o agente armazenou. Clique em Refresh para carregar novas memórias.
- Clique em Save.
Conectando seu agente ao WhatsApp
Conecte seu agente ao WhatsApp para que as pessoas possam enviar mensagens ao agente da sua aplicação diretamente pelo celular, sem nem mesmo abrir a aplicação.

Informações sobre como usar o WhatsApp com seu agente
- Este recurso está disponível gratuitamente em todos os planos.
- É possível conectar um total de 3 agentes dentro das aplicações ao WhatsApp em todas as suas aplicações. Esse limite é separado das conexões de WhatsApp do Superagent, que têm sua própria cota. Se tentar conectar mais de 3, será solicitado a desconectar um antes de continuar.
- Cada agente recebe seu próprio número de WhatsApp.
- Agentes do WhatsApp usam somente 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, além de créditos de integração adicionais para ações do agente, como chamadas ao LLM, geração de imagens ou envio de e-mails.
- Os visitantes da sua aplicação não precisam instalar nada para usar agentes do WhatsApp. Eles simplesmente tocam no botão do WhatsApp na sua aplicação para iniciar a conversa. As pessoas devem enviar a primeira mensagem, para ajudar a evitar spam e mantê-las seguras. Iniciada a conversa, o agente responde como faz dentro da aplicação.
- A conversa do WhatsApp suporta imagens e mensagens de voz.
- Se sua aplicação for pública, as pessoas precisam fazer login antes de usar o agente do WhatsApp. Isso garante que o agente identifique com quem está conversando e responda com base em seus dados.
- Vá para Dashboard no editor da sua aplicação.
- 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 à sua aplicação.
- Personalize a mensagem de boas-vindas do WhatsApp.
- Clique em Save.

Conectando seu agente ao Telegram
Conecte seu agente ao Telegram para que as pessoas possam enviar mensagens a ele direto pelo Telegram, sem abrir sua aplicação. Um agente conectado ao Telegram tem as mesmas capacidades do seu agente dentro da aplicação. Ele pode criar, ler, atualizar ou excluir registros, disparar funções de backend e gerenciar os dados da sua aplicação.Informações sobre como usar o Telegram com seu agente
- Todos os recursos do chat na 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 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 à sua aplicação para que os usuários abram o bot diretamente dali.
- Vá para Dashboard no editor da sua aplicação.
- 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 à sua aplicação.
- Personalize a mensagem de boas-vindas do Telegram.
- Clique em Save.

Conectando seu agente ao LINE
Conecte seu agente ao LINE para que as pessoas possam enviar mensagens a ele diretamente pelo app LINE, sem abrir sua aplicação. Um agente conectado ao LINE tem as mesmas capacidades do seu agente dentro da aplicação. Ele pode criar, ler, atualizar ou excluir registros, disparar funções de backend e gerenciar os dados da sua aplicação.- O LINE está disponível apenas no Japão.
- As respostas do LINE são apenas texto simples. Evite usar markdown ou HTML na mensagem de boas-vindas ou nas diretrizes.
- Vá para Dashboard no editor da sua aplicação.
- Clique em Agents.
- Clique em Edit Agent no agente relevante.
- Clique em LINE.
- Escaneie o QR code ou copie o código de ativação, abra o LINE no seu celular, 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 à sua aplicação.
- Personalize a mensagem de boas-vindas do LINE.
- Clique em Save.

Visualizando quem usa os seus agentes
A aba Users no painel Agents mostra cada usuário da aplicação que conversou com um dos seus agentes. Para cada usuário, você pode ver o papel, quantos agentes utilizou, o total de conversas e os créditos usados. Você pode ordenar a lista por agentes, conversas ou créditos.
- Vá para Dashboard no editor da sua aplicação.
- Clique em Agents.
- Clique na aba Users.
- Clique na linha de um 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 daquele usuário com ele.
- Clique em uma conversa para ler a transcrição completa, incluindo mensagens, chamadas de ferramentas e créditos usados.
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 mensagem a um agente?
Por que vejo um erro "Failed to send message" ou 404 ao enviar mensagem a um agente?
- Abra as configurações do seu agente.
- Clique na aba Tools and Capabilities.
- Atualize ou remova a entidade vazia.
-
Clique em Save.

Posso usar agentes no plano gratuito?
Posso usar agentes no plano gratuito?
Posso habilitar agentes para todas as aplicações da minha conta?
Posso habilitar agentes para todas as aplicações da minha conta?
- Clique no ícone do seu perfil no canto superior direito do 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?
Quais são os benefícios de usar agentes?
- Automatizar tarefas repetitivas.
- Obter respostas em tempo real e bem informadas.
- Manter seu fluxo de trabalho dentro de uma única aplicação.
- Escolher as ferramentas certas automaticamente.
Onde posso encontrar meu histórico de conversas com um agente?
Onde posso encontrar meu histórico de conversas com um agente?
Como o modelo de IA que escolho afeta os créditos e o comportamento?
Como o modelo de IA que escolho afeta os créditos e o comportamento?
- A opção padrão Automatic (baseada no Gemini 2.5 Flash) oferece respostas rápidas e de uso geral a cerca de 3 créditos por mensagem.
- Modelos como Gemini 3 Flash oferecem raciocínio mais forte a um aumento moderado de créditos.
- Modelos de ponta como GPT-5 são projetados para análises complexas e decisões críticas em precisão, e geralmente usam mais créditos por mensagem.
Quantas habilidades posso adicionar a um agente?
Quantas habilidades posso adicionar a um agente?
Como vejo quantos créditos meu agente usou?
Como vejo quantos créditos meu agente usou?

Qual é a diferença entre habilidades de aplicação e habilidades de workspace?
Qual é a diferença entre habilidades de aplicação e habilidades de workspace?
Posso disparar uma automação quando alguém inicia uma conversa com meu agente?
Posso disparar uma automação quando alguém inicia uma conversa com meu agente?




