Biblioteca ia.php

Caminho no Gestor bibliotecas/ia.php

É a IA dentro dos editores: o componente onde o usuário escolhe servidor, modelo, prompt e modo, e a chamada que manda o texto para a API. Quem a usa é o editor HTML (html-editor.php) e o Live Editor do dashboard.

Conceitos

O alvo é o contexto em que o componente aparece (por exemplo, paginas no editor de páginas). Prompts e modos são recursos: nascem dos módulos (ai_prompts, ai_modes, ai_prompts_targets) e podem ser criados no próprio editor (recursos).

Renderizar o componente

ia_renderizar_prompt(['alvo' => 'paginas', 'prompt_controls' => $html]) devolve o HTML do componente ia-prompt:

• lista servidores, prompts e modos do alvo, e os modelos do Gemini, com o padrão selecionado;

• inclui o JS da biblioteca, o CodeMirror e os modais ia-prompt-modais;

• expõe ao JavaScript gestor.ai.activated e gestor.ia (alvo e mensagens);

• sem nenhum servidor ativo, devolve o componente ia-sem-servidor e gestor.ai.activated = false.

ia_editor_dados($alvo) devolve os mesmos dados em JSON, para o Live Editor montar a tela sozinho.

Filtros disponíveis (hooks): ia.prompts.load.where (WHERE da lista de prompts), ia.prompt.option (HTML de cada opção), ia.models.available (modelos) e ia.config (dados extras para o JS).

Enviar o prompt

$r = ia_enviar_prompt(['servidor_id' => 3, 'modelo' => 'models/gemini-3-flash-preview', 'prompt' => $texto]);
if ($r['status'] === 'success') {
    $texto = $r['data']['texto_gerado'];   // + modelo_usado, tokens_entrada/saida/total, resposta_completa
}

• Sem modelo, usa o defaultModel do admin-ia.json (hoje models/gemini-3-flash-preview). O nome do modelo leva o prefixo models/; o reserva fixo no código, gemini-1.5-flash, não tem o prefixo e não funcionaria na URL.

• Decifra a chave do servidor e chama generateContent da API do Gemini (tempo limite de 120 s).

• Devolve ['status' => 'success', 'data' => …] ou ['status' => 'error', 'message' => …]; em erro HTTP, a mensagem inclui o corpo da resposta da API.

• Não há histórico de conversa: cada chamada manda um único texto.

• ia_processar_retorno(['dados_retorno' => $r['data'], 'formato' => 'texto'|'html'|'json']) formata o retorno (html aplica htmlspecialchars + nl2br). Não tem chamadores.

AJAX do editor

ia_ajax_interface() despacha, pela ajax-opcao: ia-prompts → ia_ajax_prompts() e ia-modos → ia_ajax_modos() (texto de um prompt/modo), ia-prompt-edit → ia_ajax_prompt_edit(), ia-prompt-new → ia_ajax_prompt_novo() e ia-prompt-del → ia_ajax_prompt_del().

Funções

ia_renderizar_prompt(array $params = false)

ia_enviar_prompt($params = false)

ia_processar_retorno(array $params = false)

ia_editor_dados(string $alvo): array

ia_ajax_interface($params = false)

ia_ajax_prompts(array $params = false)

ia_ajax_modos(array $params = false)

ia_ajax_prompt_edit(array $params = false)

ia_ajax_prompt_novo(array $params = false)

ia_ajax_prompt_del(array $params = false)