Guia de configuração de definições do IntelliWP, RAG + Configuração de ajuste fino do agente de IA do WordPress
IntelliWP representa uma evolução significativa na integração de inteligência artificial no ecossistema do WordPress. Sua página de configuração de Configurações constitui o hub de controle a partir do qual os desenvolvedores podem implementar um sofisticado agente de IA do WordPress que vai além dos chatbots tradicionais.
A característica distintiva que posiciona o IntelliWP acima de outros plugins está em sua arquitetura dual RAG + Ajuste fino. Essa flexibilidade permite aos usuários escolher a metodologia mais adequada de acordo com suas necessidades específicas, algo que nenhum outro plugin do WordPress oferece com essa sofisticação técnica.
Configuração da API OpenAI, a base da conectividade
A gestão de chaves de API no IntelliWP implementa um sistema de prioridade inteligente que prioriza a segurança em relação à conveniência. O sistema procura a chave da API em ordem hierárquica: primeiro em variáveis de ambiente do servidor, depois em wp-config.php e, por fim, no banco de dados como recurso de contingência.
Quando a chave é carregada de fontes externas, o campo aparece desativado com a mensagem “Este campo é somente leitura porque a chave da API é carregada de uma fonte externa”, confirmando que o sistema opera em modo seguro. Nesse caso, uma prévia da chave é mostrada para verificação sem expor credenciais completas.
Para configuração manual, o campo permite a entrada direta da chave da API com o espaço reservado “Insira sua chave da API OpenAI”. O sistema valida automaticamente a conectividade com a OpenAI e exibe o status da conexão.
O aviso proeminente dos termos de serviço não é meramente informativo: ele lembra que, embora o IntelliWP seja GPL, o uso da API OpenAI está sujeito a termos específicos da OpenAI, estabelecendo responsabilidades claras em relação ao processamento de conteúdo.
Seleção do modo de operação, Ajuste fino vs RAG
Esta é talvez a decisão mais crítica em toda a configuração. O IntelliWP oferece duas metodologias completamente diferentes para criar seu Smart WordPress AI agent, cada uma com vantagens específicas dependendo do caso de uso.
O Ajuste fino (Modo Clássico) cria um modelo especificamente treinado com seu conteúdo. A descrição técnica explica: “Cria um modelo especificamente treinado com seu conteúdo. Requer re-treinamento quando o conteúdo muda.” Este método é ideal para sites com conteúdo relativamente estático onde precisão e consistência são prioridades.
O RAG (Geração com Recuperação) usa busca vetorial para recuperar conteúdo relevante para cada consulta. A descrição indica: “Usa busca vetorial para recuperar conteúdo relevante para cada consulta. Atualiza automaticamente quando o conteúdo muda.” Quando você seleciona esta opção, um link “Configurar mais” aparece dinamicamente, levando a configurações específicas do agente RAG do WordPress.
A escolha entre esses métodos determina completamente o comportamento subsequente do sistema, incluindo custos operacionais, velocidade de resposta e flexibilidade para atualizações de conteúdo.
Gestão de fontes de conteúdo
O IntelliWP fornece controle granular sobre quais conteúdos são incluídos no treinamento ou indexação do agente inteligente do WordPress.
A opção “Incluir postagens e páginas no treinamento” vem ativada por padrão e extrai conteúdo de todas as postagens e páginas publicadas no site. Esta é a principal fonte de conhecimento para a maioria das implementações.
“Incluir arquivos da biblioteca de mídia” permite extrair texto de arquivos na biblioteca de mídia. Esta funcionalidade vem desativada por padrão com o aviso “Isso pode aumentar significativamente o tempo de treinamento”, refletindo o impacto no desempenho e nos custos.
O recurso “Usar IA para gerar conjuntos de dados de treinamento aprimorados” usa a API OpenAI para gerar pares de perguntas e respostas de alta qualidade. A descrição técnica especifica: “Usa a API OpenAI para gerar pares de perguntas e respostas de alta qualidade” com o aviso explícito “Esta opção consome tokens adicionais da API e pode aumentar os custos”.
Seleção e configuração do modelo base
O menu suspenso de seleção de modelo organiza as opções em duas categorias claramente diferenciadas. “Modelos Base” incluem modelos oficiais como GPT-3.5 Turbo, GPT-4 e GPT-4 Turbo, que sempre estão disponíveis quando a chave da API é válida.
Os “Modelos Ajustados” mostram modelos previamente treinados pelo usuário. Se não existirem modelos personalizados, ele exibe “Nenhum modelo ajustado disponível”, indicando que pelo menos um ciclo de treinamento deve ser concluído antes de ter opções adicionais.
A seleção do modelo base determina as capacidades fundamentais do agente, incluindo compreensão contextual, qualidade de resposta e custos operacionais.
Configuração avançada e controle de custos
O IntelliWP demonstra transparência excepcional no gerenciamento de custos por meio de informações detalhadas de preços. Os custos aproximados são apresentados claramente: “Treinamento: $0.008 por 1.000 tokens” e “Uso de modelo ajustado: $0.012 por 1.000 tokens (entrada), $0.016 por 1.000 tokens (saída)”.
O link direto para a página de preços oficial da OpenAI permite verificar informações atualizadas, reconhecendo que os preços podem variar.
O campo “Limite de conteúdo para aprimoramento de IA” controla o número máximo de itens de conteúdo processados com a API OpenAI. O valor padrão de 100 representa um equilíbrio entre qualidade do conjunto de dados e custos razoáveis. A descrição explica: “Número máximo de itens de conteúdo que serão processados com a API OpenAI. Um número maior melhora a qualidade do conjunto de dados, mas aumenta o custo”.
Proteção contra limitação de taxa
O sistema de proteção contra uso excessivo inclui a caixa de seleção “Proteger contra uso excessivo da API” que impede chamadas não controladas da API. Este recurso é essencial para evitar custos inesperados de uso em massa acidental.
O campo “Requisições por minuto” permite configurar o número máximo de solicitações de API por minuto, com um valor padrão de 50 e recomendação de 20 para uso conservador. Esse controle é particularmente importante em sites de alto tráfego onde vários usuários podem interagir simultaneamente com o agente.
Controle de acesso externo e segurança
A configuração de domínios permitidos inclui cinco campos específicos para URLs autorizados. Somente domínios listados aqui podem acessar a API de chat a partir de aplicativos JavaScript externos, estabelecendo um perímetro de segurança claro.
A nota de segurança explica que “Somente os domínios listados aqui poderão acessar a API de Chat a partir de aplicativos JavaScript externos”, enfatizando a importância de configurar corretamente esses campos antes de implementar integrações externas.
A caixa de seleção “Ativar cabeçalhos CORS para respostas da API” permite solicitações de origem cruzada de domínios autorizados. Essa configuração é obrigatória para aplicativos JavaScript externos e deve ser ativada juntamente com a lista de domínios permitidos.
Integração de trecho de JavaScript
O IntelliWP facilita a implementação externa por meio de um trecho de JavaScript pré-configurado. O campo de texto grande contém código pronto para copiar e colar em sites externos, com a instrução “Copie este código e cole no HTML do seu site externo”.
A funcionalidade “Integração Fácil” inclui opções para personalizar temas e configurações responsivas, juntamente com um botão “Copiar trecho de JavaScript” que facilita a implementação sem erros de transcrição.
Avisos de segurança e validação final
Avisos de segurança finais estabelecem três requisitos críticos para a funcionalidade correta: os trechos funcionam apenas em domínios da lista permitida, é necessário adicionar domínios à lista permitida e os cabeçalhos CORS devem ser ativados se estiver usando trecho de JavaScript.
O quarto ponto recomenda testar a integração no domínio de destino antes de considerar a implementação concluída.
Recursos distintivos do IntelliWP
A arquitetura dual permite alternar entre agente de IA do WordPress com ajuste fino e agente RAG do WordPress a partir da mesma interface por meio de botões de rádio na seção Modo de Operação. Uma vez selecionado o RAG, o link “Configurar mais” aparece dinamicamente para acessar configurações específicas.
O sistema de gestão de chaves de API implementa busca hierárquica: variáveis de ambiente, wp-config.php e banco de dados como recurso de contingência. Quando é detectada uma configuração externa, o campo aparece desativado mostrando “Este campo é somente leitura porque a chave da API é carregada de uma fonte externa”.
A transparência de custos inclui informações detalhadas: “Treinamento: $0.008 por 1.000 tokens” e “Uso de modelo ajustado: $0.012 por 1.000 tokens (entrada), $0.016 por 1.000 tokens (saída)” com link direto para a página de preços oficial da OpenAI.
A página de Configurações do IntelliWP concentra todas as decisões estratégicas que determinam o comportamento, desempenho e custos do sistema de IA. Dominar essas configurações fornece controle completo sobre a implementação, permitindo a otimização do equilíbrio entre funcionalidade, desempenho e custos de acordo com os requisitos específicos do projeto.