O bloco Run AI Agent (também identificado como AI Agent em algumas telas) permite usar IA dentro de um fluxo. Além de responder mensagens, ele pode pedir uma escolha ao visitante, usar variáveis da sessão, consultar grupos de texto aprovados e, com permissões específicas, acessar ferramentas conectadas.
Disponível no Sendbot Studio. As escolhas nativas, variáveis e subfluxos somente de texto foram validados no chat Web e na prévia do Studio. As integrações externas são opcionais e dependem das credenciais, do provedor e do canal. Teste cada uma antes de publicar.

​
O que evoluiu no Run AI (outubro de 2026)

O Run AI agora permite botões nativos validados no servidor, escolha inicial obrigatória, gravação de respostas em variáveis de sessão e execução restrita de grupos de texto autorizados. A opção selecionada aparece como resposta do usuário, com o mesmo estilo dos botões tradicionais do Sendbot. O modo somente leitura também pode apresentar escolhas, sem receber permissão para executar ações. Quando uma escolha obrigatória falha, o fluxo não avança silenciosamente. Comprovado no Webchat/Studio: escolha de plano, variável preenchida, texto do FAQ autorizado, feedback e segunda escolha Concluir/Revisar. MCP externo, outros provedores e geração de mídia exigem certificações específicas e não devem ser tratados como automaticamente testados.

​
Começar no Studio

  1. Acesse o Sendbot Studio, selecione seu workspace e abra ou crie um bot.
  2. No editor do fluxo, adicione AI Agent / Run AI Agent, em Integrações.
  3. Selecione o AI Provider, o Model e as Credentials válidas (ou credenciais gerenciadas disponíveis no workspace).
  4. Escreva as instruções em Prompt / Input e, se necessário, adicione um System prompt.
  5. Conecte o bloco às próximas mensagens ou entradas e abra Preview para testar uma conversa completa.
  6. Revise o rascunho e publique pelo procedimento normal do Studio. Salvar não publica automaticamente.
O primeiro atendimento com IA pode levar mais tempo que um fluxo simples com texto ou botões, pois aguarda o modelo e, eventualmente, as ferramentas chamadas.

​
Exemplo: perguntar qual plano o visitante deseja

Primeiro, crie uma variável de sessão chamada plano_escolhido. Depois, configure o bloco Run AI: Exemplo de prompt:
O Run AI solicita uma escolha única validada pelo servidor. No chat Web, a pergunta aparece como mensagem do bot, os botões respeitam o tema padrão do Sendbot e a opção selecionada aparece como uma resposta do usuário. Os botões antigos não permanecem clicáveis no histórico. O valor interno, por exemplo blue, pode ser salvo na variável escolhida.
Se a escolha for obrigatória logo no início, ative Require an initial native choice. Apenas escrever no prompt “mostre botões” não garante que o modelo chame requestChoice. A opção fica desativada por padrão.
As escolhas nativas permitem uma opção por pergunta. Para criar um menu fixo, ramificar diferentes caminhos ou receber múltiplas escolhas, use o bloco Botões tradicional.

​
Utilizar a resposta nos próximos blocos

  1. Acrescente um bloco Texto depois do Run AI.
  2. Insira a variável plano_escolhido pelo seletor de variáveis do Studio.
  3. Adicione outros blocos ou condições conforme necessário.
  4. Teste ambas as respostas na prévia e confirme o valor utilizado.
O agente não escolhe livremente o destino dessa gravação: a variável precisa existir e ser indicada pelo proprietário em Save selected choice to session variable.

​
Exemplo avançado: consultar um subfluxo de texto autorizado

Use subfluxos para reutilizar respostas de FAQ, condições de atendimento ou explicações que estejam em um grupo do próprio bot, sem ações externas.
  1. Crie um grupo separado com apenas blocos de Texto simples, sem arestas de saída, scripts, webhooks, integrações, Bot links ou outros subfluxos.
  2. No Run AI, ative Enable authorized read-only subflows (text-only groups).
  3. Em Approved text-only subflow groups, informe um apelido (por exemplo faq), a finalidade e o ID do grupo existente no mesmo bot.
  4. Se necessário, associe até cinco entradas tipadas (string, number ou boolean) a variáveis de sessão já existentes.
  5. No prompt, instrua a IA a chamar callSubflow_faq ao receber uma pergunta pertinente. Verifique o texto retornado na prévia.
Limites: até 8 grupos autorizados, até 8 blocos simples de texto por grupo, até 5 entradas por ferramenta e até 12 chamadas de subfluxo por bloco Run AI/sessão. As entradas são resolvidas em um contexto isolado de somente leitura. O grafo em execução é vinculado à revisão da sessão.
Esse recurso não executa fluxos completos. Um subfluxo autorizado não pode enviar e-mails, chamar APIs externas, cobrar clientes, alterar contas, executar código, gravar variáveis de sessão nem chamar outros bots. Ativar Read-only Support (no actions) também impede a execução de subfluxos.

​
Modo somente leitura

Ative Read-only Support (no actions) para um agente que deve apenas orientar o visitante, sem modificar registros nem executar ações externas. Mesmo nesse modo é possível usar Enable structured choices e Require an initial native choice. Por exemplo: perguntar Concluir / Revisar, aguardar a seleção e então responder com o resumo. Se também houver MCP externo, use uma lista Allowed Tools explícita e não vazia, limitada a ferramentas de leitura com escopo declarado pelo provedor. Ferramentas de escrita, ambíguas ou fora da lista não devem ser disponibilizadas. Escrever “não execute ações” no prompt não substitui as permissões reais.

​
Recursos opcionais: MCP, pesquisa, memória e mídia

Essas capacidades não são necessárias para a escolha nativa e exigem configuração própria: No MCP, configure Allowed Tools de forma explícita e mantenha Require approval for MCP write actions ativado (padrão). Ações que alteram dados devem aguardar aprovação específica vinculada à sessão. Um pedido de aprovação não significa que a operação já tenha sido executada.
Não confunda duas integrações MCP: o MCP dentro do Run AI conecta o bot a sistemas externos. O MCP do Sendbot para ChatGPT e Claude permite que um assistente ajude você a gerenciar rascunhos da sua conta Sendbot. Configurar um não ativa automaticamente o outro.

​
Créditos e custos

O consumo de IA varia conforme o modelo e os tokens. Pesquisa, mídia, embeddings e ferramentas externas podem gerar custos adicionais. Credenciais de IA gerenciadas dependem do saldo do workspace; usar sua própria chave não elimina necessariamente custos de sessão e de provedores externos. Confira Créditos e uso e comece com limites pequenos antes de ativar ferramentas pagas.

​
Checklist antes de publicar

  • O chat mostra os botões nativos e aguarda o clique real.
  • O botão escolhido vira resposta do usuário, sem opções antigas clicáveis.
  • A variável de sessão recebe o valor esperado e o fluxo só avança após a escolha.
  • Apenas o grupo de texto autorizado é consultado; outros grupos são recusados.
  • O modo somente leitura não executa escrita nem subfluxos proibidos.
  • Qualquer operação MCP de escrita exige confirmação e devolve resultado verificável.
  • O provedor, o canal e os créditos necessários foram testados.

​
Solução de problemas

Leia também: AI Agent e MCP · Botões · Variáveis · Publicação.