gerar_modelo_html_ia
Create and modify HTML document templates for proposals and sales using natural language prompts. Optionally supply reference files or previous HTML to guide the AI in generating the layout.
Instructions
Gerar (ou editar) o HTML de um modelo de Proposta/Venda/Documento (PVD)
usando a feature de IA do Ploomes ("Gerador HTML com IA").
Endpoint: POST {PLOOMES_AI_BASE_URL}/generate_document_template
(documentado em handoff-gerador-html-ia.pdf). Requer as variáveis de
ambiente PLOOMES_AI_CLIENT_ID e PLOOMES_AI_CLIENT_SECRET — credenciais
próprias desta feature de IA, diferentes da User-Key do CRM.
Parâmetros:
root_entity_id: Id da entidade raiz do modelo (ex.: Id de uma
Proposta/Venda existente) — usado pela IA para calcular o
caminho (path) dos campos que ela detectar/sugerir.
prompt: instrução em linguagem natural descrevendo o layout
desejado ou a alteração a ser feita. Obrigatório se não houver
anexos.
previous_html: HTML atual da sessão — informe ao EDITAR um modelo
já gerado (a IA usa como base e aplica só o que foi pedido).
Deixe vazio para gerar do zero.
anexos: lista de arquivos de referência (PDF, Word, PNG, JPEG),
cada item como {"filename": "...", "content_base64": "...",
"mime_type": "application/pdf"}. Obrigatório se não houver
prompt.
idioma: idioma do usuário (ex.: "pt-BR").
Observações (da documentação original):
1. Ausência de previous_html sinaliza geração do zero; presença
sinaliza edição.
2. A IA não tem memória de conversa — cada chamada de edição leva
em conta apenas o previous_html enviado, não o histórico.
3. Não importa imagens como assets finais — se o anexo contém
imagens, o HTML gerado usa um bloco placeholder; a imagem
definitiva precisa ser configurada manualmente depois.
4. Depois de gerar, use identificar_campos_html_ia (opcional) para
detectar e criar os campos dinâmicos automaticamente, ou insira
o HTML direto em salvar_modelo_proposta / montar_bloco_produtos_proposta.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| anexos | No | ||
| idioma | No | pt-BR | |
| prompt | No | ||
| previous_html | No | ||
| root_entity_id | Yes |