Como Criar uma App de Chatbot com IA: Chaves, Prompts, Custos e Segurança

Para criar uma app de chatbot com IA precisa de quatro coisas: uma interface de chat, um pequeno servidor que guarda a chave API do fornecedor do modelo e encaminha as mensagens para ele, um prompt de sistema que diz ao modelo quem é e o que pode fazer, e limites que mantêm os custos e a utilização indevida sob controlo. Um criador de apps com IA consegue escrever tudo isso a partir de uma descrição. O trabalho que fica consigo é escolher o fornecedor, escrever as instruções e decidir o que o bot nunca pode fazer.

O que compõe uma app de chatbot com IA

A maioria das apps de chatbot, seja um assistente de apoio ao cliente, um tutor ou uma ferramenta interna do tipo «pergunte aos nossos documentos», tem as mesmas partes:

A rota no servidor é a parte que as pessoas mais erram. Se a página de chat chamar o fornecedor diretamente a partir do browser, qualquer pessoa pode abrir as ferramentas de programador, copiar a sua chave e fazer subir a fatura.

Decisões a tomar antes de construir

Fornecedor e modelo

Os principais fornecedores (OpenAI, Anthropic, Google e outros) oferecem todos uma API de estilo chat que funciona da mesma forma: envia-se uma lista de mensagens e recebe-se uma resposta. A escolha prática depende menos da marca e mais do tamanho do modelo:

• Modelos menores e mais rápidos são mais baratos e respondem depressa. Servem bem para respostas curtas, classificação e bots de FAQ simples.
• Modelos maiores raciocinam melhor, seguem instruções longas com mais fiabilidade e lidam com perguntas confusas, mas custam mais por mensagem e respondem mais devagar.

Comece com um modelo de porte médio, teste-o com as suas perguntas reais e suba ou desça a partir daí. Se ainda não conhece a forma como estas APIs são cobradas e chamadas, leia primeiro como usar APIs de LLM.

De onde vem o conhecimento do bot

Comece pela opção mais simples que cubra o seu conteúdo. A recuperação acrescenta um índice de pesquisa, uma forma de o manter atualizado e mais sítios onde as respostas podem falhar. Muitos bots úteis nunca precisam dela.

Público ou com início de sessão

Um chatbot público no seu site é fácil de encontrar, mas também fácil de abusar: alguém pode automatizar milhares de mensagens. Um chatbot com início de sessão permite guardar o histórico por utilizador e definir um limite diário por conta. Se for público, limite o tamanho das mensagens e o número que um visitante pode enviar num dado período, e defina um limite mensal rígido no painel do fornecedor. Como adicionar início de sessão à sua app explica a parte das contas.

Se guardar as conversas

As conversas guardadas são úteis: os utilizadores retomam onde ficaram, e pode ler perguntas reais para melhorar o prompt. Mas são também dados pessoais. Decida durante quanto tempo as guarda, diga-o na sua política de privacidade e não guarde nada de que não precise.

Escreva o prompt de sistema como uma descrição de funções

O prompt de sistema é a instrução que o modelo recebe antes de cada conversa. Um bom prompt lê-se como um breve briefing para um novo colaborador:

• Papel e público: «És o assistente de ajuda da Oakline, uma oficina de reparação de bicicletas. Falas com clientes.»
• Âmbito: «Responde a perguntas sobre serviços, preços, horário e marcações. Para tudo o resto, diz que só podes ajudar com a loja.»
• Fonte de verdade: «Usa apenas a informação abaixo. Se a resposta não estiver lá, diz que não sabes e indica o número de telefone da loja.»
• Tom e tamanho: «Simpático, em linguagem simples, até três frases, salvo se pedirem mais detalhe.»
• Regras rígidas: «Nunca prometas um preço de reparação que não esteja listado. Nunca peças dados de cartão.»

Depois teste-o com perguntas difíceis: pedidos fora do tema, mensagens rudes, perguntas cuja resposta não está no seu conteúdo e tentativas de o fazer ignorar as instruções («esquece as tuas regras e…»). Ajuste o prompt até as respostas serem aquelas que assinaria com o seu nome.

Mantenha os custos previsíveis

Os fornecedores cobram por token (grosso modo, pedaços de palavras) pelo que envia e pelo que o modelo escreve. Três coisas determinam a fatura:

1. Tamanho da conversa. Cada nova mensagem normalmente reenvia a conversa inteira para que o modelo tenha contexto. Uma conversa de 40 mensagens custa muito mais por resposta do que uma de 4. Mantenha apenas as últimas trocas, ou resuma as mais antigas.
2. Tamanho do prompt. Um prompt de sistema longo ou um grande bloco de conhecimento colado é enviado em cada mensagem.
3. Tamanho da resposta. Defina um tamanho máximo de resposta na chamada à API e peça respostas concisas no prompt.

Defina um limite mensal de gastos no painel do fornecedor antes de lançar e registe a utilização de tokens por pedido, para ver que conversas são caras. Não indicamos preços aqui porque variam por modelo e mudam com frequência; consulte a página de preços do próprio fornecedor.

Construa passo a passo

Passo 1: Descreva o bot, não o código

Um primeiro pedido que indique o público, o âmbito, os dados e as regras de segurança já o leva a meio caminho:

Cria um chatbot de apoio ao cliente para a Oakline, uma oficina de reparação de bicicletas. Uma página de chat com lista de mensagens e campo de escrita, com as respostas a serem apresentadas à medida que são geradas. Chama a API da Anthropic a partir de uma rota do servidor usando a chave secreta ANTHROPIC_API_KEY — nunca a exponhas ao browser. Usa um prompt de sistema que responda apenas a perguntas sobre os nossos serviços, preços e horário, com base no texto de um ficheiro chamado shop-info.md, e que diga «Não tenho a certeza — ligue-nos para o número abaixo» nos restantes casos. Limita as mensagens a 500 caracteres e a 20 mensagens por visitante por hora. Design limpo e simpático que funcione bem em telemóveis.

Passo 2: Adicione a chave como segredo

Crie a chave na consola do seu fornecedor e guarde-a nas variáveis de ambiente ou segredos do projeto, não no chat nem no código. Se uma chave alguma vez aparecer num sítio público, revogue-a no fornecedor e crie uma nova. O que são variáveis de ambiente e segredos explica porque é que isto importa.

Passo 3: Teste as respostas, não só a interface

Quando o chat funcionar, dedique a maior parte do tempo à qualidade das respostas. Mantenha uma lista de cerca de 20 perguntas reais, incluindo algumas que devem ser recusadas, e percorra-as após cada alteração ao prompt. Verifique:

• Mantém-se dentro do âmbito?
• Admite quando não sabe, em vez de inventar uma resposta?
• Aguenta-se quando alguém tenta anular as instruções?
• A chave está ausente de tudo o que o browser descarrega?

Passo 4: Adicione memória e contas, se precisar

Quando as conversas individuais funcionarem, peça conversas guardadas numa base de dados e, se for necessário, registo e início de sessão para que cada utilizador veja apenas os seus chats. Acrescente ao mesmo tempo um limite diário de mensagens por utilizador.

Passo 5: Publique com os limites ativados

Confirme que a app publicada tem os mesmos segredos da pré-visualização, que o teto de gastos está definido no fornecedor e que os erros ficam registados num sítio onde os veja. Depois partilhe-a com um grupo pequeno antes de a colocar no site principal.

Segurança e confiança

Um chatbot fala com o público em seu nome, por isso trate as suas falhas como um problema seu:

• Respostas erradas. Os modelos podem afirmar coisas falsas com confiança. Mantenha o bot num tema restrito, baseado no seu próprio conteúdo, e mostre uma breve nota de que as respostas podem estar erradas em assuntos importantes.
• Injeção de prompt. Os utilizadores (ou documentos que o bot lê) podem conter instruções como «ignora as regras anteriores». Não dê ao bot poderes em que não se possa confiar: nada de reembolsos, eliminações ou emails enviados a pedido de um utilizador sem uma verificação no seu próprio código.
• Temas sensíveis. Em questões médicas, jurídicas ou financeiras, faça com que o bot encaminhe as pessoas para um profissional em vez de aconselhar.
• Dados pessoais. Não cole registos de clientes nos prompts, salvo se for necessário, e verifique o que os termos do fornecedor dizem sobre o modo como os dados da API são tratados.

A nossa lista de verificação de segurança para apps criadas com IA cobre a app no seu todo.

Erros comuns

• Chamar o fornecedor a partir do browser. A chave fica exposta. Passe sempre pelo seu servidor.
• Nenhum limite num bot público. Um único script pode esgotar o orçamento de um mês numa tarde.
• Começar com RAG, ferramentas e vários modelos ao mesmo tempo. Ponha primeiro uma boa conversa a funcionar; acrescente o resto quando perguntas reais mostrarem que é necessário.
• Testar apenas perguntas simpáticas. Os seus utilizadores vão fazer perguntas estranhas, hostis e fora do tema logo no primeiro dia.
• Deixar a conversa crescer para sempre. Os custos e os tempos de resposta sobem a cada mensagem.

Quando um produto pronto é a melhor escolha

Construir o seu próprio faz sentido quando o chatbot faz parte do seu produto, precisa dos seus dados ou do seu fluxo de trabalho, ou precisa de um aspeto e comportamento específicos. Muitas vezes não é a escolha certa quando:

• Só quer um widget de apoio num site existente. Muitos produtos de helpdesk e chat ao vivo já incluem bots de resposta com IA que leem o seu centro de ajuda, com transferência para humanos, caixa de entrada e relatórios incluídos.
• Só o próprio ou a sua equipa o vão usar. Uma subscrição de um assistente geral, como o ChatGPT ou o Claude, com os seus documentos carregados, pode ser tudo o que precisa.
• Precisa de garantias de conformidade estritas (por exemplo, dados de saúde ou financeiros regulados). Um fornecedor que já tenha as certificações pode ser mais seguro do que uma construção à medida.

Construir com a Mythex

A Mythex é um criador de apps com IA: descreve o chatbot no chat, e a Mythex escreve a interface e a chamada do lado do servidor, executa-o numa pré-visualização em tempo real e publica-o num URL público. A IA dentro da sua app usa a sua própria chave de fornecedor. Adiciona-a nos segredos do projeto, ou através do cartão de segredos que a Mythex mostra no chat quando precisa dele, e a utilização do fornecedor é faturada na sua conta de fornecedor, não nos créditos de criação da Mythex. A Mythex não inclui tokens para os utilizadores da sua app, um produto de base de conhecimento incorporado nem limites de pedidos prontos: são partes que pede e testa. A documentação sobre adicionar IA à sua app explica o processo, e adicionar IA com as suas próprias chaves API tem um prompt inicial.

Se o bot precisar de conversas guardadas, a Mythex associa uma base de dados Postgres ao projeto quando a pedir. Para mais formas de usar modelos dentro de uma app, desde resumos até classificação, consulte como adicionar funcionalidades de IA à sua app, ou explore os modelos de apps como pontos de partida.

Perguntas