guia_html_modelo_proposta
Retrieve HTML markup rules for Ploomes proposal templates to manually write form fields using and tags, eliminating the need for external LLM calls.
Instructions
Retornar as regras de marcação de HTML de modelos de Proposta/Venda/
Documento (PVD) do Ploomes, para que VOCÊ (o agente) escreva o HTML
diretamente — sem chamar nenhum LLM externo nem o gateway de IA.
POR QUE ESTA TOOL EXISTE: no Ploomes não há editor de campo de
formulário separado do HTML. Os campos que aparecem no formulário de
preenchimento são DERIVADOS pelo backend a partir do parsing do HTML
do corpo do documento (Pages[].BodySourceCode). Ou seja, escrever o
HTML com as tags certas é a única forma de "declarar" um campo. Esta
tool entrega essas convenções (levantadas por engenharia reversa) em
formato estruturado.
SUBSTITUI gerar_modelo_html_llm (removida na consolidação de
29/07/2026), que chamava a OpenRouter para pedir a um LLM externo o
HTML que o agente desta conversa já sabe escrever — dependência
quebrada (OpenRouterClient nunca existiu no repositório), custo e
chave de API a mais, sem ganho. Se preferir o pipeline oficial da
Ploomes, use gerar_modelo_html_ia (requer PLOOMES_AI_CLIENT_ID /
PLOOMES_AI_CLIENT_SECRET).
FLUXO RECOMENDADO (sem credencial de IA):
1. guia_html_modelo_proposta → estas regras.
2. Você escreve o HTML, usando <field key="..."> para campos
nativos e <newfield .../> onde precisar de campo customizado.
3. criar_campos_novos_llm(novos_campos=[...]) → cria os campos
customizados pela API normal do CRM e devolve as Keys.
4. aplicar_campos_novos_html_llm(html, campos_criados) → troca os
<newfield> pelos <field key="..."> reais.
5. salvar_modelo_proposta(corpo_html=html_final, ...) → cria o
modelo e a primeira página.
6. montar_bloco_produtos_proposta(template_id=...) → se precisar
do bloco de itens (preferível a escrever a tabela na mão).
ATALHO: para um modelo simples já com identidade visual do cliente,
montar_modelo_proposta_com_identidade faz os passos 2/5/6 numa
chamada — use esta tool aqui quando precisar de layout sob medida.
Parâmetros:
entidade_id: EntityId raiz do modelo (7=Proposta, 4=Venda,
2=Negócio) — usado nos exemplos de entity_id dos newfield.
incluir_bloco_produtos: se False, omite as regras do bloco
repetível de produtos, deixando a resposta mais curta.
formato: "markdown" devolve também uma versão em texto corrido das
regras, útil para colar num prompt. Default: só estruturado.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| formato | No | ||
| entidade_id | No | ||
| incluir_bloco_produtos | No |