FormFlow v4 - batchAnalyzeDialogue
Processa capturas em lote de forma síncrona e retorna resumo de custo agregado
Este endpoint executa captura em lote com retorno imediato do resultado e resumo de custo da chamada.
Endpoint
POST /api/v4/formFlow/batchAnalyzeDialogue
Parâmetros
UUID de conversa ou query SELECT que retorne coluna id.
UUID do catálogo FormFlow alvo da captura.
UUID do host para validação de escopo.
Instruções extras para a captura; se omitido usa as do catálogo.
Modelo principal da captura.
Modelo econômico para etapas auxiliares quando aplicável.
Provedor do modelo econômico.
Também são aceitos aliases como form_catalog_id e host_id.
Exemplo
curl -X POST "{{BASE_URL}}/api/v4/formFlow/batchAnalyzeDialogue" \
-H "Authorization: Bearer {{TOKEN}}" \
-H "Content-Type: application/json" \
-d '{
"input": "SELECT id FROM conversations WHERE host_id = '\''HOST_UUID'\'' LIMIT 5",
"formCatalogId": "CATALOG_UUID",
"hostId": "HOST_UUID"
}'
Resposta
{
"processedPairs": ["..."],
"missingForms": [],
"missingConversations": [],
"errors": [],
"timing": {
"elapsedMs": 0
},
"costSummary": {
"requestControlId": "uuid",
"totalInputTokens": 0,
"totalOutputTokens": 0,
"estimatedCostUsd": 0
}
}
Campos da Resposta
Pares conversa x formulário processados com sucesso.
IDs de catálogos não encontrados.
IDs de conversas não encontradas.
Erros de processamento por item ou por execução.
Erros
| Código | Descrição |
|---|---|
400 | input, formCatalogId ou hostId inválidos |
401 | Token inválido ou ausente |
500 | Erro interno durante captura ou apuração de custo |