ai-analysis-pipeline
Skill para evoluir fluxo de analise IA mantendo previsibilidade, custo controlado e fallback.
Inputs
provider:claude,openaiougroqmodel_policy: limites de tokens, temperatura e timeoutoutput_contract: chaves JSON obrigatorias de analisefailure_policy: estrategia de retry/fallback
Outputs
config/ai.phpsrc/Services/AiService.php- Atualizacoes opcionais em parser/prompt builder
Fontes do projeto
config/ai.phpsrc/Services/AiService.phpsrc/Services/AiPromptBuilder.phpsrc/Services/AiResultParser.php
Passo a passo
- Definir contrato de saida JSON (campos obrigatorios).
- Ajustar chamada por provider com timeout e tratamento de erro.
- Manter telemetria minima (
tokens,cost,processing_time_ms). - Garantir fallback para erro de provider.
- Validar compatibilidade com status do cliente (
pending/processing/completed/failed).
Criterios de aceite
- Erro de API nao quebra fluxo inteiro.
- Saida parseada segue contrato minimo esperado.
- Status da analise e do cliente mantem coerencia de estado.
Nao faz
- Nao adiciona novo provider sem chave de API configurada.
- Nao envia dados sensiveis para logs sem mascaramento.