Agente de IA com Custo Zero: PHP, cPanel e Gemini Flash para Seu Site Empresarial

A integração de Inteligência Artificial em sites empresariais pode parecer um investimento complexo e caro, mas um novo método demonstra como é possível construir um agente de IA funcional e pronto para produção sem custos mensais adicionais, utilizando tecnologias amplamente disponíveis como PHP, cPanel e Gemini Flash. Publicado em 13 de agosto de 2026, este conceito do freeCodeCamp.org abre portas para empresas que buscam inovar sem comprometer o orçamento. Entender essa abordagem é crucial para gestores e donos de empresas que querem otimizar a operação de seus sites.

A proposta é desenvolver um agente de IA capaz de receber comandos, decidir se precisa usar uma ferramenta, executá-la em PHP, armazenar o histórico de conversas em MySQL e continuar raciocinando até fornecer uma resposta final. O foco não é em uma demonstração extravagante, mas em uma solução prática que funciona em um ambiente comum para muitos desenvolvedores: PHP para lidar com requisições, MySQL para persistência de dados, Gemini Flash para raciocínio e chamada de funções, e cPanel para implantação em hospedagem compartilhada padrão.

Para que um agente de IA funcione de forma eficaz, sua arquitetura precisa ser clara e eficiente. Este sistema é composto por cinco partes principais que trabalham em conjunto para processar as interações do usuário e fornecer respostas inteligentes:

O fluxo é direto: o usuário envia uma mensagem ao endpoint PHP. Este, por sua vez, passa a mensagem e um ID de sessão para o agente. O agente carrega mensagens anteriores e envia a conversa ao Gemini, junto com as ferramentas disponíveis. O Gemini decide então o que fazer. Se a requisição pode ser respondida diretamente, ele retorna um texto. Se uma ação é necessária, o Gemini retorna uma chamada de função com o nome da ferramenta e seus argumentos. O PHP executa a ferramenta correspondente, adiciona o resultado à conversa, e essa informação é enviada de volta ao Gemini, que pode então chamar outra ferramenta ou retornar uma resposta final. Este ciclo é o que transforma a aplicação em um agente, e não apenas um chatbot básico.

Para implementar um agente de IA no seu site, alguns pré-requisitos técnicos são fundamentais. Eles garantem que o ambiente de hospedagem compartilhada seja compatível com a solução proposta, sem a necessidade de um servidor de aplicação separado. São eles:

É importante notar que os arquivos PHP podem ser executados em uma hospedagem compartilhada comum, desde que sua conta suporte PHP, cURL, MySQL e requisições HTTPS de saída. Em uma configuração típica de cPanel, o projeto será armazenado em uma pasta dentro de public_html.

A organização dos arquivos é crucial para a manutenção e escalabilidade do projeto. Recomenda-se criar uma pasta chamada agent dentro de public_html, com a seguinte estrutura:

Manter os arquivos separados facilita a manutenção. Adicionar uma nova ferramenta, por exemplo, não exige alterações nas outras partes da aplicação. É vital adicionar um arquivo .htaccess dentro da pasta tools/ com o conteúdo Deny from all para impedir o acesso público direto a esses arquivos, pois eles podem realizar operações sensíveis como escrita no banco de dados, requisições externas ou envio de e-mails.

O aplicativo requer duas tabelas no MySQL: uma para o histórico da conversa e outra para notas salvas. No phpMyAdmin, execute os seguintes comandos SQL:

Se o cPanel adicionar um prefixo à sua conta no nome do banco de dados, use o nome completo em db.php. Por exemplo, ai_agent pode se tornar account_ai_agent. Para a conexão PHP-MySQL, o arquivo db.php deve usar PDO para conectar-se ao MySQL, garantindo que a mesma conexão seja reutilizada para requisições subsequentes e que erros do banco de dados gerem exceções. O conjunto de caracteres utf8mb4 é recomendado para suportar uma ampla gama de caracteres, incluindo emojis e textos não-ingleses.

O Gemini Flash é o motor de raciocínio do agente. A comunicação com ele é feita via PHP. O Gemini suporta a chamada de funções, o que significa que ele pode decidir que uma ferramenta é necessária e retornar o nome da ferramenta e seus argumentos. Contudo, ele não executa a função PHP diretamente; a aplicação é responsável por validar a requisição e executar a ferramenta. Por exemplo, o Gemini pode retornar uma instrução como { "note": "Nosso lançamento é em 1 de setembro de 2026" }.

O arquivo gemini.php deve conter duas funções principais: gemini_request, que envia a conversa e as definições das ferramentas para o Gemini, e parse_gemini_response, que converte a resposta do Gemini em um formato compreensível para o agente (texto ou chamada de função). O loop do agente pode então decidir: se o tipo for function_call, executa a ferramenta solicitada; se for text, retorna a resposta ao usuário. Para uma implantação real, é importante armazenar a chave de API fora do diretório web público para maior segurança.

O arquivo tool_registry.php é onde se define quais ferramentas o Gemini pode usar e quais argumentos elas requerem. Cada ferramenta deve ter um nome, uma descrição (que ajuda o Gemini a decidir quando usá-la) e os parâmetros esperados. Por exemplo, uma ferramenta save_note pode ter um parâmetro note do tipo string.

Cada ferramenta PHP, por sua vez, deve seguir um padrão: ler os argumentos do Gemini, validar a entrada, executar a ação e retornar um resultado JSON. Alguns exemplos de ferramentas incluem:

É vital lembrar que o registro das ferramentas não substitui a validação no lado do servidor. Cada ferramenta PHP deve verificar seus próprios argumentos antes de realizar qualquer ação.

O Gemini não armazena automaticamente as requisições anteriores da API. Assim, a aplicação precisa carregar o histórico da conversa do MySQL antes de cada nova requisição e salvar o histórico atualizado depois. O arquivo memory.php é responsável por essas operações, garantindo que o agente mantenha o contexto da conversa, proporcionando uma experiência mais fluida e inteligente para o usuário. Isso é fundamental para a criação de interfaces de IA eficazes que vão além de um simples chatbot, como discutido em Interface de IA: Por que seu site precisa ir além do chatbot para uma UX eficaz.

A possibilidade de implementar um agente de IA com custo zero, utilizando ferramentas como PHP, cPanel e Gemini Flash, representa uma oportunidade significativa para empresas que desejam otimizar seus sites e melhorar a experiência do usuário. Esta abordagem didática e pragmática demonstra que a inteligência artificial não é mais uma exclusividade de grandes orçamentos ou infraestruturas complexas. Com o conhecimento certo e as ferramentas adequadas, é possível construir soluções robustas que automatizam tarefas, respondem a consultas e interagem de forma inteligente, elevando o site da sua empresa a um novo patamar de eficiência e inovação. Para garantir que seu site esteja sempre à frente, a UP Developer oferece soluções completas de desenvolvimento web, WordPress, SEO e segurança, ajudando empresas a dar um up em sua presença online.

É realmente possível criar um agente de IA sem custos mensais adicionais?

Sim, é possível. A abordagem descrita utiliza PHP, MySQL e cPanel, que geralmente já estão inclusos em pacotes de hospedagem compartilhada. O Gemini Flash oferece um nível gratuito para uso, tornando o custo mensal para a infraestrutura básica zero.

Quais são os principais benefícios de um agente de IA para meu site empresarial?

Um agente de IA pode automatizar o atendimento ao cliente, fornecer respostas rápidas a perguntas frequentes, auxiliar na navegação do site, coletar informações do usuário e até mesmo realizar ações como salvar notas ou enviar e-mails, melhorando a eficiência e a experiência do usuário.

Preciso de conhecimentos avançados em programação para implementar isso?

Não são necessários conhecimentos avançados, mas uma familiaridade básica com PHP, MySQL, JSON e SQL é recomendada. O tutorial é projetado para ser didático, focando em como estruturar e conectar as diferentes partes do sistema.

Como a segurança dos dados é garantida ao usar este agente?

A segurança é abordada através de práticas como o uso de declarações preparadas no MySQL para prevenir injeção SQL, validação de entrada em todas as ferramentas PHP e a recomendação de armazenar chaves de API fora do diretório web público. A pasta de ferramentas também é protegida por .htaccess para impedir acesso direto.

Fonte: freeCodeCamp.org