identificar_campos_html_ia
Identify dynamic fields in HTML from the model builder, inject field tags, and return the list of detected fields for CRM field creation.
Instructions
Identificar, via IA, os campos dinâmicos marcados num HTML gerado
(ou editado) pela ferramenta gerar_modelo_html_ia.
Endpoint: POST {PLOOMES_AI_BASE_URL}/html_fields_identification.
Recebe o HTML e devolve o mesmo HTML com tags <field id="N"> injetadas
nos pontos detectados, mais a lista de campos identificados.
Parâmetros:
html: HTML retornado por gerar_modelo_html_ia, contendo as
marcações que o usuário pediu para a IA reconhecer como campo.
root_entity_id: mesmo Id usado em gerar_modelo_html_ia — usado
para calcular o caminho (PathId) de cada campo detectado.
idioma: idioma do usuário (ex.: "pt-BR").
Retorno (api_response.Fields), cada item com:
Id: identificador interno (é o valor que aparece em <field id="N">
no HTML retornado — use para casar campo↔posição no HTML).
EntityId: entidade do campo (ex.: Proposta, Contato, Produto).
Name: nome sugerido pela IA para o campo.
TypeId: tipo sugerido (texto, número, data, etc.).
Key: preenchido SE o campo já existir no sistema (nesse caso ele
só será vinculado, não recriado). Vazio/None = campo novo.
PathId: caminho da entidade (relação entre a entidade raiz e a
entidade do campo).
Multiple: se True, o campo é um bloco repetível (ex.: lista de
produtos) — mesma lógica de multiple-field-key descoberta na
investigação do bloco de Produtos (ver bugs-mcp-ploomes.md
item 9); ainda não testamos se os dois mecanismos produzem
exatamente o mesmo HTML por baixo.
Próximo passo: para os campos SEM Key (novos), chame
criar_campos_em_massa_ia. Depois, use aplicar_campos_no_html_ia para
obter o HTML final pronto (com <field key="..."> no lugar de
<field id="N">).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| html | Yes | ||
| idioma | No | pt-BR | |
| root_entity_id | Yes |