📐 Passo 4: Normalizacao
Antes de enviar para a IA, os dados precisam ser normalizados - transformados em um formato padrao e consistente.
O que normalizar
- •Texto: Limpar, formatar, truncar se necessario
- •Datas: Converter para formato ISO
- •Estruturas: Aplainar ou organizar hierarquias
- •Tokens: Estimar e limitar tamanho do contexto
🎭 Passo 5: Injecao de persona e preferencias
Este e o passo de Governanca Cognitiva. A persona e preferencias sao injetadas para controlar como a IA deve pensar.
🧠 Componentes da Injecao
Persona
Define a identidade, tom, expertise e limitacoes da IA
Preferencias
Configuracoes do usuario: idioma, formato, nivel de detalhe
Restricoes
O que a IA NAO deve fazer: limites, proibicoes
Instrucoes
Como estruturar a resposta, formato de output
Exemplo de System Prompt com Injecao
system_prompt = f"""
[PERSONA]
{persona.description}
[PREFERENCIAS DO USUARIO]
- Idioma: {prefs.language}
- Nivel de detalhe: {prefs.detail_level}
- Formato: {prefs.output_format}
[RESTRICOES]
{persona.restrictions}
[INSTRUCOES]
{persona.output_instructions}
"""🤖 Passo 6: Chamada a IA (estrutura)
Finalmente, a chamada a IA acontece. Mas lembre-se da Two-Phase Rule: a IA gera estrutura, nao artefatos finais.
📋 O que a IA deve retornar
✓ Correto
- • JSON estruturado
- • Outlines e esqueletos
- • Dados organizados
- • Metadados da resposta
✗ Incorreto
- • Arquivos binarios
- • HTML/CSS renderizado
- • Imagens geradas
- • Documentos formatados
🔀 Preparacao para chamada LLM
A preparacao envolve montar o request completo para a API do LLM.
llm_request = {
"model": config.model_name,
"messages": [
{"role": "system", "content": system_prompt},
{"role": "user", "content": normalized_input}
],
"temperature": persona.temperature,
"max_tokens": config.max_tokens,
"response_format": {"type": "json_object"}
}💻 System prompts e contexto
O system prompt e a politica de governanca aplicada em tempo de execucao.
💡 Dica de Ouro
System prompts devem ser versionados e auditados. Mudancas no system prompt mudam o comportamento da IA - trate como codigo.
🧪 Exemplos de injecao
Persona: Critical Reviewer
Para analise critica de documentos:
Voce e um revisor critico e detalhista.
Analise o conteudo buscando: inconsistencias, erros
logicos, gaps de informacao.
SEMPRE aponte problemas, mesmo pequenos.
Formato: JSON com campos issue, severity, suggestion.Persona: Simple Explainer
Para explicacoes acessiveis:
Voce explica conceitos complexos de forma simples.
Use analogias do dia-a-dia.
Evite jargao tecnico.
Maximo 3 paragrafos por explicacao.
Formato: JSON com campos concept, explanation, analogy.